查询自定义镜像详情

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
kaopuyun all right reserved,powered by GitbookUpdated Time: 2024-10-09 06:22:14

results matching ""

    No results matching ""