调用DescribeDcdnUserBillHistory查询用户历史账单,最多查询一个月的数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDcdnUserBillHistory |
操作接口名,系统规定参数,取值:DescribeDcdnUserBillHistory。 |
StartTime | String | 是 | 2018-09-30T16:00:00Z |
获取数据起始时间点,日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ。 最小数据粒度为5分钟。 |
EndTime | String | 是 | 2018-10-31T16:00:00Z |
获取数据结束时间点。日期格式按照ISO8601表示法,并使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。 结束时间需大于起始时间。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
BillHistoryData | Array of BillHistoryDataItem |
历史计费数据。 |
|
BillHistoryDataItem | |||
BillTime | String | 2018-09-30T17:00:00Z |
计费周期起始时间。 |
BillType | String | month_4th_day_bandwidth |
计费模式。 |
BillingData | Array of BillingDataItem |
计费数据。 |
|
BillingDataItem | |||
Bandwidth | Float | 4839 |
带宽,单位为Bps。 |
CdnRegion | String | AP1 |
计费大区,取值: CN、OverSeas、AP1、AP2、AP3、NA、SA 、EU、MEAA。 |
ChargeType | String | DynamicHttp |
计费类型。取值:StaticHttp、DynamicHttp、DynamicHttps。 |
Count | Float | 205624 |
个数,单位为个。 |
Flow | Float | 2456 |
流量,单位为字节。 |
Dimension | String | vas |
维度。 |
RequestId | String | ED61C6C3-8241-4187-AAA7-5157AE175CEC |
请求ID。 |
示例
请求示例
http://dcdn.aliyuncs.com/?Action=DescribeDcdnUserBillHistory
&StartTime=2018-09-30T16:00:00Z
&EndTime=2018-10-31T16:00:00Z
&<公共请求参数>
正常返回示例
XML
格式
<DescribeDcdnUserBillHistoryResponse>
<BillHistoryData>
<BillHistoryDataItem>
<BillType>month_4th_day_bandwidth</BillType>
<BillingData>
<BillingDataItem>
<Bandwidth>4041</Bandwidth>
<CdnRegion>AP1</CdnRegion>
<Flow>2456</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>
</DescribeDcdnUserBillHistoryResponse>
JSON
格式
{
"BillHistoryData": {
"BillHistoryDataItem": [
{
"BillType": "month_4th_day_bandwidth",
"BillingData": {
"BillingDataItem": [
{
"Bandwidth": 4041,
"CdnRegion": "AP1",
"Flow": "2456"
},
{
"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"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidEndTime.Malformed | The specified EndTime is invalid. | 请提供正确的结束时间格式。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:yyyy-MM-ddTHH:mm:ssZ。 |
400 | MissingTimeParameter | The StartTime and EndTime must be both specified. | 请同时提供开始时间和结束时间。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交