Queries the billing history under your Alibaba Cloud account.
The maximum number of times that each user can call this operation per second is 100.
You can query billing history up to the last one month.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeCdnUserBillHistory |
The operation that you want to perform. Set the value to DescribeCdnUserBillHistory. |
StartTime | String | Yes | 2018-09-30T16:00:00Z |
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 collection interval is 5 minutes. |
EndTime | String | Yes | 2018-10-31T16:00:00Z |
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 of the time range to query. The end time must be later than the start time. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
BillHistoryData | Array of BillHistoryDataItem |
The billing history returned. |
|
BillHistoryDataItem | |||
BillTime | String | 2018-09-30T16:00:00Z |
The beginning of the time range that was queried. |
BillType | String | month_4th_day_bandwidth |
The billing method. |
BillingData | Array of BillingDataItem |
The billable items. |
|
BillingDataItem | |||
Bandwidth | Float | 4041 |
The bandwidth. Unit: bit/s. |
CdnRegion | String | AP1 |
The billable region. Valid values:
|
ChargeType | String | DynamicHttp |
The billable item. Valid values:
|
Count | Float | 203601 |
The number of requests. |
Flow | Float | 24567 |
The amount of network traffic. Unit: bytes. |
Dimension | String | flow |
The dimension. |
RequestId | String | ED61C6C3-8241-4187-AAA7-5157AE175CEC |
The ID of the request. |
Examples
Sample requests
http://cdn.aliyuncs.com?Action=DescribeCdnUserBillHistory
&StartTime=2018-09-30T16:00:00Z
&EndTime=2018-10-31T16:00:00Z
&<Common request parameters>
Sample success responses
XML
format
<DescribeCdnUserBillHistoryResponse>
<BillHistoryData>
<BillHistoryDataItem>
<BillType>month_4th_day_bandwidth</BillType>
<BillingData>
<BillingDataItem>
<Bandwidth>4041</Bandwidth>
<CdnRegion>AP1</CdnRegion>
<FLOW>24567</FLOW>
</BillingDataItem>
<BillingDataItem>
<Bandwidth>3819</Bandwidth>
<CdnRegion>NA</CdnRegion>
</BillingDataItem>
<BillingDataItem>
<Bandwidth>272113</Bandwidth>
<CdnRegion>CN</CdnRegion>
</BillingDataItem>
</BillingData>
<Dimension>flow</Dimension>
<BillTime>2018-09-30T16:00:00Z</BillTime>
</BillHistoryDataItem>
<BillHistoryDataItem>
<BillType>month_avg_day_bandwidth</BillType>
<BillingData>
<BillingDataItem>
<Bandwidth>4389</Bandwidth>
<CdnRegion>AP1</CdnRegion>
</BillingDataItem>
<BillingDataItem>
<Bandwidth>4302</Bandwidth>
<CdnRegion>NA</CdnRegion>
</BillingDataItem>
<BillingDataItem>
<Bandwidth>291641</Bandwidth>
<CdnRegion>CN</CdnRegion>
</BillingDataItem>
</BillingData>
<Dimension>flow</Dimension>
<BillTime>2018-09-30T16:00:00Z</BillTime>
</BillHistoryDataItem>
<BillHistoryDataItem>
<BillType>hour_vas</BillType>
<BillingData>
<BillingDataItem>
<Count>205624</Count>
<ChargeType>DynamicHttp</ChargeType>
</BillingDataItem>
</BillingData>
<Dimension>vas</Dimension>
<BillTime>2018-09-30T16:00:00Z</BillTime>
</BillHistoryDataItem>
<BillHistoryDataItem>
<BillType>hour_vas</BillType>
<BillingData>
<BillingDataItem>
<Count>203601</Count>
<ChargeType>DynamicHttp</ChargeType>
</BillingDataItem>
</BillingData>
<Dimension>vas</Dimension>
<BillTime>2018-09-30T17:00:00Z</BillTime>
</BillHistoryDataItem>
</BillHistoryData>
<RequestId>ED61C6C3-8241-4187-AAA7-5157AE175CEC</RequestId>
</DescribeCdnUserBillHistoryResponse>
JSON
format
{
"BillHistoryData": {
"BillHistoryDataItem": [
{
"BillType": "month_4th_day_bandwidth",
"BillingData": {
"BillingDataItem": [
{
"Bandwidth": 4041,
"CdnRegion": "AP1",
"FLOW": "24567"
},
{
"Bandwidth": 3819,
"CdnRegion": "NA"
},
{
"Bandwidth": 272113,
"CdnRegion": "CN"
}
]
},
"Dimension": "flow",
"BillTime": "2018-09-30T16:00:00Z"
},
{
"BillType": "month_avg_day_bandwidth",
"BillingData": {
"BillingDataItem": [
{
"Bandwidth": 4389,
"CdnRegion": "AP1"
},
{
"Bandwidth": 4302,
"CdnRegion": "NA"
},
{
"Bandwidth": 291641,
"CdnRegion": "CN"
}
]
},
"Dimension": "flow",
"BillTime": "2018-09-30T16:00:00Z"
},
{
"BillType": "hour_vas",
"BillingData": {
"BillingDataItem": [
{
"Count": 205624,
"ChargeType": "DynamicHttp"
}
]
},
"Dimension": "vas",
"BillTime": "2018-09-30T16:00:00Z"
},
{
"BillType": "hour_vas",
"BillingData": {
"BillingDataItem": [
{
"Count": 203601,
"ChargeType": "DynamicHttp"
}
]
},
"Dimension": "vas",
"BillTime": "2018-09-30T17:00:00Z"
}
]
},
"RequestId": "ED61C6C3-8241-4187-AAA7-5157AE175CEC"
}
Error codes
For a list of error codes, visit the API Error Center.