查询磁盘快照链。快照链是一个磁盘所有快照组成的关系链,一个磁盘对应一条快照链,所以快照链 ID 即磁盘 ID。
描述
调用该接口时,您需要注意:
- 请求参数 RegionId、DiskIds 和 InstanceId 等充当过滤器功能,参数间是逻辑与关系。
- 如果不指定任何参数,则过滤器不起作用。当 DiskIds 和 SnapshotLinkIds 都为空数组时,同样视该过滤器有效,但是返回结果为空。
调试
前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
RegionId | String | 是 | cn-hangzhou |
磁盘所属于的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 |
Action | String | 否 | DescribeSnapshotLinks |
系统规定参数。取值:DescribeSnapshotLinks |
DiskIds | String | 否 | [“d-xxxxxxxxx”, “d-yyyyyyyyy”, … “d-zzzzzzzzz”] |
磁盘 ID。一次最多指定 100 个磁盘 ID。DiskIds 参数取值格式为 JSON 数组,ID 之间用半角逗号(,)隔开。 |
InstanceId | String | 否 | i-instanceid1 |
实例 ID。 |
OwnerAccount | String | 否 | ECSforCloud@Alibaba.com |
RAM用户的账号登录名称。 |
PageNumber | Integer | 否 | 1 |
磁盘状态列表的页码。起始值:1 默认值:1 |
PageSize | Integer | 否 | 10 |
分页查询时设置的每页行数。取值范围:1~50。 默认值:10 |
SnapshotLinkIds | String | 否 | [“p-xxxxxxxxx”, “p-yyyyyyyyy”, … “p-zzzzzzzzz”] |
快照 ID。一次最多指定 100 个快照 ID。SnapshotLinkIds参数取值格式为 JSON 数组,ID 之间用半角逗号(,)隔开。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
PageNumber | Integer | 1 |
快照链列表的页码 |
PageSize | Integer | 10 |
输入时设置的每页行数 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求 ID。无论调用接口成功与否,我们都会返回请求 ID。 |
SnapshotLinks |
快照链信息组成的集合 |
||
└InstanceId | String | i-instanceid1 |
实例ID |
└InstanceName | String | FinanceJoshua |
实例名称 |
└RegionId | String | cn-hangzhou |
快照链源磁盘所属地域 ID |
└SnapshotLinkId | String | p-2ze0y1jwzpb1geqxkroq |
快照链 ID |
└SourceDiskId | String | d-diskid1 |
源磁盘 ID,如果快照的源磁盘已经被删除,该字段仍旧保留 |
└SourceDiskName | String | FinanceJoshua |
源磁盘的名称 |
└SourceDiskSize | Integer | 40 |
源磁盘容量,单位为 GiB |
└SourceDiskType | String | cloud_ssd |
源磁盘的类型。取值范围:
|
└TotalCount | Integer | 1 |
快照总个数 |
└TotalSize | Integer | 2097152 |
快照链中所有快照的大小,单位为 Byte |
TotalCount | Integer | 9 |
快照链总个数 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeSnapshotLinks
&RegionId=cn-hangzhou
&InstanceId=i-instanceid1
&DiskIds=["d-xxxxxxxxx", "d-yyyyyyyyy", … "d-zzzzzzzzz"]
&SnapshotLinkIds=["p-xxxxxxxxx", "p-yyyyyyyyy", … "p-zzzzzzzzz"]
&PageNumber=1
&PageSize=10
&<公共请求参数>
正常返回示例
XML
格式
<DescribeSnapshotLinksResponse>
<SnapshotLinks>
<SnapshotLink>
<SnapshotLinkId>d-25okbh2pj</SnapshotLinkId>
<SourceDiskId>d-25okbh2pj</SourceDiskId>
<SourceDiskType>data</SourceDiskType>
<SourceDiskSize>20</SourceDiskSize>
<RegionId> cn-beijing-btc-a01</RegionId>
<TotalCount>1</TotalCount>
<TotalSize>2097152</TotalSize>
</SnapshotLink>
<SnapshotLink>
<SnapshotLinkId>d-2ze0y1jwzpb1geqxkroq</SnapshotLinkId>
<SourceDiskId>d-2ze0y1jwzpb1geqxkroq</SourceDiskId>
<SourceDiskType>system</SourceDiskType>
<SourceDiskSize>40</SourceDiskSize>
<RegionId> cn-beijing-btc-a01</RegionId>
<TotalCount>1</TotalCount>
<TotalSize>2097152</TotalSize>
</SnapshotLink>
</SnapshotLinks>
<PageNumber>1</PageNumber>
<PageSize>2</PageSize>
<TotalCount>9</TotalCount>
<RequestId>ED5CF6DD-71CA-462C-9C94-A61A78A01479</RequestId>
</DescribeSnapshotLinksResponse>
JSON
格式
{
"PageNumber":1,
"TotalCount":9,
"PageSize":2,
"RequestId":"ACD9BBB0-A9D1-46D7-9630-B7A69889E110",
"SnapshotLinks":{
"SnapshotLink":[
{
"TotalCount":1,
"SourceDiskType":"data",
"SourceDiskId":"d-25okbh2pj",
"RegionId":"cn-beijing-btc-a01",
"SourceDiskSize":20,
"SnapshotLinkId":"d-25okbh2pj",
"TotalSize":2097152
},
{
"TotalCount":1,
"SourceDiskType":"data",
"SourceDiskId":"d-2ze0y1jwzpb1geqxkroq",
"RegionId":"cn-beijing-btc-a01",
"SourceDiskSize":40,
"SnapshotLinkId":"d-2ze0y1jwzpb1geqxkroq",
"TotalSize":2097152
}
]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidDiskIds | The specified diskIds is invalid. | 指定的磁盘无效。 |
查看本产品错误码
发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1921.html