调用DescribeDcdnUserBillHistory查询用户历史账单,最多查询一个月的数据。

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

调试

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

请求参数

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

系统规定参数。取值:DescribeDcdnUserBillHistory

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 vas

维度。

BillType String month_4th_day_bandwidth

计费模式。

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

计费周期起始时间。

BillingData Array of BillingDataItem

计费数据。

BillingDataItem
Flow Float 2456

流量,单位为字节。

Bandwidth Float 4839

带宽,单位为Bps。

Count Float 205624

个数,单位为个。

CdnRegion String AP1

计费大区,取值: CNOverSeasAP1AP2AP3NASAEUMEAA

ChargeType String DynamicHttp

计费类型。取值:StaticHttpDynamicHttpDynamicHttps

示例

请求示例

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

正常返回示例

XML格式

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

HTTP/1.1 200 OK
Content-Type:application/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 InvalidStartTime.Malformed The specified StartTime parameter is invalid. 请提供正确的开始时间格式。日期格式按照ISO8601表示法,并使用UTC时间,格式为:yyyy-MM-ddTHH:mm:ssZ。
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. 请同时提供开始时间和结束时间。

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