查询镜像详情（OpenStack原生）
功能介绍
查询单个镜像详情，用户可以通过该接口查询单个私有或者公共镜像的详情。
请求消息
请求参数
无
请求示例
查询镜像详情。
GET https://{Endpoint}/v2/images/33ad552d-1149-471c-8190-ff6776174a00
响应消息
- 响应参数
参数
参数类型
描述
file
String
镜像文件下载和上传链接。
owner
String
镜像属于哪个租户。
id
String
镜像ID。
size
Long
目前暂时不使用。
self
String
镜像链接信息。
schema
String
镜像视图。
status
String
镜像状态。取值如下：
- queued：表示镜像元数据已经创建成功，等待上传镜像文件。
- saving：表示镜像正在上传文件到后端存储。
- deleted：表示镜像已经删除。
- killed：表示镜像上传错误。
- active：表示镜像可以正常使用。
tags
Array of strings
镜像标签列表，提供用户可以自定义管理私有镜像的能力。用户可以通过镜像标签接口为每个镜像增加不同的标签，在查询接口中可以根据标签进行过滤。
visibility
String
是否被其他租户可见，取值如下：
- private：私有镜像
- public：公共镜像
- shared：共享镜像
name
String
镜像名称。name参数说明请参考镜像属性。
checksum
String
目前暂时不使用。
protected
Boolean
是否是受保护的，受保护的镜像不允许删除。取值为true或false。
container_format
String
容器类型。
min_ram
Integer
镜像运行最小内存，单位为MB。取值参考云服务器规格限制，一般设置为0。
max_ram
String
镜像支持的最大内存，单位为MB。取值可以参考云服务器规格限制，一般不设置。
updated_at
String
更新时间。格式为UTC时间。
__os_bit
String
操作系统位数，一般取值为“32”或者“64”。
__os_version
String
操作系统具体版本。
__description
String
镜像描述信息。_description参数说明请参考镜像属性。
disk_format
String
镜像格式，目前支持zvhd2、vhd、zvhd、raw、qcow2、iso。非iso格式时默认值是zvhd2。
__isregistered
String
是否是注册过的镜像，取值为“true”或者“false”。
__platform
String
镜像平台分类，取值为Windows、Ubuntu、Red Hat、SUSE、CentOS、Debian、OpenSUSE、Oracle Linux、Fedora、Other、CoreOS和EulerOS。
__os_type
String
操作系统类型，目前取值Linux、Windows、Other。
__system__cmkid
String
加密镜像所使用的密钥ID。
min_disk
Integer
镜像运行需要的最小磁盘容量，单位为GB 。取值为40～255GB。
virtual_env_type
String
镜像使用环境类型：FusionCompute、Ironic、DataImage、IsoImage。
- 如果是云服务器镜像（即系统盘镜像），则取值为FusionCompute。
- 如果是数据盘镜像，则取值为DataImage。
- 如果是裸金属服务器镜像，则取值为Ironic。
- 如果是ISO镜像，则取值是IsoImage。
__image_source_type
String
镜像后端存储类型，目前只支持uds。
__imagetype
String
镜像类型，目前支持以下类型：
- 公共镜像：gold
- 私有镜像：private
- 共享镜像：shared
created_at
String
创建时间。格式为UTC时间。
virtual_size
Integer
目前暂时不使用。
__originalimagename
String
父镜像ID。
公共镜像或通过文件创建的私有镜像，取值为空。
__backup_id
String
备份ID。如果是备份创建的镜像，则填写为备份的ID，否则为空。
__image_size
String
镜像文件的大小，单位为字节。目前取值为大于0的字符串。
__data_origin
String
镜像来源。
公共镜像为空。
__root_origin
String
表示当前镜像来源是从外部导入。取值：file。
__lazyloading
String
镜像是否支持延迟加载。取值为true、false、True或False。
active_at
String
镜像状态变为正常的时间。
__os_feature_list
String
镜像附加属性。该属性采用JSON格式来标识镜像支持的高级特性清单。
__sequence_num
String
目前暂时不用
__support_kvm
String
如果镜像支持KVM，取值为true，否则无需增加该属性。
__support_xen
String
如果镜像支持XEN，取值为true，否则无需增加该属性。
__support_largememory
String
表示该镜像支持超大内存。如果镜像支持超大内存，取值为true，否则无需增加该属性。
镜像操作系统类型请参考表4。
__support_diskintensive
String
表示该镜像支持密集存储。如果镜像支持密集存储性能，则值为true，否则无需增加该属性。
__support_highperformance
String
表示该镜像支持高计算性能。如果镜像支持高计算性能，则值为true，否则无需增加该属性。
__support_xen_gpu_type
String
表示该镜像是支持XEN虚拟化平台下的GPU优化类型，取值参考表2。如果不支持XEN虚拟化下GPU类型，无需添加该属性。该属性与“__support_xen”和“__support_kvm”属性不共存。
__support_kvm_gpu_type
String
表示该镜像是支持KVM虚拟化平台下的GPU类型，取值参考表3。
如果不支持KVM虚拟化下GPU类型，无需添加该属性。该属性与“__support_xen”和“__support_kvm”属性不共存。
__support_xen_hana
String
如果镜像支持XEN虚拟化下HANA类型，取值为true。否则，无需添加该属性。
该属性与“__support_xen”和“__support_kvm”属性不共存。
__support_kvm_infiniband
String
如果镜像支持KVM虚拟化下Infiniband网卡类型，取值为true。否则，无需添加该属性。
该属性与“__support_xen”属性不共存。
__support_fc_inject
String
表示当前镜像支持Cloud-Init密码/密钥注入方式，取值为“true”或者“false”。
如果取值为“true”，表示该镜像不支持Cloud-Init注入密码/密钥，其他取值时表示支持Cloud-Init注入密钥/密码。
说明：该特性参数只对ECS系统盘镜像生效，其他类型镜像不生效。
hw_firmware_type
String
云服务器的启动方式。目前支持：
- bios：表示bios引导启动。
- uefi：表示uefi引导启动。
hw_vif_multiqueue_enabled
String
镜像是否支持网卡多队列。取值为“true”或者“false”。
__image_location
String
镜像的存储位置。
__is_config_init
String
是否完成了初始化配置。取值为“true”或者“false”。
__support_amd
String
是否是AMD架构类型的镜像。取值为“true”或者“false”。
- 响应样例
STATUS CODE 200
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
{ "schema": "/v2/schemas/image", "min_disk": 100, "created_at": "2018-09-06T14:03:27Z", "__image_source_type": "uds", "container_format": "bare", "file": "/v2/images/bc6bed6e-ba3a-4447-afcc-449174a3eb52/file", "updated_at": "2018-09-06T15:17:33Z", "protected": true, "checksum": "d41d8cd98f00b204e9800998ecf8427e", "id": "bc6bed6e-ba3a-4447-afcc-449174a3eb52", "__isregistered": "true", "min_ram": 2048, "__lazyloading": "true", "owner": "1bed856811654c1cb661a6ca845ebc77", "__os_type": "Linux", "__imagetype": "gold", "visibility": "public", "virtual_env_type": "FusionCompute", "tags": [], "__platform": "CentOS", "size": 0, "__os_bit": "64", "__os_version": "CentOS 7.3 64bit", "name": "CentOS 7.3 64bit vivado", "self": "/v2/images/bc6bed6e-ba3a-4447-afcc-449174a3eb52", "disk_format": "zvhd2", "virtual_size": null, "status": "active" }
