统计接口（新版）

更新时间：2025-08-21

接口

本接口用于查询用户或域名的统计指标信息。

Method	Path	说明
POST	/v2/stat/query	所有统计数据的路径，不同的统计指标由post参数中的metric指定。

默认接口请求频率限制：30次/秒。

默认请求体（Request Body）

所有metric支持的参数以此进行扩展。

参数	可选	类型	说明
metric	必选	String	示例：src_flow、flow、pv、pv_region、avg_speed等等。更多metric参数值请查看本页面中对应接口metric值。
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间，UTC时间
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时，UTC时间。60s查询粒度只能查询最近7天数据，300s粒度可查询最近90天数据，其他粒度可查询最近180天数据
period	可选	Long	查询结果的粒度，单位秒，可选值为60、300、3600、86400，默认为300。uv 默认3600，topN查询最小3600。（选60s的时间粒度时建议startTime和endTime区间跨度建议选择0.5到1h，300s建议查询时间跨度在1天内，否则可能会因为数据量太大无法正常返回或返回数据粒度不正确）
key_type	可选	Long	标识key的内容，0=>域名，1=>用户id，2=>tag，默认0
key	可选	list<String>	域名或用户Id或Tag，当查询key_type为tag时，key的格式为标签键或标签键:标签值。例如：标签键=默认项目，标签值=test，查询key参数key=["默认项目:test"]。当没有标签值时，key=["默认项目"]
groupBy	可选	String	返回结果聚合粒度，key => 根据key聚合，空 => 返回整体结果

默认响应体（Response Body）

所有metric的响应结果以此扩展。

参数	类型	说明
status	String	正常返回的时候为"ok"
details	list<Details>	list类型
count	Long	list的长度

Details 内容

参数	类型	说明
timestamp	Timestamp	时间点 UTC时间
key	String	聚合粒度（groupBy）：key => key，其他 => total
...	Object	扩展字段，metric对应的统计指标

平均速率相关接口

查询平均速率

metric：avg_speed

响应体扩展字段：

参数	类型	说明
avgspeed	Long	统计时间段内的平均速率

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric":"avg_speed",
    "startTime":"2019-03-20T06:00:00Z",
    "endTime":"2019-03-20T06:10:00Z",
    "period":300,
    "key_type":0,
    "key":["cdaa.wonter.net"],
    "groupBy":"key"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net",
            "avgspeed": 1219463
        },
        {
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net",
            "avgspeed": 1289562
        }
    ],
    "count": 2
}
            

客户端访问分布查询平均速率

metric：avg_speed_region

请求体扩展字段:

参数	可选	类型	说明
prov	可选	String	查询的省份全拼，默认为空，查询全国数据。
isp	可选	String	查询的运营商代码，默认为空，查询所有运营商数据。

响应体扩展字段:

参数	类型	说明
distribution	list<DistributionData>	客户端访问分布数据

DistributionData内容

参数	类型	说明
location	String	客户端所在省份、地区
isp	String	客户端所属运营商
avgspeed	Long	统计时间段内的平均速率

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "avg_speed_region",
    "startTime": "2019-03-19T06:00:00Z",
    "endTime": "2019-03-19T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key",
    "prov": "beijing",
    "isp": "ct"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "timestamp": "2019-03-19T06:00:00Z",
            "key": "cdaa.wonter.net",
            "distribution": [
                {
                    "location": "北京",
                    "isp": "电信",
                    "avgspeed": 1683448
                }
            ]
        },
        {
            "timestamp": "2019-03-19T06:05:00Z",
            "key": "cdaa.wonter.net",
            "distribution": [
                {
                    "location": "北京",
                    "isp": "电信",
                    "avgspeed": 1964874
                }
            ]
        }
    ],
    "count": 2
}
            

pv/qps相关接口

pv/qps查询

metric：pv

请求体扩展字段：

参数	可选	类型	说明
level	可选	String	查询边缘或全局请求pv。可填写"all"或"edge"，默认为“all”

响应体扩展字段：

参数	类型	说明
pv	Long	统计时间段内的请求量
qps	Long	统计时间段内的平均qps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "pv",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key",
    "level": "edge"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "pv": 2145,
            "qps": 7,
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "pv": 2950,
            "qps": 9,
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

