查询镜像详情 - ShowImage

功能介绍

查询镜像详情。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v1/images/{image_id}

表1 路径参数
参数	是否必选	参数类型	描述
image_id	是	String	镜像ID。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
id	String	镜像ID。
name	String	镜像名称。
status	String	镜像状态。取值如下： queued：表示镜像元数据已经创建成功，等待上传镜像文件。 saving：表示镜像正在上传文件到后端存储。 deleted：表示镜像已经删除。 killed：表示镜像上传错误。 active：表示镜像可以正常使用
disk_format	String	镜像格式。
min_disk	Integer	最小系统盘（单位：GB），取值为40～1024GB。
min_ram	Integer	最小内存（单位：MB），默认值为0。
owner	String	镜像所属租户ID。
protected	Boolean	是否受保护。
visibility	String	可见性。
created_at	String	创建时间。
updated_at	String	更新时间。
self	String	镜像链接信息。
deleted	Boolean	是否是删除的镜像，取值为true或者false。
virtual_env_type	String	镜像使用环境类型。目前仅支持系统盘镜像，取值为：FusionCompute
deleted_at	String	删除时间，格式为UTC时间。
relation_job_id	String	镜像关联的任务ID。
__imagetype	String	镜像类型。取值范围： gold：公有镜像； private：私有镜像。
__platform	String	镜像平台分类。
__os_type	String
__os_version	String	镜像的操作系统具体版本。
__isregistered	Boolean	是否是注册过的镜像。
__support_kvm	String	如果镜像支持KVM，取值为true，否则无该属性。
__support_kvm_gpu_type	String	如果镜像是支持KVM虚拟化平台下的GPU类型，取值为“V100_vGPU”或者“RTX5000”，否则无该属性。
__support_kvm_ascend_310	String	如果镜像支持AI加速，取值为true，否则无该属性。
__support_kvm_hi1822_hiovs	String	如果镜像支持计算增强，取值为true，否则无该属性。
__support_arm	String	如果镜像为ARM架构类型，取值为true，否则无该属性。
hw_firmware_type	String	镜像启动模式，取值为uefi或bios，不指定时无该属性。
data_source	String	镜像来源。来源边缘实例：instance:<实例id> 来源IMS：ims:<镜像id>:[/topic/body/section/table/tgroup/tbody/row/entry/ul/li/p/br {""}) (br]
__support_gpu_t4	String	如果镜像支持GPU T4类型，取值为true，否则无该属性。
origin_region_info	CloudImageRegionInfo object	原始区域详情。
edge_region_info	Array of EdgeImageRegionInfo objects	边缘区域详情。
__support_amd	String	是否是AMD架构类型的镜像。取值为true或者false。

表4 CloudImageRegionInfo
参数	参数类型	描述
region_id	String	区域ID
image_id	String	镜像ID

表5 EdgeImageRegionInfo
参数	参数类型	描述
region_id	String	区域ID
image_id	String	镜像ID

请求示例

GET https://{endpoint}/v1/images/633724a7-4a4e-11eb-8f73-fa1640aee23e

响应示例

状态码：200

{
  "id" : "633724a7-4a4e-11eb-8f73-fa1640aee23e",
  "name" : "ces",
  "status" : "active",
  "disk_format" : "zvhd2",
  "min_disk" : 40,
  "min_ram" : 0,
  "owner" : "2b76febbe5d34eac85d26435c1f15809",
  "protected" : false,
  "visibility" : "private",
  "created_at" : "2020-12-30T03:23:29Z",
  "updated_at" : "2020-12-30T03:30:36Z",
  "self" : "/v1/self/633724a7-4a4e-11eb-8f73-fa1640aee23e",
  "deleted" : false,
  "virtual_env_type" : "FusionCompute",
  "deleted_at" : "",
  "__imagetype" : "private",
  "__platform" : "CentOS",
  "__os_type" : "Linux",
  "__os_version" : "CentOS 7.4 64bit",
  "__isregistered" : true,
  "__support_arm" : "true",
  "hw_firmware_type" : "uefi",
  "data_source" : "instance:a7c6deda-99eb-4f58-b7b4-04a36b75401b",
  "__support_gpu_t4" : "true",
  "origin_region_info" : {
    "region_id" : "edgecloud1",
    "image_id" : "ea882319-3c1f-4296-9488-8c2e3a5c3056"
  },
  "edge_region_info" : [ {
    "region_id" : "region.edgecloud",
    "image_id" : "8c056af4-738e-46c0-8474-6c4758fe038d"
  } ]
}