Queries the billing history under your Alibaba Cloud account.
Operation description
- You can query billing history up to the last one month.
- You can call this operation up to 100 times per second per account.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
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. The minimum data granularity is 5 minutes. | 2018-09-30T16:00:00Z |
EndTime | string | Yes | The end 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. The end time must be later than the start time. | 2018-10-31T16:00:00Z |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "ED61C6C3-8241-4187-AAA7-5157AE175CEC",
"BillHistoryData": {
"BillHistoryDataItem": [
{
"Dimension": "flow",
"BillType": "month_4th_day_bandwidth",
"BillTime": "2018-09-30T16:00:00Z",
"BillingData": {
"BillingDataItem": [
{
"Flow": 24567,
"Bandwidth": 4041,
"Count": 203601,
"CdnRegion": "AP1",
"ChargeType": "DynamicHttp"
}
]
}
}
]
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidParameter | The specified parameter is invalid. | - |
400 | InvalidParameterProduct | Invalid Parameter Product. | The Product parameter is set to an invalid value. |
400 | InvalidParameterAliuid | Invalid Parameter Aliuid. | The Aliuid parameter is set to an invalid value. |
400 | InvalidParameterStartTime | The parameter StartTime is invalid. | The specified StartTime parameter is invalid. |
400 | InvalidParameterEndTime | The parameter EndTime is invalid. | - |
400 | InvalidTimeRange | Invalid StartTime and EndTime range. | The specified time range is invalid. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2023-07-05 | The Error code has changed | View Change Details |