pv/qps https协议查询

metric：pv_protocol

请求体扩展字段：

参数	可选	类型	说明
protocol	可选	String	查询指定协议的pv。可填写http、https、http3、all，默认all

响应体扩展字段：

参数	类型	说明
pv	Long	统计时间段内的请求量
qps	Long	统计时间段内的平均qps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric":"pv",
    "startTime":"2019-03-20T06:00:00Z",
    "endTime":"2019-03-20T06:10:00Z",
    "period":300,
    "key_type":0,
    "key":["cdaa.wonter.net"],
    "groupBy":"key",
    "protocol":"https"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "pv": 2145,
            "qps": 7,
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "pv": 2950,
            "qps": 9,
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

回源pv/qps查询

metric：pv_src

响应体扩展字段:

参数	类型	说明
pv	Long	统计时间段内的回源请求量
qps	Long	统计时间段内的平均qps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "pv_src",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "pv": 0,
            "qps": 0,
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "pv": 0,
            "qps": 0,
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

查询pv/qps(分客户端访问分布)

metric: pv_region

请求体扩展字段：

参数	可选	类型	说明
prov	可选	String	查询的省份全拼，默认为空，查询全国数据
isp	可选	String	查询的运营商代码，默认为空，查询所有运营商数据
protocol	可选	String	查询的协议，可填写http3、all，默认all

响应体扩展字段：

参数	类型	说明
distribution	list<DistributionData>	客户端访问分布数据

DistributionData内容

参数	类型	说明
location	String	客户端所在省份、地区
isp	String	客户端所属运营商
pv	Long	统计时间段内的请求量
qps	Long	统计时间段内的平均qps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "pv_region",
    "startTime": "2019-03-19T06:00:00Z",
    "endTime": "2019-03-19T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key",
    "prov": "beijing",
    "isp": "ct"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "timestamp": "2019-03-19T06:00:00Z",
            "key": "cdaa.wonter.net",
            "distribution": [
                {
                    "location": "北京",
                    "isp": "电信",
                    "pv": 148,
                    "qps": 0
                }
            ]
        },
        {
            "timestamp": "2019-03-19T06:05:00Z",
            "key": "cdaa.wonter.net",
            "distribution": [
                {
                    "location": "北京",
                    "isp": "电信",
                    "pv": 142,
                    "qps": 0
                }
            ]
        }
    ],
    "count": 2
}
            

uv查询

metric：uv

响应体扩展字段：

参数	类型	说明
uv	Long	统计时间段内的请求量

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "uv",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "uv": 127994,
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "uv": 12700,
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

流量带宽接口

查询流量、带宽

metric: flow

请求体扩展字段：

参数	可选	类型	说明
level	可选	String	查询边缘或全局请求流量、带宽。可填写"all"或"edge"，默认为"all"

响应体扩展字段：

参数	类型	说明
flow	Long	统计时间段内的传输字节数
bps	Long	统计时间段内的平均bps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "flow",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key",
    "level": "edge"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "flow": 88186275,
            "bps": 2351634,
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "flow": 90383520,
            "bps": 2410227,
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

查询流量、带宽（静态）

metric: flow_static

请求体扩展字段：

参数	可选	类型	说明
level	可选	String	查询边缘或全局静态请求流量、带宽。可填写"all"或"edge"，默认为"all"

响应体扩展字段：

参数	类型	说明
flow	Long	统计时间段内的传输字节数
bps	Long	统计时间段内的平均bps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "flow_static",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key",
    "level": "edge"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "flow": 88186275,
            "bps": 2351634,
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "flow": 90383520,
            "bps": 2410227,
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

查询流量、带宽（动态）

metric: flow_dynamic

请求体扩展字段：

参数	可选	类型	说明
level	可选	String	查询边缘或全局动态请求流量、带宽。可填写"all"或"edge"，默认为"all"

响应体扩展字段：

参数	类型	说明
flow	Long	统计时间段内的传输字节数
bps	Long	统计时间段内的平均bps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "flow_dynamic",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key",
    "level": "edge"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "flow": 88186275,
            "bps": 2351634,
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "flow": 90383520,
            "bps": 2410227,
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

查询流量、带宽（分协议）

metric: flow_protocol

请求体扩展字段：

