查询磁盘详情
1. 接口描述
调用 DescribeDisk 接口查询一块磁盘的详细信息。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：DescribeDisk |
| DiskUUID | String | 是 | 磁盘ID |
3. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| DiskInfo | DiskInfo | 磁盘信息 |
| RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?SignatureVersion=1.0
&Action=DescribeDisk
&Format=JSON
&DiskUUID=disk-vx0000k0g9jw
&SignatureNonce=fad368fd-b5e3-476b-903b-2ef34e0e9fba
&Version=2014-05-26
&AccessKeyId=hfWkfqG6a794
&Signature=IcyHYfUBWSzJauAbDaqniNSNE94=
&SignatureMethod=HMAC-SHA1
&Timestamp=2023-02-25T15:29:21Z
正常返回示例
{
"DiskInfo": {
"DiskUUID":"disk-vx0000k0g9jw",
"RegionCode":"xxxxxx",
"ZoneCode":"xxxxxx",
"Type":"SYSTEM",
"DiskName":"xxxx",
"Category":"CLOUD",
"Size":50,
"AutoRenew" : "INFINITE",
"InstanceUUID":"ecs-vx0000k0g9ja",
"Device":"xxxx",
"DiskPendingStatus":"NONE",
"DiskStatus":"AVAILABLE",
"CreationTime":"2019-10-30 11:32:41",
"ExpirationTime":"2019-11-30 11:32:41"
},
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| AvailableRegionNotFound | 可用的地域未找到 |
| AvailableZoneNotFound | 可用的可用区未找到 |
| AvailableDiskNotFound | 可用磁盘未找到 |
| InvalidDiskStatus.CreateFailed | 非法磁盘状态—创建失败 |
| InvalidDiskStatus.HasDeleted | 非法磁盘状态—已经被删除 |
| DescribeDiskFail | 查询磁盘详情失败:xxx |