You need to enable JavaScript to run this app.
Elastic Compute Service

Elastic Compute Service

Copy page
Download PDF
Snapshot
DescribeSnapshotsUsage - Query snapshot usage
Copy page
Download PDF
DescribeSnapshotsUsage - Query snapshot usage
Call the DescribeSnapshotsUsage API to query snapshot usage.​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
request parameters​
Only unique request parameters for this API and some common parameters are listed below. For more information, see Common Parameters.​
Action string required Example value: DescribeSnapshotsUsage​
The action to be performed: DescribeSnapshotsUsage.​
​
Version string required Example value: 2020-04-01​
The version of the API is: 2020-04-01.​
​
RegionId string required Example value: cn-beijing​
ID of the region to query.​
​
​
​
Response parameters​
Only the unique response parameters for this API are listed below. For more information, see Response Structure.​
SnapshotSize long Example value: 264960475136​
Total snapshot capacity, measured in bytes.​
​
SnapshotCount integer Example value: 5​
Total number of snapshots.​
​
​
​
Request example​
​
GET /?Action=DescribeSnapshotsUsage&Version=2020-04-01&RegionId=cn-beijing HTTP/1.1​
Host: open.volcengineapi.com​
Region: cn-beijing​
ServiceName: storage_ebs​
​
Back to example​
​
{​
"ResponseMetadata": {​
"RequestId": "20260107162925096024223194DB****",​
"Action": "DescribeSnapshotsUsage",​
"Version": "2020-04-01",​
"Service": "storage_ebs",​
"Region": "cn-beijing"​
},​
"Result": {​
"SnapshotSize": 264960475136,​
"SnapshotCount": 5​
}​
}​
​
error code​
The following table lists error codes related to this API and its business logic. For common error codes, see the Public Error Codes documentation.​
​
Status code​
error code​
error message​
Create Volume​
400​
InvalidParameters​
The request has invalid parameters.​
The request contains invalid parameters.​
400​
ErrInvalidAccountId​
account id invalid​
Account ID is invalid.​
400​
SnapshotServiceNonactivated​
Snapshot service is nonactivated, need activate snapshot service from user console.​
Snapshot service is not activated. Please activate it in the user console.​
500​
InternalError​
An internal error has occurred.​
Internal error. Please try again. If multiple attempts fail, submit a ticket.​
​
Last updated: 2026.01.09 18:19:57