CDN中间流量统计接口
更新时间：2025-08-20 10:54:53
该接口用于查询指定维度的cdn中间流量数据，用户可以通过该接口来查询对应客户的详细频道中间流量报表，包括输出日期、峰值时间、带宽峰值、总流量等。这对客户了解自身的中间流量使用情况有很直接的帮助。
- 单用户调用频率：300/5min
- 适用产品：云点播、云直播、流媒体点播、低延时直播、日志下载、流媒体直播、API Shield、动态加速、边缘云主机、边缘应用、静态加速、CloudDNS、互动直播、Cloud Security 2.0、Flood Shield、Application Shield、CDN Pro、Flood Shield 2.0
API鉴权说明详见：API鉴权概览
请求参数
Body 参数
| 参数名称 | 描述 |
|---|---|
dateFromString | 开始时间
1. 时间格式为'yyyy-MM-dd'；
2. 不能大于当前日期；
3. 最多可获取最近730天的数据； |
dateToString | 结束时间
1. 时间格式为'yyyy-MM-dd'；
2. 结束时间需大于等于开始时间；
3. 结束时间如果大于当前时间，取当前时间；
4. dateFrom，dateTo二者都未传，默认查询当天；如仅有一个未传，抛异常；
5. 允许查询最大间隔：30天，即dateFrom和dateTo相差不能超过30天； |
timezoneString | 1. 指定查询时间(dateFrom/dateTo)和返回数据的时区；
2. 格林尼治时区，默认时区是GMT+08:00；
3. 如果您希望指定不同的时区，可以附加时区标识，即'GMT+09:00'或'GMT-10:00'； |
timeRoundingString | 默认值：up 可选值：updown 根据指定的时间周期对时间戳进行向上或向下取整。仅当粒度小于1天（不包含1天）时有效。
1. 'up'表示向上取整。例如：granularity=5m，00:00:00~00:05:00将会显示为 00:05:00；
2. 'down'表示向下取整，例如：granularity=5m时，00:00:00~00:05:00将显示为00:00:00；
3. 如未传值，结果将进行向上取整(up)； |
domainString | 域名
1. 未传递domain时：查询账号下所有全部域名(域名超过2000个则报错，可联系技术支持调整)；
2. 有传递domain时：域名最多支持传2000个（可联系技术支持调整）；
3. 多个域名用英文逗号';'分割； |
serviceTypeString | 加速域名的服务类型
1. 未传递视为不限服务类型；
2. 多个服务类型请使用英文分号';'分隔；eg: 'web;web-https' |
billingRegionString | 可选值：查看参数值 加速域名的计费区域
1. 未传递视为不限计费区域；
2. 多个计费区域请用英文分号';'分隔；如：'cn;hk' |
granularityString | 默认值：1d 可选值：5m1h1d 数据粒度：默认1天粒度
- 5m：5分钟粒度
- 1h：1小时粒度
- 1d：1天粒度 |
groupByString | 可选值：domain 分组关键词
1. 未传递时，默认聚合展示；
2. 传入关键词则代表需要按照关键词维度分组对应的值展示明细（例如传domain，则代表返回按照domain明细展开），如传入不支持的关键词，返回相应错误提示；
3. 支持传多个值，传多个请用英文分号';'分隔，当前只支持'domain'； |
返回参数
Body 参数
| 参数名称 | 描述 |
|---|---|
codeString | 请求状态 |
messageString | 请求状态描述 |
dataObject | 具体响应内容 |
reportObject | 数据信息的容器 |
typeString | 默认值：cdn-traffic-report-data 接口数据名称 |
dateFromString | 标记返回数据的开始时间，格式为 yyyy-MM-dd. |
dateToString | 标记返回数据的结束时间，格式为 yyyy-MM-dd. |
timezoneString | 默认值：GMT+08:00 标记返回数据的时区，格林尼治时区，格式是GMT+08:00 |
groupsList | 数据项集合，每个数据项包含：domain，flow，peakBandwidth，peakTime字段 |
domainString | 频道 |
totalRelayTrafficString | CDN到客户端的流量，单位：GB，精确到小数点后3位。 |
peakBandwidthString | 带宽峰值(5分钟粒度），单位Mbps 1、精确到小数点后3位 2、如果granularity<=5m，则在[groups]分组容器对象中不显示 |
peakTimeString | 峰值时间(5分钟粒度） |
itemList | 明细数据列表，每项包含time和flow字段 |
timeString | 表示日期和时间 1、如果类型为“5m”，则时间戳格式为“YYYY-MM-DD hh:mm:00”，表示该时间段的结束时间。 2、如果类型为“1h”，则时间戳格式为“YYYY-MM-DD hh:00:00”，表示该时间段的开始时间。 3、如果类型为“1d”，则时间戳格式为“YYYY-MM-DD 00:00:00”，表示该时间段的开始时间。 |
relayTrafficString | CDN到客户端的流量，单位：GB，精确到小数点后3位。 |
错误码
| 错误代码（code） | 描述（message） | HTTP状态码 | 语义 |
|---|---|---|---|
| 24001121 | Parameter not provided | 200 | 参数没有提供 |
| 24001122 | The format of parameter is incorrect | 200 | 参数格式有误 |
| 24001123 | The range of parameter is incorrect. | 200 | 参数范围有误 |
| 24001124 | Parameter authentication failed | 200 | 参数鉴权失败 |
| 24001125 | Parameter data exceeds the limit | 200 | 参数数据超出限制 |
| 24001126 | domain does not exist | 200 | 频道不存在 |
| 24001127 | domain is invalid | 200 | 频道无效 |
| 24001128 | Billing region is invalid | 200 | 计费区域无效 |
| 24001129 | The value of parameter is wrong | 200 | 参数取值有误 |
| 24001130 | The given customer does not exist | 200 | 客户不存在 |
| 24002001 | Mysql querying encounter error | 200 | Mysql查询报错 |
示例
JSON
- 请求示例 复制成功
#!/bin/bash username="example_username" apiKey="example_apikey" date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://endpoint/cdn/traffic/relay" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/xml" \ -d '{"dateFrom":"2024-09-01","dateTo":"2024-09-01","domain":"a.com;b.com"}'- 返回示例 复制成功
{ "code": "0", "message": "Success", "data": { "report": { "type": "get-cdn-relay-traffic", "dateFrom": "2024-09-01", "dateTo": "2024-09-01", "timezone": "GMT+07:00", "groups": [ { "domain": "a.com", "totalRelayTraffic": "0.053", "peakBandwidth": "0.246", "peakTime": "2024-09-01 01:05:00", "item": [ { "time": "2024-09-01 01:00:00", "relayTraffic": "0.000" }, { "time": "2024-09-01 01:05:00", "relayTraffic": "0.009" }, { "time": "2024-09-01 01:10:00", "relayTraffic": "0.005" }, { "time": "2024-09-01 01:15:00", "relayTraffic": "0.005" }, { "time": "2024-09-01 01:20:00", "relayTraffic": "0.005" }, { "time": "2024-09-01 01:25:00", "relayTraffic": "0.003" }, { "time": "2024-09-01 01:30:00", "relayTraffic": "0.004" }, { "time": "2024-09-01 01:35:00", "relayTraffic": "0.004" }, { "time": "2024-09-01 01:40:00", "relayTraffic": "0.004" }, { "time": "2024-09-01 01:45:00", "relayTraffic": "0.003" }, { "time": "2024-09-01 01:50:00", "relayTraffic": "0.003" }, { "time": "2024-09-01 01:55:00", "relayTraffic": "0.004" }, { "time": "2024-09-01 02:00:00", "relayTraffic": "0.004" } ] }, { "domain": "b.com", "totalRelayTraffic": "0.053", "peakBandwidth": "0.246", "peakTime": "2024-09-01 01:05:00", "item": [ { "time": "2024-09-01 01:00:00", "relayTraffic": "0.000" }, { "time": "2024-09-01 01:05:00", "relayTraffic": "0.009" }, { "time": "2024-09-01 01:10:00", "relayTraffic": "0.005" }, { "time": "2024-09-01 01:15:00", "relayTraffic": "0.005" }, { "time": "2024-09-01 01:20:00", "relayTraffic": "0.005" }, { "time": "2024-09-01 01:25:00", "relayTraffic": "0.003" }, { "time": "2024-09-01 01:30:00", "relayTraffic": "0.004" }, { "time": "2024-09-01 01:35:00", "relayTraffic": "0.004" }, { "time": "2024-09-01 01:40:00", "relayTraffic": "0.004" }, { "time": "2024-09-01 01:45:00", "relayTraffic": "0.003" }, { "time": "2024-09-01 01:50:00", "relayTraffic": "0.003" }, { "time": "2024-09-01 01:55:00", "relayTraffic": "0.004" }, { "time": "2024-09-01 02:00:00", "relayTraffic": "0.004" } ] } ] } } }
本篇文档内容对您是否有帮助？
有帮助
我要反馈