文档首页 > > API参考> OpenStack Nova API> 镜像管理> 查询镜像列表(废弃,不推荐使用)

查询镜像列表(废弃,不推荐使用)

分享
更新时间: 2019/12/10 GMT+08:00

功能介绍

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

接口约束

URI

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

参数说明请参见 表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://172.25.150.84:8774/v2/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "self"
                },
                {
                    "href": "http://172.25.150.84:8774/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "bookmark"
                },
                {
                    "href": "http://172.25.150.84:9292/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17",
                    "rel": "alternate",
                    "type": "application/vnd.openstack.image"
                }
            ],
            "name": "image1"
        }
    ]
}

返回值

请参考通用请求返回值

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区