查询磁盘
描述
下面的参数中,RegionId,ZoneId,DiskIds,InstanceId,… 等参数都是过滤器的概念,参数间是逻辑与关系。其中 DiskIds 是一个 Json 格式的 Json Array,格式如下。
如果参数为空,则过滤器不起作用,但是 DiskIds 如果是一个空 Json Array(即[]),则视为该过滤器有效,且返回空。
请求参数
一个带有格式的 Json Array:[“d-xxxxxxxxx”, ”d-yyyyyyyyy”, … “d-zzzzzzzzz”],最多 100 个 Id,用半角逗号字符隔开。 InstanceId String 否 实例 ID DiskType String 否 all | system | data,默认值为 all。 Category String 否 磁盘种类
all | cloud | cloud_efficiency | cloud_ssd | ephemeral | ephemeral_ssd。默认值为all Status String 否 磁盘状态
In_use | Available | Attaching | Detaching | Creating | ReIniting | All,默认值为 All。 SnapshotId String 否 创建磁盘使用的快照 DiskName String 否 磁盘名称 Portable String 否 磁盘是否支持卸载:
本地磁盘,本地SSD盘 和 普通云盘,高效云盘和SSD云盘的系统盘 和 包月的普通云盘,高效云盘,SSD云盘,该属性都为 false。
这个属性用户不能更改。 DeleteWithInstance String 否 磁盘是否随实例释放:
不允许为空字符串。 Tag.n.Value String 否 标签 value,n 从 1 开始,最大为 5。
允许为空字符串。 PageNumber Integer 否 磁盘状态列表的页码,起始值为 1,默认值为 1 PageSize Integer 否 分页查询时设置的每页行数,最大值 100 行,默认为 10
返回参数
错误码
示例
请求示例
https://ecs.aliyuncs.com/?action=DescribeDisks
&RegionId=cn-qingdao
&PageNumber=1
&ZoneId=cn-qingdao-b
&<公共请求参数>
返回示例
XML格式:
true
false
false
cloud
5
data
2014-07-23T02:44:07Z
cn-qingdao-b
2014-07-23T07:47:35Z
2014-07-23T08:28:48Z
true
cn-qingdao
d-28m5zbua0
Available
true
false
false
cloud
5
data
2014-07-23T02:44:06Z
cn-qingdao-b
true
cn-qingdao
d-28zfrmo13
Available
1
2
9
ED5CF6DD-71CA-462C-9C94-A61A78A01479
JSON格式:
{
"Disks": {
"Disk": [
{
"AttachedTime": "2014-07-23T07:47:35Z",
"Category": "cloud",
"CreationTime": "2014-07-23T02:44:07Z",
"DeleteAutoSnapshot": true,
"DeleteWithInstance": false,
"EnableAutoSnapshot": false
"Description": "",
"DetachedTime": "2014-07-23T08:28:48Z",
"Device": "",
"DiskId": "d-28m5zbua0",
"DiskName": "",
"ImageId": "",
"InstanceId": "",
"OperationLocks": {
"OperationLock": []
},
"Portable": true,
"ProductCode": "",
"RegionId": "cn-qingdao",
"Size": 5,
"SourceSnapshotId": "",
"Status": "Available",
"Type": "data",
"ZoneId": "cn-qingdao-b"
},
{
"AttachedTime": "",
"Category": "cloud",
"CreationTime": "2014-07-23T02:44:06Z",
"DeleteAutoSnapshot": true,
"DeleteWithInstance": false,
"EnableAutoSnapshot": false
"Description": "",
"DetachedTime": "",
"Device": "",
"DiskId": "d-28zfrmo13",
"DiskName": "",
"ImageId": "",
"InstanceId": "",
"OperationLocks": {
"OperationLock": []
},
"Portable": true,
"ProductCode": "",
"RegionId": "cn-qingdao",
"Size": 5,
"SourceSnapshotId": "",
"Status": "Available",
"Type": "data",
"ZoneId": "cn-qingdao-b"
}
]
},
"PageNumber": 1,
"PageSize": 2,
"RequestId": "ACD9BBB0-A9D1-46D7-9630-B7A69889E110",
"TotalCount": 9
}