调用DescribeDisks查询一块或多块您已经创建的云盘以及本地盘。

接口说明

  • 请求参数RegionId、ZoneId、DiskIds和InstanceId等都是过滤器的概念,参数间是逻辑与(AND)关系。
  • 请求参数DiskIds是一个JSON格式的数组(Array),如果参数为空,则过滤器不起作用,但是DiskIds如果是一个空数组,则视为该过滤器有效,且返回空。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-hangzhou

云盘所属于的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

Action String DescribeDisks

系统规定参数。对于您自行拼凑HTTP/HTTPS URL发起的API请求,Action为必选参数。取值:DescribeDisks

AdditionalAttributes.N RepeatList null

其他属性值。

说明 该参数即将被弃用,为提高兼容性,请尽量使用其他参数。
AutoSnapshotPolicyId String auto_20140724_2

根据自动快照策略ID查询云盘。

Category String all

云盘种类。取值范围:

  • all:所有云盘以及本地盘
  • cloud:普通云盘
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD盘
  • cloud_essd:ESSD云盘
  • local_ssd_pro:I/O密集型本地盘
  • local_hdd_pro:吞吐密集型本地盘
  • ephemeral:(已停售)本地盘
  • ephemeral_ssd:(已停售)本地SSD盘

默认值:all

DeleteAutoSnapshot Boolean false

删除云盘时,是否同时删除自动快照。取值范围:

  • true:同时删除自动快照
  • false:保留自动快照

默认值:false

DeleteWithInstance Boolean false

云盘是否随实例释放。取值范围:

  • true:实例释放时,这块云盘随实例一起释放
  • false:实例释放时,这块云盘保留不释放

默认值:false

DiskChargeType String PostPaid

云盘或本地盘的计费方式。取值范围:

  • PrePaid:包年包月
  • PostPaid:按量付费
DiskIds String ["d-xxxxxxxxx", "d-yyyyyyyyy", … "d-zzzzzzzzz"]

云盘ID。一个带有格式的JSON数组,最多100个ID,用半角逗号(,)隔开。

DiskName String JoshuaFinance

云盘或本地盘名称。

DiskType String all

要查询的云盘或本地盘类型。取值范围:

  • all:同时查询系统盘与数据盘
  • system:只查询系统盘
  • data:只查询数据盘

默认值:all

DryRun Boolean false

是否只预检此次请求。

  • true:发送检查请求,不会查询资源状况。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码DryRunOperation
  • false:发送正常请求,通过检查后返回2XX HTTP状态码并直接查询资源状况。

默认值:false

EnableAutoSnapshot Boolean false

云盘是否执行自动快照策略(前提是用户整体的自动快照策略已经开启)。取值范围:

  • true:表示这块云盘执行自动快照策略
  • false:表示这块云盘不执行自动快照策略

默认值:false

EnableAutomatedSnapshotPolicy Boolean false

云盘是否设置了自动快照策略。

EnableShared Boolean false

是否是共享块存储。

Encrypted Boolean false

是否过滤加密云盘。取值范围:

  • true:只筛选出加密云盘
  • false:不做加密属性的筛选

默认值:false

Filter.1.Key String CreationStartTime

查询资源时的筛选键。取值必须为CreationStartTime。

Filter.1.Value String 2017-12-05T22:40:00Z

查询资源时的筛选值。取值必须为资源创建的开始时间点(CreationStartTime)。

Filter.2.Key String CreationEndTime

查询资源时的筛选键。取值必须为CreationEndTime。

Filter.2.Value String 2017-12-06T22:40:00Z

查询资源时的筛选值。取值必须为资源创建的结束时间点(CreationEndTime)。

InstanceId String i-instance1

实例ID。

KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb408***

云盘使用的KMS密钥ID。

LockReason String recycling

云盘或本地盘被锁定的原因。取值范围:

  • financial:因欠费被锁定
  • security:因安全原因被锁定
  • recycling:抢占式实例的待释放锁定状态
  • dedicatedhostfinancial:因为专有宿主机欠费导致ECS实例被锁定
PageNumber Integer 1

云盘或本地盘状态列表的页码,起始值:1

默认值:1

PageSize Integer 10

分页查询时设置的每页行数,最大值:100

默认值:10

Portable Boolean false

要查询的云盘是否支持卸载,该属性为不可修改属性。取值范围:

  • true:可卸载云盘,可以独立存在且可以自由在可用区内挂载和卸载
  • false:不可卸载云盘,不可以独立存在且不可以自由在可用区内挂载和卸载

