调用DescribeSnapshotsUsage查询您在一个地域下的快照数量以及快照容量-阿里云帮助中心

调用DescribeSnapshotsUsage查询您在一个地域下的快照数量以及快照容量。

接口说明

如果您想知道当前地域下每块磁盘的快照使用情况，推荐使用DescribeSnapshotLinks查询快照链。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeSnapshotsUsage	系统规定参数。取值：DescribeSnapshotsUsage。
RegionId	String	是	cn-hangzhou	快照所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

返回数据

名称	类型	示例值	描述
SnapshotSize	Long	122	当前地域下已产生的快照容量，单位Byte。
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求ID。
SnapshotCount	Integer	5	当前地域下的快照总数。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeSnapshotsUsage
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeSnapshotsUsageResponse>
	<SnapshotCount>5</SnapshotCount>
	<SnapshotSize>122</SnapshotSize>    
    <RequestId>ED5CF6DD-71CA-462C-9C94-A61A78A01479</RequestId>
</DescribeSnapshotsUsageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "SnapshotCount" : "5",
  "SnapshotSize" : "122",
  "RequestId" : "ACD9BBB0-A9D1-46D7-9630-B7A69889E110"
}

错误码

HttpCode	错误码	错误信息	描述
403	InvalidParam.RegionId	The specified region is not exist.	指定的地域不存在，请检查该参数是否正确。

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