腾讯云CDN月95计费带宽查询接口详解

需积分: 0 1 下载量 18 浏览量 更新于2024-08-05 收藏 310KB PDF 举报
月95(闲时)计费带宽查询1是腾讯云CDN针对月结计费客户的专用接口,主要用于获取指定时间段内(如2017年11月1日至30日)的带宽计费数据,包括国内和海外计费。此接口支持同时查询多个域名的月95计费数据,即在非繁忙时段(00:00~08:00)的闲时计费数据。用户可以通过提供域名列表或不指定域名,来获取每个域名单独的计费信息以及整个账户的月95闲时带宽。 在调用时,必须包含起始日期(start)和结束日期(end),这两个参数是强制要求的。此外,用户可以选择性地提供"type"参数,用于指定查询国内(类型1)或海外(类型2)的数据。如果未提供domains参数,接口将返回所有关联域名的计费数据以及总体月95闲时数据。 需要注意的是,月结计费数据在每月1号结算,所以不应在当月查询月95闲时带宽。此外,接口的调用频率限制为每分钟100次,超过这个限制可能导致请求失败。 调用此接口时,返回的结果包括以下几个部分: 1. `code`:整数值,0表示成功,其他值表示错误,参考错误码页面获取具体含义。 2. `message`:字符串,描述接口相关的错误信息。 3. `codeDesc`:英文错误信息或业务侧错误码,同样参考错误码页面。 4. `data`:包含两个对象,`data`字段存储原始计费数据(bps),表示繁忙时段的带宽;`freetime`字段存储闲时计费数据(bps),反映了闲时时段的带宽消耗。 5. `freetime`:对应于`freetime`字段,记录了闲时计费的时间点。 一个调用示例的GET请求格式如下: ``` GET https://cdn.api.qcloud.com?Action=GetTimeBandwidth&start=2017-11-01&end=2017-11-30&hosts.0=ww&Type=1 ``` 在这个例子中,我们查询了2017年11月的国内计费数据,对于指定的域名"ww"。 月95(闲时)计费带宽查询1接口是腾讯云CDN用户获取月度带宽计费详情的重要工具,确保正确设置参数并理解计费算法(闲时折扣计算)是高效使用该接口的关键。