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

说明
  • 最多查询一个月内的数据。
  • 单用户调用频率:100次/秒。

调试

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

请求参数

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

系统规定参数。取值:DescribeCdnUserBillHistory

StartTime String 2018-09-30T16:00:00Z

获取历史账单起始时间点。日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

最小数据粒度为5分钟。

EndTime String 2018-10-31T16:00:00Z

获取历史账单结束时间点。日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

结束时间需大于起始时间。

返回数据

名称 类型 示例值 描述
RequestId String ED61C6C3-8241-4187-AAA7-5157AE175CEC

请求ID。

BillHistoryData Array of BillHistoryDataItem

历史计费数据。

BillHistoryDataItem
Dimension String flow

维度。

BillType String month_4th_day_bandwidth

计费模式。

BillTime String 2018-09-30T16:00:00Z

计费周期起始时间。

BillingData Array of BillingDataItem

计费数据。

BillingDataItem
Flow Float 24567

流量,单位为字节。

Bandwidth Float 4041

带宽,单位为Bps。

Count Float 203601

请求个数,单位为个。

CdnRegion String AP1

计费大区。取值:

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

计费类型。取值:

  • StaticHttp:静态HTTP。
  • DynamicHttp:动态HTTP。
  • DynamicHttps:动态HTTPS。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidTimeRange Invalid StartTime and EndTime range. 开始时间和结束时间范围无效。

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