Queries the number of snapshots stored in a region as well as their total size. If you want to view the snapshot usage information for each disk in a region, we recommend that you call the DescribeSnapshotLinks operation to query snapshot chain information.


You can use API Explorer to perform debugging. API Explorer allows you to perform various operations to simplify API usage. For example, you can retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Name Type Required Example Description
RegionId String Yes cn-hangzhou

The ID of the region to which the snapshot belongs. You can call DescribeRegions to view the latest regions of Alibaba Cloud.

Action String No DescribeSnapshotsUsage

The operation that you want to perform. Set the value to DescribeSnapshotsUsage.

Response parameters

Name Type Example Description
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

The ID of the request.

SnapshotCount Integer 5

The number of snapshots stored in the current region.

SnapshotSize Long 122

The total size of snapshots stored in the current region. Unit: Byte.


Sample requests

&<Common request parameters>

Successful response examples

XML format


JSON format


Error codes

HTTP status code Error code Error message Description
403 InvalidParam. RegionId The specified region does not exist. The error message returned when the specified region does not exist.

View error codes