调用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

计费大区,取值: CNOverSeasAP1AP2AP3NASAEUMEAA

ChargeType String DynamicHttp

计费类型。取值:StaticHttpDynamicHttpDynamicHttps

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. 请同时提供开始时间和结束时间。

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