返回API中心
CloudDNS

CDN中间流量统计接口

更新时间：2026-04-02 14:09:54
POST在线调试

该接口用于查询指定维度的cdn中间流量数据，用户可以通过该接口来查询对应客户的详细频道中间流量报表，包括输出日期、峰值时间、带宽峰值、总流量等。这对客户了解自身的中间流量使用情况有很直接的帮助。

  • 单用户调用频率：300/5min
  • 适用产品：云点播、云直播、流媒体点播、低延时直播、日志下载、流媒体直播、API安全防护、动态加速、边缘云主机、静态加速、CloudDNS、互动直播、网站安全 2.0、DDoS云清洗、应用安全、CDN Pro、DDoS云清洗 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

200Mysql查询报错

示例

JSON
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"
                        }
                    ]
                }
            ]
        }
    }
}
本篇文档内容对您是否有帮助？
有帮助
我要反馈
提交成功！非常感谢您的反馈，我们会继续努力做到更好！

CDNetworks Inc., © 2025. 1840 Enterprise Way, Monrovia, CA 91016 – All rights reserved.