Queries the usage of storage-related resources, including the storage volume and outbound traffic.
Operation description
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
StartTime | string | Yes | The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. | 2019-02-01T14:00:00Z |
EndTime | string | Yes | The end of the time range to query. The end time must be later than the start time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. | 2019-02-01T15:00:00Z |
Region | string | No | The region in which you want to query storage data. If you leave this parameter empty, data in all regions is returned. Separate multiple regions with commas (,). Valid values:
| cn-shanghai |
StorageType | string | No | The storage type. Set the value to OSS. | OSS |
Storage | string | No | The name of the Object Storage Service (OSS) bucket. If you leave this parameter empty, data of all buckets is returned. Separate multiple bucket names with commas (,). | bucket |
Response parameters
Examples
Sample success responses
JSON
format
{
"DataInterval": "day",
"RequestId": "C370DAF1-C838-4288-****-9A87633D248E",
"StorageData": {
"StorageDataItem": [
{
"TimeStamp": "2019-02-01T15:00:00Z",
"StorageUtilization": "111111",
"NetworkOut": "111111"
}
]
}
}
Error codes
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2024-06-26 | The Error code has changed. The request parameters of the API has changed | View Change Details |
2024-04-02 | The Error code has changed | View Change Details |
2024-04-02 | The Error code has changed | View Change Details |
Common errors
The following table describes the error codes that this operation can return.
Error code | Error message | HTTP status code | Description |
---|---|---|---|
Throttling | Request was denied due to request throttling. | 503 | The error message returned because the request was denied due to throttling. |
OperationDenied | Your account does not open VOD service yet. | 403 | The error message returned because ApsaraVideo VOD is not activated for your Alibaba Cloud account. |
OperationDenied | Your VOD service is suspended. | 403 | The error message returned because ApsaraVideo VOD is suspended for your Alibaba Cloud account. |
InvalidParameter | Invalid Parameter. | 400 | The error message returned because one or more parameters are invalid. |
InvalidParameterAliUid | Invalid Parameter AliUid. | 400 | The error message returned because the value of the AliUid parameter is invalid. |
InvalidParameterStartTime | Invalid Parameter StartTime. | 400 | The error message returned because the value of the StartTime parameter is invalid. |
InvalidParameterEndTime | Invalid Parameter EndTime. | 400 | The error message returned because the value of the EndTime parameter is invalid. |
InvalidTimeRange | StartTime and EndTime range should less than 1 month. | 400 | The error message returned because the time range that is specified by the StartTime and EndTime parameters exceeds 31 days. |
InvalidParameterRegion | Invalid Parameter Region. | 400 | The error message returned because the value of the Region parameter is invalid. |