参数	可选	类型	说明
protocol	可选	String	查询各个协议的流量、带宽。可填写http、https、http3、all，默认all
level	可选	String	支持查询边缘的分协议流量。可填写all或edge，默认all

注：protocol指定http3时，只有边缘流量，level参数无用

响应体扩展字段：

参数	类型	说明
flow	Long	统计时间段内的传输字节数
bps	Long	统计时间段内的平均bps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "flow_protocol",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key",
    "protocol": "all"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "flow": 88186275,
            "bps": 2351634,
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "flow": 90383520,
            "bps": 2410227,
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

查询流量、带宽（分客户端访问分布）

metric: flow_region

请求体扩展字段：

参数	可选	类型	说明
prov	可选	String	查询的省份全拼，默认为空，查询全国数据
isp	可选	String	查询的运营商代码，默认为空，查询所有运营商数据
protocol	可选	String	查询的协议，可填写http3、all，默认all

响应体扩展字段：

参数	类型	说明
distribution	list<DistributionData>	客户端访问分布数据

DistributionData内容

参数	类型	说明
location	String	客户端所在省份、地区
isp	String	客户端所属运营商
flow	Long	统计时间段内的传输字节数
bps	Long	统计时间段内的平均bps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "flow_region",
    "startTime": "2019-03-19T06:00:00Z",
    "endTime": "2019-03-19T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key",
    "prov": "beijing",
    "isp": "ct"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "timestamp": "2019-03-19T06:00:00Z",
            "key": "cdaa.wonter.net",
            "distribution": [
                {
                    "location": "北京",
                    "isp": "电信",
                    "flow": 918742,
                    "bps": 24499
                }
            ]
        },
        {
            "timestamp": "2019-03-19T06:05:00Z",
            "key": "cdaa.wonter.net",
            "distribution": [
                {
                    "location": "北京",
                    "isp": "电信",
                    "flow": 881491,
                    "bps": 23506
                }
            ]
        }
    ],
    "count": 2
}
            

查询月95峰值带宽

method	path	说明
POST	/v2/billing	开放查询统计接口

请求参数

参数	可选	类型	说明
domains	可选	string	为','分隔的域名或标签
type	必选	string	值为peak95，表查询月95带宽数据
withTag	可选	bool	表示查询对象为tag还是domain，默认按 domain 查询，当参数值为 true时表按 tag 查询
byTime	可选	bool	表示是否按整月查询，默认按整月查询，当参数值为true时按输入时间查询
billingMonth	可选	string	整月查询时的开始查询月份，格式形如"year-month"。默认值为本月
startTime	可选	string	开始时间，UTC格式。默认值为当前时间前24小时
endTime	可选	string	结束时间，UTC格式。默认值为当前时间

注1：指定startTime和endTime时，byTime必须设置为true，否则指定时间不生效，按照整月查询。

注2：查询指定月份整月数据时，必须指定billingMonth，否则返回当前月份数据。

返回参数

参数	可选	类型	说明
billing_details	必选	billing_detail	查询的数据

billing_detail 类型说明

参数	可选	类型	说明
bill_band	必选	int	95带宽值
bill_time	必选	string	该数据点的时间

请求示例

                JSON
                
            

                HTTP/1.1 200 OK
Server: nginx
Date: Thu, 19 Dec 2019 04:26:40 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: PHP/7.1.5
x-bce-request-id: aca2dd9e-77a6-7de8-b9d9-7561fb330ba5
 
{
    "type": "peak95",
    "byTime": false, // byTime 为 false 时 startTime，endTime 参数无效
    "startTime": "2019-12-17T16:00:00Z",
    "endTime": "2019-12-18T06:53:33Z",
    "billingMonth": "2018-11"
}
            

返回示例

                JSON
                
            

                {
    "billing_details": {
        "bill_band": 14536504775,
        "bill_time": "2018-11-17T12:20:00Z"
    }
}
            

查询回源流量、回源带宽

metric：src_flow

响应体扩展字段：

参数	类型	说明
flow	Long	统计时间段内的传输字节数
bps	Long	统计时间段内的平均bps

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "src_flow",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
    "status": "ok",
    "details": [
        {
            "flow": 0,
            "bps": 0,
            "timestamp": "2019-03-20T06:00:00Z"
        },
        {
            "flow": 0,
            "bps": 0,
            "timestamp": "2019-03-20T06:05:00Z"
        }
    ],
    "count": 2
}
            

