如何高效查询OpenStack原生Glance镜像服务API的镜像列表？

2025年11月6日 19:47 • 云服务器知识 • 阅读 348

OpenStack原生中的镜像服务API：Glance ListImages

在OpenStack原生环境中,镜像服务（Glance）是负责管理镜像的重要组件，它提供了一个统一的镜像存储、检索和查询接口，本文将详细介绍如何使用Glance的ListImages API来查询镜像列表。

ListImages API简介

ListImages API是Glance提供的查询镜像列表的接口，通过该接口可以获取到OpenStack环境中所有镜像的信息，该API支持多种查询参数，如镜像名称、镜像状态、镜像类型等。

ListImages API请求示例

以下是一个使用curl命令调用ListImages API的示例：

curl -X GET http://<glance-server>:9292/v2/images -H "X-Auth-Token: <auth-token>"

<glance-server>为Glance服务的IP地址或域名，<auth-token>为认证令牌。

ListImages API响应示例

以下是ListImages API的响应示例：

{
  "images": [
    {
      "id": "c1b5f9a5-0a5b-4f5a-9b1c-9c3b8e8e6c4b",
      "name": "centos-7",
      "status": "active",
      "container_format": "bare",
      "disk_format": "qcow2",
      "size": 718515872,
      "min_disk": 1,
      "min_ram": 512,
      "is_public": true,
      "created_at": "2021-08-01T06:06:42",
      "updated_at": "2021-08-01T06:06:42",
      "properties": {
        "architecture": "x86_64",
        "os_type": "Linux",
        "os_distro": "CentOS 7"
      }
    },
    {
      "id": "d1b5f9a5-0a5b-4f5a-9b1c-9c3b8e8e6c4c",
      "name": "ubuntu-18.04",
      "status": "active",
      "container_format": "bare",
      "disk_format": "qcow2",
      "size": 817742144,
      "min_disk": 1,
      "min_ram": 512,
      "is_public": true,
      "created_at": "2021-08-01T06:07:42",
      "updated_at": "2021-08-01T06:07:42",
      "properties": {
        "architecture": "x86_64",
        "os_type": "Linux",
        "os_distro": "Ubuntu 18.04"
      }
    }
  ]
}

ListImages API参数说明

以下是对ListImages API中常用参数的说明：

参数名	说明
name	镜像名称，支持模糊查询
status	镜像状态，如active、deleted等
container_format	容器格式，如bare、ovf、ova等
disk_format	磁盘格式，如qcow2、vhd、raw等
min_disk	最小磁盘空间（GB）
min_ram	最小内存空间（MB）
is_public	是否为公开镜像
created_at	镜像创建时间
updated_at	镜像更新时间

FAQs

问题：如何获取所有公开镜像的信息？

解答：在ListImages API请求中，设置参数is_public=true即可获取所有公开镜像的信息。
问题：如何获取特定名称的镜像信息？

解答：在ListImages API请求中，设置参数name=镜像名称即可获取指定名称的镜像信息，如果需要支持模糊查询，可以使用通配符。