这个属性为true的云盘才能挂载和卸载,其中:

  • 本地盘
  • 本地SSD盘
  • 系统盘
  • 包年包月数据盘

该属性都为false

ResourceGroupId String rg-resourcegroupid1

云盘或本地盘所在的企业资源组ID。

SnapshotId String s-snapshotid1

创建云盘使用的快照ID。

Status String All

云盘状态,参见普通云盘状态。取值范围:

  • In_use
  • Available
  • Attaching
  • Detaching
  • Creating
  • ReIniting
  • All

默认值:All

Tag.N.Key String FinanceJoshua

云盘的标签键。N的取值范围:1~20。

Tag.N.Value String FinanceDept

云盘的标签值。N的取值范围:1~20。

Tag.N.key String FinanceJoshua

云盘的标签键。

说明 为提高兼容性,请尽量使用Tag.N.Key参数。
Tag.N.value String FinanceDept

云盘的标签值。

说明 为提高兼容性,请尽量使用Tag.N.Value参数。
ZoneId String cn-hangzhou-g

可用区ID。

返回数据

名称 类型 示例值 描述
Disks

云盘或本地盘信息组成的集合。

Disk

云盘或本地盘信息组成的集合。

AttachedTime String 2018-01-01T01:04:22Z

挂载时间。按照ISO8601标准表示,使用UTC +0时间。格式为:yyyy-MM-ddThh:mmZ。

只有在Status为Available时才有意义。

AutoSnapshotPolicyId String s-23f2i9***

云盘采用的自动快照策略ID。

Category String cloud_ssd

云盘或本地盘种类。取值范围:

  • cloud:普通云盘
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD盘
  • cloud_essd:ESSD云盘
  • local_ssd_pro:I/O密集型本地盘
  • local_hdd_pro:吞吐密集型本地盘
  • ephemeral:(已停售)本地盘
  • ephemeral_ssd:(已停售)本地SSD盘
CreationTime String 2018-01-01T01:01:22Z

创建时间。

DeleteAutoSnapshot Boolean false

是否同时删除自动快照。取值范围:

  • true:删除云盘上的快照。
  • false:保留云盘上的快照。

通过CreateSnapshot或者在控制台创建的快照,不受这个参数的影响,会始终保留。

DeleteWithInstance Boolean true

是否随实例释放。取值范围:

  • true:释放实例时,这块云盘随实例一起释放。
  • false:释放实例时,这块云盘保留不释放。
Description String FinanceDept

云盘或本地盘描述。

DetachedTime String 2018-01-08T01:01:22Z

卸载时间。只有在Status为Available时才有意义。

Device String /dev/xvdb

云盘或本地盘挂载的实例的设备名,例如/dev/xvdb。只有在Status为In_use时才有值,其他状态为空。

DiskChargeType String PostPaid

云盘或本地盘的计费方式。取值范围:

  • PrePaid:包年包月。
  • PostPaid:按量付费。
DiskId String d-23jbf2***

云盘或本地盘ID。

DiskName String FinanceDeptJoshua

云盘或本地盘名称。

EnableAutoSnapshot Boolean false

云盘是否执行自动快照策略。取值范围:

  • true:这块云盘执行自动快照策略。
  • false:这块云盘不执行自动快照策略。

默认值:false

EnableAutomatedSnapshotPolicy Boolean false

云盘是否执行自动快照策略。

Encrypted Boolean false

是否为加密云盘。

ExpiredTime String 2018-01-10T01:01:22Z

包年包月云盘的过期时间。

IOPS Integer 4000

每秒读写(I/O)操作的次数,单位:次/s。

IOPSRead Integer 2000

每秒读操作的次数,单位:次/s。

IOPSWrite Integer 2000

每秒写操作的次数,单位:次/s。

ImageId String m-bp13aqm171qynt3u***

创建ECS实例时使用的镜像ID,只有通过镜像创建的云盘才有值,否则为空。这个值在云盘的生命周期内始终不变。

InstanceId String i-instanceid1

云盘或本地盘挂载的实例ID。只有在Status为In_use时才有值,其他状态为空。

KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb408***

云盘使用的KMS密钥ID。

MountInstanceNum Integer 1

共享存储挂载的实例数量。

MountInstances

挂载到实例上的信息集合。

MountInstance

挂载到实例上的信息集合。

AttachedTime String 2017-12-05T2340:00Z

挂载时间。按照ISO8601标准表示,使用UTC +0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

Device String /dev/xvda

云盘或本地盘的挂载点。

InstanceId String i-instanceid1

云盘或本地盘挂载的实例ID。

OperationLocks

云盘或本地盘锁定原因类型。