命中率类接口

字节命中率查询

metric：real_hit

响应体扩展字段：

参数	类型	说明
hitrate	Double	统计时间段内的字节命中率

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "real_hit",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net",
            "hitrate": 1
        },
        {
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net",
            "hitrate": 1
        }
    ],
    "count": 2
}
            

请求命中率查询

metric：pv_hit

响应体扩展字段：

参数	类型	说明
hitrate	Double	统计时间段内的pv命中率

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "pv_hit",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net",
            "hitrate": 1
        },
        {
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net",
            "hitrate": 1
        }
    ],
    "count": 2
}
            

状态码类接口

状态码统计查询

metric：httpcode

请求体扩展字段：

参数	可选	类型	说明
level	可选	String	支持查询边缘节点状态码。可填写all或edge，默认all
protocol	可选	String	查询的协议，可填写http3、all，默认all

响应体扩展字段：

参数	类型	说明
counters	list<KvCounter>	HTTP状态码计数

KvCounter内容

参数	类型	说明
name	Long	HTTP状态码
count	Long	统计计数

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "httpcode",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "counters": [
                {
                    "name": 200,
                    "count": 14205
                },
                {
                    "name": 499,
                    "count": 27
                }
            ],
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "counters": [
                {
                    "name": 200,
                    "count": 14558
                }
            ],
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

回源状态码查询

metric：src_httpcode

响应体扩展字段：

参数	类型	说明
counters	list<KvCounter>	HTTP状态码计数

KvCounter内容

参数	类型	说明
name	Long	HTTP状态码
count	Long	统计计数

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "src_httpcode",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "counters": [
                {
                    "name": 200,
                    "count": 14205
                },
                {
                    "name": 499,
                    "count": 27
                }
            ],
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net"
        },
        {
            "counters": [
                {
                    "name": 200,
                    "count": 14558
                }
            ],
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net"
        }
    ],
    "count": 2
}
            

状态码统计查询（分客户端访问分布）

metric：httpcode_region

请求体扩展字段：

参数	可选	类型	说明
prov	可选	String	查询的省份全拼，默认为空，查询全国数据
isp	可选	String	查询的运营商代码，默认为空，查询所有运营商数据
protocol	可选	String	查询的协议，可填写http3、all，默认all

响应体扩展字段：

参数	类型	说明
distribution	list<HttpCodeDistributionData>	按客户端访问地域分布的数据详情

HttpCodeDistributionData 内容

参数	类型	说明
location	String	客户端所在省份、地区
isp	String	客户端所属运营商
counters	list<KvCounter>	HTTP状态码计数

KvCounter内容

参数	类型	说明
name	Long	HTTP状态码
count	Long	统计计数

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "httpcode_region",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key",
    "prov": "beijing",
    "isp": "ct"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net",
            "distribution": [
                {
                    "location": "北京",
                    "isp": "电信",
                    "counters": [
                        {
                            "name": 200,
                            "count": 137
                        }
                    ]
                }
            ]
        },
        {
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net",
            "distribution": [
                {
                    "location": "北京",
                    "isp": "电信",
                    "counters": [
                        {
                            "name": 200,
                            "count": 141
                        }
                    ]
                }
            ]
        }
    ],
    "count": 2
}
            

TopN查询接口

注意：top数据查询时，groupBy参数无效，返回的都是聚合数据

TopN urls

metric：top_urls

请求体扩展字段：

参数	可选	类型	说明
extra	可选	Long	查询指定http状态码的记录，例如200，403，不传默认所有状态码
sortKey	可选	String	值为pv或者flow，默认pv。表示返回的top数据的排序基准，例如取值pv，即所有请求按照pv排序后，取top，但是返回的数据并不是排序的

响应体扩展字段：

参数	类型	说明
counters	list<TopNCounter>	每小时Top200聚合统计
total_pv	Long	总pv
total_flow	Long	总流量

TopNCounter

