调用DescribeSnapshotLinks查询云盘快照链。快照链是一块云盘所有快照组成的关系链，一块云盘对应一条快照链。
接口说明
调用该接口时，您需要注意：
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | DescribeSnapshotLinks |
系统规定参数。取值：DescribeSnapshotLinks。 |
| RegionId | String | 是 | cn-hangzhou |
云盘所属于的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
| InstanceId | String | 否 | i-bp1h6jmbefj2cyqs**** |
实例ID。 |
| DiskIds | String | 否 | [“d-bp1d6tsvznfghy7y****”, “d-bp1ippxbaql9zet7****”, … “d-bp1ib7bcz07lcxa9****”] |
云盘ID。一次最多指定100个云盘ID。DiskIds参数取值格式为JSON数组，ID之间用半角逗号（,）隔开。 |
| SnapshotLinkIds | String | 否 | [“sl-bp1grgphbcc9brb5****”, “sl-bp1c4izumvq0i5bs****”, … “sl-bp1akk7isz866dds****”] |
快照链ID。一次最多指定100个快照ID。SnapshotLinkIds参数取值格式为JSON数组，ID之间用半角逗号（,）隔开。 |
| PageNumber | Integer | 否 | 1 |
云盘状态列表的页码。起始值：1。 默认值：1 。 |
| PageSize | Integer | 否 | 50 |
分页查询时设置的每页行数。取值范围：1~100。 默认值：10。 |
返回数据
|
名称 |
类型 |
示例值 |
描述 |
| PageSize | Integer | 50 |
输入时设置的每页行数。 |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
| PageNumber | Integer | 1 |
快照链列表的页码。 |
| TotalCount | Integer | 9 |
快照链总个数。 |
| SnapshotLinks | Array of SnapshotLink |
快照链信息组成的集合。 |
|
| SnapshotLink | |||
| InstantAccess | Boolean | false |
是否开启了快照极速可用功能。可能值：
|
| TotalSize | Long | 2097152 |
快照链中所有快照的大小，单位：Byte。 |
| SourceDiskName | String | testSourceDiskName |
源云盘的名称。 |
| SourceDiskSize | Integer | 40 |
源云盘容量，单位：GiB。 |
| SourceDiskType | String | data |
源云盘的云盘类型。可能值：
|
| InstanceId | String | i-bp1h6jmbefj2cyqs**** |
实例ID。 |
| SnapshotLinkId | String | sl-2ze0y1jwzpb1geqx**** |
快照链ID。 |
| TotalCount | Integer | 1 |
快照总个数。 |
| RegionId | String | cn-hangzhou |
快照链源云盘所属地域ID。 |
| SourceDiskId | String | d-bp1d6tsvznfghy7y**** |
源云盘ID，如果快照的源云盘已经被删除，该字段仍旧保留。 |
| InstanceName | String | testInstanceName |
实例名称。 |
| Category | String | standard |
快照类型。 说明 该参数即将被弃用，为提高兼容性，建议您尽量使用参数 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeSnapshotLinks
&RegionId=cn-hangzhou
&InstanceId=i-bp1h6jmbefj2cyqs****
&DiskIds=["d-bp1d6tsvznfghy7y****", "d-bp1ippxbaql9zet7****", … "d-bp1ib7bcz07lcxa9****"]
&SnapshotLinkIds=["sl-bp1grgphbcc9brb5****", "sl-bp1c4izumvq0i5bs****", … "sl-bp1akk7isz866dds****"]
&PageNumber=1
&PageSize=10
&正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
testInstanceName1
1
standard
40
i-bp1dh0xo8nucqe1o****
sl-bp1hgvjgqo3wn8u7****
testSourceDiskName1
system
3806330880
d-bp149tb0mqn0boy6****
testInstanceName2
1
standard
i-bp1c84ts5f4b6t6z****
sl-bp163h35n7endbpv****
testSourceDiskName2
2709520384
data
d-bp1cl4hqnh0i2u5h****
1
2
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
9
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"SnapshotLinks" : {
"SnapshotLink" : [ {
"InstanceName" : "testInstanceName1",
"TotalCount" : 1,
"Category" : "standard",
"SourceDiskSize" : 40,
"InstanceId" : "i-bp1dh0xo8nucqe1o****",
"SnapshotLinkId" : "sl-bp1hgvjgqo3wn8u7****",
"SourceDiskName" : "testSourceDiskName1",
"RegionId" : "",
"SourceDiskType" : "system",
"TotalSize" : 3806330880,
"SourceDiskId" : "d-bp149tb0mqn0boy6****"
}, {
"InstanceName" : "testInstanceName2",
"TotalCount" : 1,
"Category" : "standard",
"InstanceId" : "i-bp1c84ts5f4b6t6z****",
"SnapshotLinkId" : "sl-bp163h35n7endbpv****",
"SourceDiskName" : "testSourceDiskName2",
"RegionId" : "",
"TotalSize" : 2709520384,
"SourceDiskType" : "data",
"SourceDiskId" : "d-bp1cl4hqnh0i2u5h****"
} ]
},
"PageNumber" : 1,
"PageSize" : 1,
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"TotalCount" : 2
}错误码
|
HttpCode |
错误码 |
错误信息 |
描述 |
| 400 | InvalidRegionId | The specified regionId is invalid. | 指定的 RegionId 不合法。 |
| 400 | InvalidSnapshotLinkIds | The specified snapshotLinkIds is invalid. | 指定的 SnapshotLinkId 不合法。 |
| 400 | InvalidDiskIds | The specified diskIds is invalid. | 指定的磁盘无效。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | 内部错误，请重试。 |
访问错误中心查看更多错误码。
腾讯云1折，限时活动，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/153281.html