OperationLock

云盘或本地盘锁定原因类型。

LockReason String security

磁盘被安全锁定的原因。

PerformanceLevel String PL2

ESSD云盘的性能等级。可能值:

  • PL1:单盘最高随机读写IOPS 5万。
  • PL2:单盘最高随机读写IOPS 10万。
  • PL3:单盘最高随机读写IOPS 100万。
Portable Boolean false

云盘是否可卸载。可能值:

  • true:独立普通云盘,可以独立存在且可以自由在可用区内挂载和卸载。
  • false:非独立普通云盘,不可以独立存在,不可以在可用区内挂载和卸载,生命周期与实例等同。

Portable属性为true的云盘才能挂载(AttachDisk)或卸载(DetachDisk)。

Portable属性为false的云盘不支持修改该属性,包括系统盘以及包年包月数据盘。

ProductCode String jxsc000204

云市场的商品标识。

RegionId String cn-hangzhou

云盘或本地盘所属的地域ID。

ResourceGroupId String rg-resourcegroupid1

云盘或本地盘所在的企业资源组ID。

Size Integer 2000

云盘或本地盘大小,单位GiB。

SourceSnapshotId String s-snapshotid1

创建云盘使用的快照,如果创建云盘时,没有指定快照,则为空。这个值在云盘的生命周期内始终不变。

Status String Available

云盘状态。取值范围:

  • In_use
  • Available
  • Attaching
  • Detaching
  • Creating
  • ReIniting
Tags

云盘的标签集合。

Tag

云盘的标签集合。

TagKey String FinanceJoshua

云盘的标签键。

TagValue String FinanceDept

云盘的标签值。

Type String data

云盘或本地盘类型。可能值:

  • system:系统盘。
  • data:数据盘。
ZoneId String cn-hangzhou-g

云盘或本地盘所属的可用区ID。

PageNumber Integer 1

云盘或本地盘列表的页码。

PageSize Integer 10

输入时设置的每页行数。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

TotalCount Integer 1

查询结果总条数。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeDisks
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-g
&DiskIds=["d-diskid1"]
&InstanceId=i-instance1
&DiskType=all
&Category=all
&Status=all
&SnapshotId=s-snapshotid1
&Portable=true
&DeleteWithInstance=false
&DeleteAutoSnapshot=false
&PageNumber=1
&PageSize=10
&DiskName=JoshuaFinance
&AutoSnapshotPolicyId=auto_20140724_2
&EnableAutoSnapshot=false
&Encrypted=false
&DryRun=true
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDisksResponse>
      <Disks>
            <Disk>
                  <DeleteAutoSnapshot>true</DeleteAutoSnapshot>
                  <DeleteWithInstance>false</DeleteWithInstance>
                  <EnableAutoSnapshot>false</EnableAutoSnapshot>
                  <Category>cloud</Category>
                  <Description></Description>
                  <DiskName></DiskName>
                  <Size>5</Size>
                  <Type>data</Type>
                  <InstanceId></InstanceId>
                  <CreationTime>2014-07-23T02:44:07Z</CreationTime>
                  <ImageId></ImageId>
                  <ZoneId>cn-qingdao-b</ZoneId>
                  <AttachedTime>2014-07-23T07:47:35Z</AttachedTime>
                  <DetachedTime>2014-07-23T08:28:48Z</DetachedTime>
                  <Device></Device>
                  <OperationLocks></OperationLocks>
                  <Portable>true</Portable>
                  <ProductCode></ProductCode>
                  <RegionId>cn-qingdao</RegionId>
                  <DiskId>d-28m5zb***</DiskId>
                  <SourceSnapshotId></SourceSnapshotId>
                  <Status>Available</Status>
            </Disk>
            <Disk>
                  <DeleteAutoSnapshot>true</DeleteAutoSnapshot>
                  <DeleteWithInstance>false</DeleteWithInstance>
                  <EnableAutoSnapshot>false</EnableAutoSnapshot>
                  <Category>cloud</Category>
                  <Description></Description>
                  <DiskName></DiskName>
                  <Size>5</Size>
                  <Type>data</Type>
                  <InstanceId></InstanceId>
                  <CreationTime>2014-07-23T02:44:06Z</CreationTime>
                  <ImageId></ImageId>
                  <ZoneId>cn-qingdao-b</ZoneId>
                  <AttachedTime></AttachedTime>
                  <DetachedTime></DetachedTime>
                  <Device></Device>
                  <OperationLocks></OperationLocks>
                  <Portable>true</Portable>
                  <ProductCode></ProductCode>
                  <RegionId>cn-qingdao</RegionId>
                  <DiskId>d-28zfrm***</DiskId>
                  <SourceSnapshotId></SourceSnapshotId>
                  <Status>Available</Status>
            </Disk>
      </Disks>
      <PageNumber>1</PageNumber>
      <PageSize>2</PageSize>
      <TotalCount>9</TotalCount>
      <RequestId>ED5CF6DD-71CA-462C-9C94-A61A78A01479</RequestId>
