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

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

分享
更新时间: 2019/11/05 GMT+08:00

功能介绍

查询详细的镜像信息列表。

接口约束

URI

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

参数说明请参见 表1
表1 路径参数

参数

是否必选

描述

project_id

项目ID。

获取方法请参见获取项目ID

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

可以将如下作为URI参数,过滤查询结果。使用方式:/v2/{project_id}/images/detail? 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

Int

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

minDisk

Int

镜像要求的最小磁盘大小,单位GB。

表3 nova和glance中的镜像状态映射关系

glance中的镜像状态

nova显示的镜像状态

queued

saving

saving

saving

active

active

deleted

deleted

请求消息

响应消息

响应参数如表4所示。

表4 响应参数

参数

参数类型

描述

id

String

镜像ID,UUID格式。

links

List(Dict)

镜像相关快捷链接地址

name

String

镜像名称

metadata

Dict

metadata键值对

OS-EXT-IMG-SIZE:size

Int

镜像大小。

大于0。

minDisk

Int

镜像要求的最小磁盘大小。

大于0。

minRam

Int

镜像要求的最小内存大小。

大于0。

progress

Int

镜像上传百分比。

大于0。

status

String

镜像状态

created

String

镜像创建时间。

ISO8601时间格式,例如:2013-06-09T06:42:18Z

updated

String

镜像更新时间。

ISO8601时间格式,例如:2013-06-09T06:42:18Z

表5 links参数信息

参数

是否必选

参数类型

描述

href

String

相应资源的链接。

rel

String

有三种取值。self:自助链接包含版本链接的资源。立即链接后使用这些链接。bookmark:书签链接提供了一个永久资源的永久链接,该链接适合于长期存储。alternate:备用链接可以包含资源的替换表示形式。例如,OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。

type

String

type属性提供了一个提示,用于在跟踪该链接时期望的表示类型。

请求示例

GET /v2/9c53a566cb3443ab910cf0daebca90c4/images/detail
GET /v2.1/9c53a566cb3443ab910cf0daebca90c4/images/detail

响应示例

{
    "image": {
        "OS-EXT-IMG-SIZE:size": 20578304,
        "created": "2014-02-10T17:05:01Z",
        "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"
            }
        ],
        "metadata": {
            "clean_attempts": "3",
            "image_location": "snapshot",
            "image_state": "available",
            "image_type": "snapshot",
            "instance_type_ephemeral_gb": "0",
            "instance_type_flavorid": "6",
            "instance_type_id": "7",
            "instance_type_memory_mb": "256",
            "instance_type_name": "wj.ssd",
            "instance_type_root_gb": "2",
            "instance_type_rxtx_factor": "1.0",
            "instance_type_swap": "0",
            "instance_type_vcpus": "1",
            "instance_uuid": "b600b5b1-ed8c-4814-aefa-8b903c894c20",
            "os_type": "None",
            "owner_id": "d9ebe43510414ef590a4aa158605329e",
            "user_id": "74fe4ff0674b434b8a274077d8106c5b"
        },
        "minDisk": 2,
        "minRam": 0,
        "name": "image1",
        "progress": 100,
        "server": {
            "id": "b600b5b1-ed8c-4814-aefa-8b903c894c20",
            "links": [
                {
                    "href": "http://172.25.150.84:8774/v2/d9ebe43510414ef590a4aa158605329e/servers/b600b5b1-ed8c-4814-aefa-8b903c894c20",
                    "rel": "self"
                },
                {
                    "href": "http://172.25.150.84:8774/d9ebe43510414ef590a4aa158605329e/servers/b600b5b1-ed8c-4814-aefa-8b903c894c20",
                    "rel": "bookmark"
                }
            ]
        },
        "status": "ACTIVE",
        "updated": "2014-02-10T17:05:07Z"
    }
}

返回值

请参考通用请求返回值

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区