文档首页/ 内容分发网络 CDN/ API参考/ API/ 统计分析/ 按域名维度查询每天客户端访问详情统计
更新时间：2025-09-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

按域名维度查询每天客户端访问详情统计

功能介绍

  • 按域名维度查询每天客户端访问详情统计。

  • 支持查询90天内的数据。

  • ip_num查询跨度只支持1天,uv查询跨度只支持5分钟。

  • 起始时间和结束时间，左闭右开，需要同时指定。如查询2022-07-12 00:00:00 到 2022-07-13 00:00:00 的数据，表示取 [2022-07-12 00:00:00, 2022-07-13 00:00:00)的统计数据。

  • ip_num开始时间、结束时间必须传毫秒级时间戳，必须为凌晨0点整时刻点，如果传的不是凌晨0点整时刻点，返回数据可能与预期不一致。

  • uv必须为5分钟整时刻点，如：0分、5分、10分、15分等，如果传的不是5分钟时刻点，返回数据可能与预期不一致

调用方法

请参见如何调用API。

URI

GET /v1.0/cdn/statistics/domain-client-stats

表1 Query参数

参数

是否必选

参数类型

描述

start_time

是

Long

  • 查询起始时间戳，需与结束时间戳同时指定，左闭右开，设置方式如下：

  • interval为300时，start_time设置为整5分钟时刻点，如：1631240100000(对应2021-09-10 10:15:00)

  • interval为3600时，start_time设置为整小时时刻点，如：1631239200000(对应2021-09-10 10:00:00)

  • interval为86400时，start_time设置为东8区零点时刻点，如：1631203200000(对应2021-09-10 00:00:00)

end_time

是

Long

  • 查询结束时间戳，需与开始时间戳同时指定，左闭右开，设置方式如下：

  • interval为300时，end_time设置为整5分钟时刻点，如：1631243700000(对应2021-09-10 11:15:00)

  • interval为3600时，end_time设置为整小时时刻点，如：1631325600000(对应2021-09-11 10:00:00)

  • interval为86400时，end_time设置为东8区零点时刻点，如：1631376000000(对应2021-09-12 00:00:00)

domain_name

是

String

域名列表，多个域名以逗号（半角）分隔，如：www.test1.com,www.test2.com

all表示查询名下全部域名。如果域名在查询时间段内无数据，结果将不返回该域名的信息。

stat_type

是

String

  • 客户端访问资源指标类别：

  • ip_num (去重后ip访问数量)

  • uv(五分钟内的访问独立IP数，一个独立ip记一次。)

service_area

否

String

服务区域：mainland_china(大陆)，outside_mainland_china(海外)，默认为mainland_china

enterprise_project_id

否

String

当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

service_area

String

区域

result

Array of Map<String,Object> objects

按域名维每天客户端访问详情统计

状态码：default

表3 响应Body参数

参数

参数类型

描述

error

ErrMsg object

用于返回具体的错误码和错误消息
表4 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

查询客户端访问详情

GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-client-stats?&start_time=1577808000000&end_time=1577894400000&domain_name=www.test1.com&stat_type=ip_num

响应示例

无

状态码

状态码

描述

200

正常响应

default

异常响应

错误码

请参见错误码。

父主题： 统计分析

相关文档