更新时间:2024-04-16 GMT+08:00

查询镜像列表(废弃)

功能介绍

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

当前API已废弃,请使用镜像服务接口“查询镜像列表(OpenStack原生)”。

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"
        }
    ]
}

返回值

请参考通用请求返回值