参数	类型	说明
name	String	url
pv	Long	pv
flow	Long	flow
filesize	Long	文件大小单位byte
filetype	String	文件类型 url资源后缀

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "top_urls",
    "startTime": "2023-08-01T00:00:00Z",
    "endTime": "2023-08-01T01:00:00Z",
    "period": 3600,
    "key_type": 0,
    "key": [
        "baidu.com"
    ]
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "timestamp": "2023-08-01T00:00:00Z",
            "key": "total",
            "counters": [
                {
                    "name": "https://baidu.com/1.txt",
                    "flow": 100,
                    "pv": 2,
                    "filetype": "txt",
                    "filesize": 3
                },
                {
                    "name": "https://baidu.com/2.txt",
                    "flow": 200,
                    "pv": 3,
                    "filetype": "txt",
                    "filesize": 3
                }
            ],
            "total_pv": 5,
            "total_flow": 300
        }
    ],
    "count": 1
}
            

TopN referers

metric：top_referers

请求体扩展字段：

参数	可选	类型	说明
extra	可选	Long	查询指定http状态码的记录，例如200，403，不传默认所有状态码
sortKey	可选	String	值为pv或者flow，默认pv。表示返回的top数据的排序基准，例如取值pv，即所有请求按照pv排序后，取top，但是返回的数据并不是排序的

响应体扩展字段：

参数	类型	说明
counters	list<TopNCounter>	Top100 统计
total_pv	Long	总pv
total_flow	Long	总流量

TopNCounter

参数	类型	说明
name	String	refer
pv	Long	pv
flow	Long	flow

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "top_referers",
    "startTime": "2023-08-01T00:00:00Z",
    "endTime": "2023-08-01T01:00:00Z",
    "period": 3600,
    "key_type": 0,
    "key": [
        "baidu.com"
    ]
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "counters": [
                {
                    "name": "baidu.com",
                    "flow": 2649952,
                    "pv": 21
                }
            ],
            "timestamp": "2023-08-01T00:00:00Z",
            "key": "total",
            "total_pv": 21,
            "total_flow": 2649952
        }
    ],
    "count": 1
}
            

TopN domains

metric：top_domains

请求体扩展字段：

参数	可选	类型	说明
extra	可选	Long	查询指定http状态码的记录，例如200，403，不传默认所有状态码
sortKey	可选	String	值为pv或者flow，默认pv。表示返回的top数据的排序基准，例如取值pv，即所有请求按照pv排序后，取top，但是返回的数据并不是排序的

响应体扩展字段：

参数	类型	说明
counters	list<TopNCounter>	Top100 统计
total_pv	Long	总pv
total_flow	Long	总流量

TopNCounter

参数	类型	说明
name	String	domains
pv	Long	pv
flow	Long	flow

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "top_domains",
    "startTime": "2023-08-01T07:00:00Z",
    "endTime": "2023-08-01T08:00:00Z",
    "period": 3600,
    "key": [
      "your user id"
    ],
    "key_type": 1
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "counters": [
                {
                    "name": "www.baidu.com",
                    "flow": 75385,
                    "pv": 119
                },
                {
                    "name": "test.baidu.com",
                    "flow": 6780,
                    "pv": 13
                },
                {
                    "name": "baidu.com",
                    "flow": 6705,
                    "pv": 18
                }
            ],
            "timestamp": "2023-08-01T07:00:00Z",
            "key": "total",
            "total_pv": 150,
            "total_flow": 88870
        }
    ],
    "count": 1
}
            

TopN clientIP

metric：top_clientip

请求体扩展字段：

参数	可选	类型	说明
extra	可选	Long	查询指定http状态码的记录，例如200，403，不传默认所有状态码
sortKey	可选	String	值为pv或者flow，默认pv。表示返回的top数据的排序基准，例如取值pv，即所有请求按照pv排序后，取top，但是返回的数据并不是排序的

响应体扩展字段：

参数	类型	说明
counters	list<TopNCounter>	Top100 统计
total_pv	Long	总pv
total_flow	Long	总流量

TopNCounter

参数	类型	说明
name	String	ip
pv	Long	pv
flow	Long	flow

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "top_clientip",
    "startTime": "2023-08-01T07:00:00Z",
    "endTime": "2023-08-01T08:00:00Z",
    "period": 3600,
    "key": [
      "your user id"
    ],
    "key_type": 1
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "counters": [
                {
                    "name": "87.236.176.0",
                    "flow": 2640611,
                    "pv": 1
                },
                {
                    "name": "111.206.214.32",
                    "flow": 9341,
                    "pv": 20
                }
            ],
            "timestamp": "2023-08-01T07:00:00Z",
            "key": "total",
            "total_pv": 21,
            "total_flow": 2649952
        }
    ],
    "count": 1
}
            

