# 查询镜像详情 - ShowImage
#### 功能介绍
查询镜像详情。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IEC/doc?api=ShowImage)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-iec/iec_05_0600.html)。
#### 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。                                                                                                                                                                                                                                                                                                                                                                                    |
   
 表4CloudImageRegionInfo 
| 参数        | 参数类型   | 描述   |
|:---|:---|:---|
| region_id | String | 区域ID |
| image_id  | String | 镜像ID |
   
 表5EdgeImageRegionInfo 
| 参数        | 参数类型   | 描述   |
|:---|:---|:---|
| 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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iec/ErrorCode.html)。