调用DescribeCdnUserBillHistory查询用户历史账单。

单用户调用频率:100次/秒。

最多查询一个月内的数据。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeCdnUserBillHistory

操作接口名,系统规定参数。取值:DescribeCdnUserBillHistory

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-30T16:00:00Z

计费周期起始时间。

BillType String month_4th_day_bandwidth

计费模式。

BillingData Array of BillingDataItem

计费数据。

BillingDataItem
Bandwidth Float 4041

带宽,单位为Bps。

CdnRegion String AP1

计费大区。取值:

  • CN:中国内地。
  • OverSeas:全球(不包含中国内地)。
  • AP1:亚太1区。
  • AP2:亚太2区。
  • AP3:亚太3区。
  • NA:北美。
  • SA :南美。
  • EU:欧洲。
  • MEAA:中东、非洲。
ChargeType String DynamicHttp

计费类型。取值:

  • StaticHttp:静态HTTP。
  • DynamicHttp:动态HTTP。
  • DynamicHttps:动态HTTPS。
Count Float 203601

请求个数,单位为个。

Flow Float 24567

流量,单位为字节。

Dimension String flow

维度。

RequestId String ED61C6C3-8241-4187-AAA7-5157AE175CEC

请求ID。

示例

请求示例

http://cdn.aliyuncs.com?Action=DescribeCdnUserBillHistory
&StartTime=2018-09-30T16:00:00Z
&EndTime=2018-10-31T16:00:00Z
&<公共请求参数>

正常返回示例

XML 格式

<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 格式

{
  "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"
}

错误码

访问错误中心查看更多错误码。