全部产品
云服务器 ECS

DescribeSnapshotLinks

更新时间:2017-09-21 16:37:59   分享:   

描述

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

  • RegionIdDiskIdsInstanceId 等请求参数充当了过滤器(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 个 DiskId。
SnapshotLinkIds String 快照 ID。一次最多指定 100 个 SnapshotLinkId。
PageNumber Integer 磁盘状态列表的页码。
起始值:1
默认值:1
PageSize Integer 分页查询时设置的每页行数。取值范围:[1, 50]。
默认值:10

返回参数

名称 类型 描述
RegionId String 快照链源磁盘所属地域Id
TotalCount Integer 快照链总个数
PageNumber Integer 快照链列表的页码
PageSize Integer 输入时设置的每页行数
SnapshotLinks SnapshotLinkType 快照链信息 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. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?