更新时间:2024-01-02 GMT+08:00
分享

查询镜像详情

功能介绍

查询镜像详情。

调试

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

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

镜像状态。

disk_format

String

镜像格式。

min_disk

Integer

最小系统盘(单位:GB),取值为40~1024GB。

最小值:40

最大值:1024

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

镜像使用环境类型。

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

最小长度:0

最大长度:36

image_id

String

镜像ID

最小长度:0

最大长度:36

表5 EdgeImageRegionInfo

参数

参数类型

描述

region_id

String

区域ID

image_id

String

镜像ID

请求示例

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

响应示例

状态码: 200

OK

{
  "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"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

分享:

    相关文档

    相关产品