查询 IPV6 数据接口

method	path	说明
post	/v2/stat/ipv6?stat_type=http/https/all	查询ipv6的统计，stat_type 表查询的数据类型，值为为 http 时表查询的 http 数据；值为 https 时表查询的 https 的数据；值为 all 时表查询的包含http，https的总数据；值为region时表示查询分省份-运营商的数据；默认查询all

请求体（Request Body）

参数	可选	类型	说明
startTime	可选	Timestamp	查询的时间范围起始值，默认为endTime前推24小时 UTC时间
endTime	可选	Timestamp	查询的时间范围结束值，默认为当前时间。时间跨度最长90天 UTC时间
period	可选	int	查询的时间粒度，单位为s，默认值为 300s
keys	可选	list	查询的域名列表，当该列表为空是查询该用户的所有域名的数据
prov	可选	string	查询的省份拼音全拼，默认为空，查询全国数据，仅当stat_type为region表示查询ipv6分区域数据时此值有效
isp	可选	string	查询的运营商代码，默认为空，查询所有运营商数据，仅当stat_type为region表示查询ipv6分区域数据时此值有效

响应体（Request Body）

参数	可选	类型	说明
details	必选	map<timesmap:map<domain:Data>>	查询结果，其中 timesmap 为 UTC 格式时间，domain 为域名或者 userId。Data 为某个时间点某个域名/用户的数据
count	必选	int	查询到到数据条数

Data 类型说明：

参数	可选	类型	说明
flow	必选	int	查询的流量数据
bps	可选	int	查询的带宽数据，仅当stat_type不为region时此值有效
pv	必选	int	查询的pv数据
code	可选	list<map<int: int>	查询的code码数据，仅当stat_type不为region时此值有效
distribution	可选	map<string, string>	区域信息，仅当stat_type为region时此值有效，示例数据：{"location":"广东", "isp": "电信"}

请求示例 1：查询某个域名的全局ipv6统计

                JSON
                
            

                POST /v2/stat/ipv6?stat_type=all
Host: cdn.baidubce.com
{
    "startTime": "2020-12-21T06:25:00Z",
    "endTime": "2020-12-21T07:25:00Z",
    "period": 3600,
    "keys": [
        "www.example.com"
    ]
}
            

响应示例 1

                JSON
                
            

                {
    "count": 3,
    "details": {
        "2020-12-21T06:00:00Z": {
            "www.example.com": {
                "flow": 822846778444,
                "bps": 1828548396,
                "pv": 5953881,
                "code": {
                    "200": 5718978,
                    "206": 4888,
                    "304": 230015,
                    "400": 37,
                    "403": 77,
                    "404": 64,
                    "408": 19,
                    "499": 15810
                }
            }
        },
        "2020-12-21T07:00:00Z": {
            "www.example.com": {
                "flow": 794698943871,
                "bps": 1765997653,
                "pv": 5995772,
                "code": {
                    "200": 5733844,
                    "206": 4908,
                    "304": 257020,
                    "400": 32,
                    "403": 57,
                    "404": 42,
                    "408": 17,
                    "499": 16057
                }
            }
        },
        "2020-12-21T08:00:00Z": {
            "www.example.com": {
                "flow": 767797627279,
                "bps": 1706216949,
                "pv": 6043410,
                "code": {
                    "200": 5790261,
                    "206": 4893,
                    "304": 248256,
                    "400": 31,
                    "403": 81,
                    "404": 32,
                    "408": 15,
                    "416": 1,
                    "499": 15975
                }
            }
        }
    }
}
            

请求示例 2：查询某2个域名在广东电信区域的ipv6统计

                JSON
                
            

                POST /v2/stat/ipv6?stat_type=region
Host: cdn.baidubce.com
{
    "startTime":"2021-08-31T10:00:00Z",
    "endTime":"2021-08-31T10:10:00Z",
    "keys":[
        "www.example.com",
        "www.test.com"
    ],
    "period":300,
    "isp":"ct",
    "prov":"guangdong"
}
            

