GetBillingData

描述

获取域名的计费数据

• 支持按指定的起止时间查询，两者需要同时指定
• 支持批量域名查询，多个域名ID用逗号（半角）分隔
• 最多可获取最近一年内93天跨度的数据
• 统计方式：按照server IP归属来进行统计
• 单次查询域名数量不得超过1000个，且单次查询时间跨度至少包含一个时间粒度点（如，粒度为5分钟的时候，单次查询起止时间应大于等于五分钟)。
• 使用场景：
  • 客户查询域名计费数据，用于计费核算
  • 客户根据不同计费方式，对比不同计费数据值，用于计费方式调整依据。

请求语法

本接口请求需要包含指定目录/2016-09-01/statistics/GetBillingData和公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。

请求参数：

参数名	必选	类型及范围	说明
StartTime	是	String	获取数据起始时间点，日期格式按ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:14+0800
EndTime	是	String	结束时间需大于起始时间；获取日期格式按照ISO8601表示法，北京时间，格式为：YYYY-MM-DDThh:mm+0800，例如： 2016-08-01T21:14+0800
CdnType	是	String	产品类型，只允许输入一种类型，取值为file：大文件下载，video：音视频点播，page：小文件下载，live：流媒体直播，all：所有业务类型汇总
DomainIds	否	String	域名ID，缺省为当前产品类型下的全部域名，可输入需要查询的域名ID，支持批量域名查询，多个域名ID用逗号（半角）分隔
Regions	否	String	区域名称，枚举类型表见使用须知，支持多区域查询，多个区域用逗号（半角）分隔，缺省为 CN缺省为 CN
BillingMode	否	String	计费方式， 取值为 peakbw:峰值计费;peak95bw:95峰值计费;averagebw：日峰值平均值计费；monthflow：流量按月，只允许输入一种计费方式，缺省为 peakbw ；

返回参数

参数	类型	描述
StartTime	String	开始时间
EndTime	String	结束时间
CdnType	String	产品类型
DomainIds	String	域名ID列表，逗号（半角）间隔
Regions	String	区域，逗号（半角）间隔，枚举类型表见使用须知
BillingMode	String	计费方式
Datas	BillingData[]	计费数据

BillingData

参数	类型	描述
Region	String	区域
BillingData	Long	每个区域的计费数据

示例

请求示例

GET方式

GET /2016-09-01/statistics/GetBillingData?StartTime=2016-07-31T21:14%2b0800&EndTime=2016-07-31T21:16%2b0800&CdnType=video 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetBillingData
x-version: 2016-09-01

POST方式

POST /2016-09-01/statistics/GetBillingData 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetBillingData
x-version: 2016-09-01
Content-Type: application/json
{ 
"StartTime": "2016-07-31T21:14+0800", 
"EndTime": "2016-07-31T21:16+0800", 
"CdnType": "video"
"BillingMode":"monthflow"
}

响应示例

{
"StartTime":"2017-02-01T00:00+0800",
"EndTime":"2017-02-28T23:56+0800",
"CdnType":"video",
"DomainIds":"2D09R0M",
"Regions":"CN",
"BillingMode":"monthflow",
"Datas":[
          {"Region":"CN",
           "BillingData":1440269
          }
        ]
}