DescribeSnapshotLinks - 云服务器 ECS

接口说明

调用该接口时，您需要注意：

请求参数RegionId、DiskIds和InstanceId等充当过滤器功能，参数间是逻辑与关系。
如果不指定任何参数，则过滤器不起作用。当DiskIds和SnapshotLinkIds都为空数组时，同样视该过滤器有效，但是返回结果为空。

调试

您可以在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	是否开启了快照极速可用功能。可能值： true：开启。仅ESSD云盘支持开启该功能。 false：关闭。即快照为未开启快照极速可用功能的普通快照。
TotalSize	Long	2097152	快照链中所有快照的大小，单位：Byte。
SourceDiskName	String	testSourceDiskName	源云盘的名称。
SourceDiskSize	Integer	40	源云盘容量，单位：GiB。
SourceDiskType	String	data	源云盘的云盘类型。可能值： system：系统盘。 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	快照类型。说明该参数即将被弃用，为提高兼容性，建议您尽量使用参数`InstantAccess`。

示例

请求示例

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

<DescribeSnapshotLinksResponse>
    <SnapshotLinks>
        <SnapshotLink>
            <InstanceName>testInstanceName1</InstanceName>
            <TotalCount>1</TotalCount>
            <Category>standard</Category>
            <SourceDiskSize>40</SourceDiskSize>
            <InstanceId>i-bp1dh0xo8nucqe1o****</InstanceId>
            <SnapshotLinkId>sl-bp1hgvjgqo3wn8u7****</SnapshotLinkId>
            <SourceDiskName>testSourceDiskName1</SourceDiskName>
            <RegionId/>
            <SourceDiskType>system</SourceDiskType>
            <TotalSize>3806330880</TotalSize>
            <SourceDiskId>d-bp149tb0mqn0boy6****</SourceDiskId>
        </SnapshotLink>
        <SnapshotLink>
            <InstanceName>testInstanceName2</InstanceName>
            <TotalCount>1</TotalCount>
            <Category>standard</Category>
            <InstanceId>i-bp1c84ts5f4b6t6z****</InstanceId>
            <SnapshotLinkId>sl-bp163h35n7endbpv****</SnapshotLinkId>
            <SourceDiskName>testSourceDiskName2</SourceDiskName>
            <RegionId/>
            <TotalSize>2709520384</TotalSize>
            <SourceDiskType>data</SourceDiskType>
            <SourceDiskId>d-bp1cl4hqnh0i2u5h****</SourceDiskId>
        </SnapshotLink>
    </SnapshotLinks>
    <PageNumber>1</PageNumber>
    <PageSize>2</PageSize>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <TotalCount>9</TotalCount>
</DescribeSnapshotLinksResponse>

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.	内部错误，请重试。

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