更新时间:2022-08-16 GMT+08:00

查询指定镜像详情(废弃)

功能介绍

查询指定的镜像的详情信息。

当前API已废弃,请使用镜像服务接口"查询镜像详情(OpenStack原生)"。

URI

GET /v2.1/{project_id}/images/{image_id}

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

参数

是否必选

描述

project_id

项目ID。

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

image_id

镜像ID。

请求消息

响应消息

响应参数请参见表2

表2 响应参数

参数

参数类型

描述

id

String

镜像ID,UUID格式。

links

Array of objects

镜像相关快捷链接地址

name

String

镜像名称

metadata

Object

metadata键值对

OS-EXT-IMG-SIZE:size

Integer

镜像大小。大于0。

minDisk

Integer

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

minRam

Integer

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

progress

Integer

镜像上传百分比。大于0。

status

String

镜像状态

created

String

镜像创建时间。ISO8601时间格式,例如:2013-06-09T06:42:18Z

updated

String

镜像更新时间。ISO8601时间格式,例如:2013-06-09T06:42:18Z

表3 links参数信息

参数

是否必选

参数类型

描述

href

String

相应资源的链接。

rel

String

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

type

String

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

请求示例

GET https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/images/17a1890b-0fa4-485e-8505-14e294017988

响应示例

{
    "image": {
        "status": "ACTIVE", 
        "updated": "2015-12-27T02:52:25Z", 
        "name": "cirror", 
        "links": [
            {
                "href": "https://compute.localdomain.com:8001/v2/719e9483f42d4784a089862ac4c3e8d0/images/17a1890b-0fa4-485e-8505-14e294017988", 
                "rel": "self"
            }, 
            {
                "href": "https://compute.localdomain.com:8001/719e9483f42d4784a089862ac4c3e8d0/images/17a1890b-0fa4-485e-8505-14e294017988", 
                "rel": "bookmark"
            }, 
            {
                "href": "https://https://image.az2.dc1.domainname.com:443/719e9483f42d4784a089862ac4c3e8d0/images/17a1890b-0fa4-485e-8505-14e294017988", 
                "type": "application/vnd.openstack.image", 
                "rel": "alternate"
            }
        ], 
        "created": "2015-12-27T02:52:24Z", 
        "minDisk": 0, 
        "progress": 100, 
        "minRam": 0, 
        "metadata": {
            "__os_version": "CentOS 4.4 32bit", 
            "file_format": "img", 
            "file_name": "**.img", 
            "describe": "", 
            "__os_type": "Linux", 
            "virtual_env_type": "KVM", 
            "hw_disk_bus": "scsi"
        }, 
        "id": "17a1890b-0fa4-485e-8505-14e294017988", 
        "OS-EXT-IMG-SIZE:size": 13167616
    }
}

返回值

请参考通用请求返回值