所有文档

没有找到结果，请重新输入

内容分发网络 CDN

统计接口（新版）

更新时间：2025-08-21

这部分接口在文档统计接口中有详细说明。

api.QueryCondition结构包含了最基本的查询条件，如下：

参数	类型	说明
StartTime	string	查询的时间范围起始值，默认为endTime前推24小时。格式为UTC时间字符串，如："2019-09-01T07:12:00Z"。
EndTime	string	查询的时间范围结束值，默认为当前时间。时间跨度最长90天，时间格式和StartTime一样。
Period	int	查询结果的粒度，单位秒，可选值为60,300,3600,86400；默认为300，uv 默认3600（选60s的时间粒度时建议StartTime和EndTime区间跨度建议选择0.5到1h，否则可能会因为数据量太大无法正常返回）
KeyType	int	标识key的内容，0=>域名，1=>用户id，2=>tag，默认0。
Key	[]string	域名、用户Id或Tag。
GroupBy	string	返回结果聚合粒度，key => 根据key聚合，每个key的每个时间段都对应一组数据；空 => 返回整体结果，最后的key是`total`。

metric表示查询的统计数据类型，如下，接口具体返回结果的格式在对应的函数中可以看到。

metric	函数	接口类型	额外参数
avg_speed	GetAvgSpeed	查询平均速率	无。
avg_speed_region	GetAvgSpeedByRegion	客户端访问分布查询平均速率	prov和isp。prov是查询的省份全拼，默认为空，查询全国数据。isp是查询的运营商代码，默认为空，查询所有运营商数据。
pv	GetPv	pv/qps查询	level，查询边缘节点或者中心节点pv。可填写"all"或"edge"或者"internal"，默认为“all”。
pv_src	GetSrcPv	回源pv/qps查询	无。
pv_region	GetPvByRegion	查询pv/qps(分客户端访问分布)	prov和isp。prov是查询的省份全拼，默认为空，查询全国数据。isp是查询的运营商代码，默认为空，查询所有运营商数据。
uv	GetUv	uv查询	无。
flow	GetFlow	查询流量、带宽	level，查询边缘节点或者中心节点带宽。可填写"all"或"edge"或"internal"，默认为"all"。
flow_protocol	GetFlowByProtocol	查询流量、带宽(分协议)	protocol，查询http或https的流量、带宽, 取值"http", "https"或者 "all"，默认"all"。
flow_region	GetFlowByRegion	查询流量、带宽（分客户端访问分布）	prov和isp。prov是查询的省份全拼，默认为空，查询全国数据。isp是查询的运营商代码，默认为空，查询所有运营商数据。
src_flow	GetSrcFlow	查询回源流量、回源带宽	无。
real_hit	GetRealHit	字节命中率查询	无。
pv_hit	GetPvHit	请求命中率查询	无。
httpcode	GetHttpCode	状态码统计查询	无。
src_httpcode	GetSrcHttpCode	回源状态码查询	无。
httpcode_region	GetHttpCodeByRegion	状态码统计查询（分客户端访问分布）	prov和isp。prov是查询的省份全拼，默认为空，查询全国数据。isp是查询的运营商代码，默认为空，查询所有运营商数据。
top_urls	GetTopNUrls	TopN urls	extra，查询指定http状态码的记录，默认值： ""。
top_referers	GetTopNReferers	TopN referers	extra，查询指定http状态码的记录，默认值： ""。
top_domains	GetTopNDomains	TopN domains	extra，查询指定http状态码的记录，默认值： ""。
error	GetError	cdn错误码分类统计查询	无。

缓存管理接口