CDN

查询计费数据

最近更新时间:2019-06-11 17:13:54

GetBillingData

描述

获取域名的计费数据

  • 支持按指定的起止时间查询,两者需要同时指定
  • 支持批量域名查询,多个域名ID用逗号(半角)分隔
  • 最多可获取最近一年内93天跨度的数据
  • 使用场景:
    • 客户查询域名计费数据,用于计费核算
    • 客户根据不同计费方式,对比不同计费数据值,用于计费方式调整依据。

请求语法

本接口请求需要包含指定目录/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:中国大陆,HK:香港,TW:台湾,AS:亚洲其他,NA:北美洲,SA:南美洲,EU:欧洲,AU:大洋洲,AF:非洲,支持多区域查询,多个区域用逗号(半角)分隔,每个区域的值单独返回,缺省为 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/x-www-form-urlencoded

StartTime=2016-07-31T21:14+0800&EndTime=2016-07-31T21:16+0800&CdnType=video&BillingMode=monthflow

Json方式

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

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

金山云,开启您的云计算之旅

注册有礼