全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

DescribeSnapshotLinks

更新时间:2017-11-08 14:22:43

描述

查询磁盘快照链。快照链是一个磁盘所有快照组成的关系链,一个磁盘对应一条快照链,所以快照链 ID 即磁盘 ID。

  • RegionIdDiskIds、和 InstanceId 等请求参数充当了过滤器(filter)功能,参数间是逻辑与(AND)关系。
  • DiskIdsSnapshotLinkIds 是一个 JSON 格式的 Json Array,如 [“d-xxxxxxxxx”, “d-yyyyyyyyy”, … “d-zzzzzzzzz”],ID 之间用半角逗号(,)隔开。
  • 如果不指定任何参数,则过滤器不起作用。当 DiskIdsSnapshotLinkIds 同时为空 Json Array 时,即 [],同样视该过滤器有效,且返回空。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:DescribeSnapshotLinks
RegionId String 磁盘所属于的 Region ID。
InstanceId String 实例 ID。
DiskIds String 磁盘 ID。一次最多指定 100 个磁盘 ID。
SnapshotLinkIds String 快照 ID。一次最多指定 100 个快照 ID。
PageNumber Integer 磁盘状态列表的页码。
起始值:1
默认值:1
PageSize Integer 分页查询时设置的每页行数。取值范围:[1, 50]。
默认值:10

返回参数

名称 类型 描述
RegionId String 快照链源磁盘所属地域 ID
TotalCount Integer 快照链总个数
PageNumber Integer 快照链列表的页码
PageSize Integer 输入时设置的每页行数
SnapshotLinks SnapshotLinkType 快照链信息组成的集合

错误码

错误代码 错误信息 HTTP 状态码 说明
InvalidRegionId The specified regionId is invalid. 400 指定的 RegionId 不合法。
InvalidSnapshotLinkIds The specified snapshotLinkIds is invalid. 400 指定的 SnapshotLinkIds 不合法。
InvalidDiskIds The specified diskIds is invalid. 400 指定的 DiskIds 不合法。
InternalError The request processing has failed due to some unknown error. 500 内部错误。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=DescribeSnapshotLinks
  2. &RegionId=cn-beijing
  3. &PageNumber=1
  4. &ZoneId=cn-beijing-btc-a01
  5. &<公共请求参数>

返回示例

XML 格式

  1. <DescribeSnapshotLinksResponse>
  2. <SnapshotLinks>
  3. <SnapshotLink>
  4. <SnapshotLinkId>d-25okbh2pj</SnapshotLinkId >
  5. <SourceDiskId>d-25okbh2pj</SourceDiskId>
  6. <SourceDiskType>data</SourceDiskType>
  7. <SourceDiskSize>20</SourceDiskSize>
  8. <RegionId> cn-beijing-btc-a01</RegionId>
  9. <TotalCount>1</TotalCount>
  10. <TotalSize>2097152</TotalSize>
  11. </SnapshotLink>
  12. <SnapshotLink>
  13. <SnapshotLinkId>d-2ze0y1jwzpb1geqxkroq</SnapshotLinkId >
  14. <SourceDiskId>d-2ze0y1jwzpb1geqxkroq</SourceDiskId>
  15. <SourceDiskType>system</SourceDiskType>
  16. <SourceDiskSize>40</SourceDiskSize>
  17. <RegionId> cn-beijing-btc-a01</RegionId>
  18. <TotalCount>1</TotalCount>
  19. <TotalSize>2097152</TotalSize>
  20. </SnapshotLink>
  21. </SnapshotLinks>
  22. <PageNumber>1</PageNumber>
  23. <PageSize>2</PageSize>
  24. <TotalCount>9</TotalCount>
  25. <RequestId>ED5CF6DD-71CA-462C-9C94-A61A78A01479</RequestId>
  26. </DescribeSnapshotLinksResponse>

JSON 格式

  1. {
  2. "SnapshotLinks": {
  3. "SnapshotLink": [
  4. {
  5. "SourceDiskSize": 20,
  6. "TotalSize": 2097152,
  7. "SourceDiskType": "data",
  8. "RegionId": "cn-beijing-btc-a01",
  9. "SnapshotLinkId": "d-25okbh2pj",
  10. "SourceDiskId": "d-25okbh2pj",
  11. "TotalCount": 1
  12. },
  13. {
  14. "SourceDiskSize": 40,
  15. "TotalSize": 2097152,
  16. "SourceDiskType": "data",
  17. "RegionId": "cn-beijing-btc-a01",
  18. "SnapshotLinkId": "d-2ze0y1jwzpb1geqxkroq",
  19. "SourceDiskId": "d-2ze0y1jwzpb1geqxkroq",
  20. "TotalCount": 1
  21. }
  22. ]
  23. },
  24. "PageNumber": 1,
  25. "PageSize": 2,
  26. "RequestId": "ACD9BBB0-A9D1-46D7-9630-B7A69889E110",
  27. "TotalCount": 9
  28. }
本文导读目录