文档首页/ 弹性云服务器 ECS/ API参考/ 历史API/ 镜像管理（OpenStack Nova API）/ 查询镜像列表（废弃）
更新时间：2024-11-14 GMT+08:00
查看PDF
分享

查询镜像列表（废弃）

功能介绍

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

当前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

镜像要求的最小内存大小，单位MB。

minDisk

否

Integer

镜像要求的最小磁盘大小，单位GB。
表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"
        }
    ]
}

返回值

请参考通用请求返回值。

相关文档