响应示例 2

                JSON
                
            

                {
    "count":3,
    "details":{
        "2021-08-31T10:10:00Z":{
            "www.example.com":[
                {
                    "flow":2329321827,
                    "pv":873,
                    "distribution":{
                        "location":"广东",
                        "isp":"电信"
                    }
                }
            ],
            "www.test.com":[
                {
                    "flow":3460533,
                    "pv":156,
                    "distribution":{
                        "location":"广东",
                        "isp":"电信"
                    }
                }
            ]
        },
        "2021-08-31T10:05:00Z":{
            "www.example.com":[
                {
                    "flow":4975040172,
                    "pv":2570,
                    "distribution":{
                        "location":"广东",
                        "isp":"电信"
                    }
                }
            ],
            "www.test.com":[
                {
                    "flow":50829586,
                    "pv":1400,
                    "distribution":{
                        "location":"广东",
                        "isp":"电信"
                    }
                }
            ]
        },
        "2021-08-31T10:00:00Z":{
            "www.example.com":[
                {
                    "flow":11245259964,
                    "pv":3735,
                    "distribution":{
                        "location":"广东",
                        "isp":"电信"
                    }
                }
            ],
            "www.test.com":[
                {
                    "flow":37659121,
                    "pv":1119,
                    "distribution":{
                        "location":"广东",
                        "isp":"电信"
                    }
                }
            ]
        }
    }
}
            

cdn错误码分类统计查询

metric：error

响应体扩展字段：

参数	类型	说明
counters	list<KvCounter>	错误状态码类型及对应计数

KvCounter内容

参数	类型	说明
code	String	错误码
counters	list<DetailData>	错误类型及计数

DetailData 内容

参数	类型	说明
name	String	错误类型
count	Long	统计计数

请求示例

                JSON
                
            

                POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com

{
    "metric": "error",
    "startTime": "2019-03-20T06:00:00Z",
    "endTime": "2019-03-20T06:10:00Z",
    "period": 300,
    "key_type": 0,
    "key": [
        "cdaa.wonter.net"
    ],
    "groupBy": "key"
}
            

返回示例

                JSON
                
            

                HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN

{
    "status": "ok",
    "details": [
        {
            "timestamp": "2019-03-20T06:00:00Z",
            "key": "cdaa.wonter.net",
            "counters": [
                {
                    "code": 499,
                    "counters": [
                        {
                            "name": "未知",
                            "count": 27
                        }
                    ]
                }
            ]
        },
        {
            "timestamp": "2019-03-20T06:05:00Z",
            "key": "cdaa.wonter.net",
            "counters": [
                {
                    "code": 499,
                    "counters": [
                        {
                            "name": "未知",
                            "count": 18
                        }
                    ]
                }
            ]
        }
    ],
    "count": 2
}
            

错误类型分类

名称	备注
源站错误	4xx和5xx
源站错误，CDN已缓存	4xx和5xx
CDN错误	4xx和5xx
未命中499	499
命中499	499
CDN连接源站读超时	5xx
CDN连接源站失败	5xx
CDN连接源站失败(SSL)	5xx
CDN解析源站域名失败	5xx
CDN与源站交互失败	5xx
未知	未匹配到的错误类型

统计接口（旧版）

xcdn统计

内容分发网络 CDN

内容分发网络 CDN

统计接口（新版）

默认请求体（Request Body）

默认响应体（Response Body）

平均速率相关接口

查询平均速率

客户端访问分布查询平均速率

pv/qps相关接口

pv/qps查询

pv/qps https协议查询

回源pv/qps查询

查询pv/qps(分客户端访问分布)

uv查询

流量带宽接口

查询流量、带宽

查询流量、带宽（静态）

查询流量、带宽（动态）

查询流量、带宽（分协议）

查询流量、带宽（分客户端访问分布）

查询月95峰值带宽

查询回源流量、回源带宽

命中率类接口

字节命中率查询

请求命中率查询

状态码类接口

状态码统计查询

回源状态码查询

状态码统计查询（分客户端访问分布）

TopN查询接口

TopN urls

TopN referers

TopN domains

TopN clientIP

查询 IPV6 数据接口

cdn错误码分类统计查询