查询自定义镜像详情
1. 接口描述
调用 DescribeImage 接口查询一个您的自定义镜像。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：DescribeImage |
| RegionCode | String | 是 | 镜像所属的地域编码，您可以调用 DescribeRegionConfig 查看最新的地域列表 |
| ZoneCode | String | 是 | 镜像所属的可用区编码，您可以调用 DescribeZoneConfig 查看可用区列表 |
| ImageUUID | String | 是 | 镜像ID |
3. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| ImageInfo | ImageInfo | 镜像信息 |
| RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?AccessKeyId=sz0000ei53aw
&Action=DescribeImage
&Format=JSON
&RegionCode=cn-fuzhou-5
&ZoneCode=cn-fuzhou-5-a
&ImageUUID=img-ImageUUID
&SignatureMethod=HMAC-SHA1
&SignatureNonce=76a5d5e7-0992-462d-9a26-916650eca00f
&SignatureVersion=1.0
&Timestamp=2023-03-09T07%3A33%3A56Z
&Version=2014-05-26
&Signature=LH5UYKO7k%2FeQlyLH3p169uyRKyU%3D
正常返回示例
{
"ImageInfo": {
"ImageUUID":"img-le000009o9f5",
"OsVersion":"SYSTEM",
"ImageSize":50,
"ImageType":"windows",
"ImageName":"xxxx",
"ImagePendingStatus":"NONE",
"ImageStatus":"AVAILABLE",
"CreationTime":"2019-10-30 11:32:41"
},
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | RegionCode 参数不能为空 |
| MissingParameter | ZoneCode 参数不能为空 |
| AvailableRegionNotFound | 可用的地域未找到 |
| AvailableZoneNotFound | 可用的区域未找到 |
| AvailableImageNotFound | 可用镜像未找到 |
| InvalidImageStatus.CreateFailed | 非法镜像状态—创建失败 |
| InvalidImageStatus.HasDeleted | 非法镜像状态—已经被删除 |
| DescribeImageFail | 查询镜像详情失败:xxx |