文档首页/ 内容分发网络 CDN/ API参考/ API/ 统计分析/ CDN查询域名的国家统计数据 - ShowDomainCountryStat
更新时间:2025-11-27 GMT+08:00
分享

CDN查询域名的国家统计数据 - ShowDomainCountryStat

功能介绍

CDN查询域名的国家统计数据

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

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

表1 Query参数

参数

是否必选

参数类型

描述

action

String

  • 动作名称,可选summary、detail。

  • summary:查询汇总数据

  • detail:查询数据详情。

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

  • 网络资源消耗

    • bw(带宽)

    • flux(流量)

  • 访问情况

    • req_num(请求总数)

  • HTTP状态码(组合指标)

    • http_code_2xx(状态码汇总2xx)

    • http_code_3xx(状态码汇总3xx)

    • http_code_4xx(状态码汇总4xx)

    • http_code_5xx(状态码汇总5xx)

    • status_code_2xx(状态码详情2xx)

    • status_code_3xx(状态码详情3xx)

    • status_code_4xx(状态码详情4xx)

    • status_code_5xx(状态码详情5xx)

country

String

  • 国家&地区编码,多个以英文逗号分隔,all表示全部,取值见附录

  • 访问运营商统计数据时不能填写

  • 访问top_url数据时不能填写

  • 访问区域情况数据时只能填写cn(中国)

group_by

String

数据分组方式,多个以英文逗号分隔,可选domain、country、province、isp,默认不分组

user_domain_id

String

域名所属用户的domain_id。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

action

String

参数解释:

规则行为

约束限制:

不涉及

start_time

Long

查询起始时间,相对于UTC 1970-01-01到当前时间相隔的毫秒数。

end_time

Long

查询结束时间,相对于UTC 1970-01-01到当前时间相隔的毫秒数。

stat_type

String

参数类型支持:flux(流量),req_num(请求总数)。

result

Array

详情数据对象。

状态码:default

表3 响应Body参数

参数

参数类型

描述

error

ErrMsg object

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

表4 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

响应示例

状态码

状态码

描述

200

正常响应

default

异常响应

错误码

请参见错误码

相关文档