</DescribeDisksResponse>

JSON 格式

{
	"PageNumber":1,
	"TotalCount":9,
	"PageSize":2,
	"RequestId":"ACD9BBB0-A9D1-46D7-9630-B7A69889E110",
	"Disks":{
		"Disk":[
			{
				"ImageId":"",
				"Description":"",
				"Device":"",
				"ProductCode":"",
				"Portable":true,
				"DetachedTime":"2014-07-23T08:28:48Z",
				"Type":"data",
				"InstanceId":"",
				"ZoneId":"cn-qingdao-b",
				"EnableAutoSnapshot":false,
				"DiskName":"",
				"AttachedTime":"2014-07-23T07:47:35Z",
				"SourceSnapshotId":"",
				"CreationTime":"2014-07-23T02:44:07Z",
				"Status":"Available",
				"DeleteAutoSnapshot":true,
				"Category":"cloud",
				"RegionId":"cn-qingdao",
				"DeleteWithInstance":false,
				"OperationLocks":{
					"OperationLock":[]
				},
				"DiskId":"d-28m5zb***",
				"Size":5
			},
			{
				"ImageId":"",
				"Description":"",
				"Device":"",
				"ProductCode":"",
				"Portable":true,
				"DetachedTime":"",
				"Type":"data",
				"InstanceId":"",
				"ZoneId":"cn-qingdao-b",
				"EnableAutoSnapshot":false,
				"DiskName":"",
				"AttachedTime":"",
				"SourceSnapshotId":"",
				"CreationTime":"2014-07-23T02:44:06Z",
				"Status":"Available",
				"DeleteAutoSnapshot":true,
				"Category":"cloud",
				"RegionId":"cn-qingdao",
				"DeleteWithInstance":false,
				"OperationLocks":{
					"OperationLock":[]
				},
				"DiskId":"d-28zfrm***",
				"Size":5
			}
		]
	}
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidDiskType.ValueNotSupported The specified disk type is not supported. 指定的磁盘属性不支持。
400 InvalidCategory.ValueNotSupported The specified disk category is not supported. 不支持指定的磁盘种类。
400 InvalidStatus.ValueNotSupported The specified disk status is not supported. 指定的磁盘状态不支持此类操作。
403 InvalidDiskIds.Malformed The amount of specified disk Ids exceeds the limit. 指定的磁盘ID格式不正确。
404 InvalidDiskChargeType.NotFound The DiskChargeType does not exist in our records 指定的磁盘类型不存在。
404 InvalidLockReason.NotFound The specified LockReason is not found 指定的锁定类型不存在。
404 InvalidFilterKey.NotFound 指定的起始时间或到期时间参数错误。
404 InvalidFilterValue 您输了的时间格式不合法。
400 InvalidTag.Mismatch The specified Tag.n.Key and Tag.n.Value are not match. 指定的 Tag.n.Key 和 Tag.n.Value 不匹配。
400 InvalidTagCount The specified tags are beyond the permitted range. 指定的标记超出取值范围。
400 InvalidRegion.NotFound The specified parameter RegionId is not valid. RegionId参数不合法
500 InternalError The request processing has failed due to some unknown error. 内部错误,请重试。如果多次尝试失败,请提交工单。
400 InvalidZoneId.NotFound The zoneId provided does not exist in our records. 提供的 ZoneId 不存在。
400 MissingParamter.RegionId The regionId should not be null. 参数 RegionId 不得为空。
400 InvalidParameter.DiskIds The specified parameter diskIds is not valid. 指定的参数diskIds无效。
400 IncompleteParamter Some fields can not be null in this request. 请求中缺失参数。
400 InvalidParamter Some parameters are invalid in this request. 请求中包含非法参数。
400 InvalidSnapshot.NotFound The specified parameter SnapshotId is not valid. 指定的 SnapshotId 不合法。
403 UserNotInTheWhiteList The user is not in volume white list. 用户不在共享块存储白名单中,请您提交工单申请白名单。
404 InvalidDiskIds.ValueNotSupported The specified parameter "DiskIds" is not supported. 指定的磁盘ID无效。

访问错误中心查看更多错误码。