更新时间：2025-08-15 GMT+08:00

查询镜像列表（废弃）

功能介绍

查询所有镜像的列表信息。

当前API已废弃，请使用"查询镜像列表"。

URI

GET /v2.1/{project_id}/images?name={name}&status={status}&changes-since={changes-since}&minRam={minRam}&minDisk={inDisk}

参数说明请参见表1。

表1 路径参数
参数	是否必选	描述
project_id	是	项目ID。获取方法请参见获取项目ID。

支持分页查询。分页查询的相关信息，请参见分页查询。

可以将如下作为URI参数，过滤查询结果。使用方式：/v2/{project_id}/images? name ={name}&status={status}

查询参数如表2所示。

表2 查询参数
参数	是否必选	参数类型	描述
name	否	String	镜像名称。
status	否	String	镜像状态。不支持使用“deleted”状态过滤查询，且指定的状态必须是镜像在glance中的状态。nova和glance中的镜像状态映射关系如表3所示。
changes-since	否	String	过滤在changes-since时间之后更新过的镜像。ISO8601时间格式，例如：2013-06-09T06:42:18Z。
minRam	否	Integer	镜像要求的最小内存大小，单位MiB。
minDisk	否	Integer	镜像要求的最小磁盘大小，单位GiB。

表3 nova和glance中的镜像状态映射关系
glance中的镜像状态	nova显示的镜像状态
queued	saving
saving	saving
active	active
deleted	deleted

请求消息

无

响应消息

响应参数如表4所示。

表4 响应参数
参数	是否必选	参数类型	描述
images	是	Array of objects	镜像信息
images_links	否	Array of objects	分页查询时下一页的信息

表5 images参数信息
参数	是否必选	参数类型	描述
id	是	String	镜像ID，UUID格式。
links	是	Array of objects	镜像相关快捷链接地址
name	是	String	镜像名称

表6 images_links参数信息
参数	是否必选	参数类型	描述
href	是	String	分页查询下一页URL
rel	是	String	分页查询方向

表7 links参数信息
参数	是否必选	参数类型	描述
href	是	String	相应资源的链接。
rel	是	String	有三种取值。self：自助链接包含版本链接的资源。立即链接后使用这些链接。bookmark：书签链接提供了一个永久资源的永久链接，该链接适合于长期存储。alternate：备用链接可以包含资源的替换表示形式。例如，OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。
type	否	String	type属性提供了一个提示，用于在跟踪该链接时期望的表示类型。

请求示例

GET https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/images

响应示例

{
    "images": [
        {
            "id": "ee10f19c-503c-44af-af2f-73d5e42f7a17",
            "links": [
                {
                    "href": "http://xxx/v2/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "self"
                },
                {
                    "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "bookmark"
                },
                {
                    "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "alternate",
                    "type": "application/vnd.openstack.image"
                }
            ],
            "name": "image1"
        }
    ]
}

返回值

请参考通用请求返回值。

父主题： 镜像管理（OpenStack Nova API）