更新时间:2022-09-28 GMT+08:00
分享

查询TOP100 URL明细

功能介绍

  • 查询TOP100 URL明细。

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

  • 查询跨度不能超过31天。

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

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

  • 流量类指标单位统一为Byte(字节)、请求数类指标单位统一为次数。用于查询指定域名、指定统计指标的明细数据。

  • 单租户调用频率:5次/s。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1.0/cdn/statistics/top-url

表1 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

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

start_time

Long

查询起始时间戳(单位:毫秒)。该时间戳的取值在转化为日期格式后须满足以下格式:XXXX-XX-XX 00:00:00

end_time

Long

查询结束时间戳(单位:毫秒)。该时间戳的取值在转化为日期格式后须满足以下格式:XXXX-XX-XX 00:00:00

domain_name

String

域名列表,多个域名以逗号(半角)分隔,如:www.test1.com,www.test2.com ,ALL表示查询名下全部域名。

service_area

String

mainland_china(中国大陆),outside_mainland_china(中国大陆境外),默认为mainland_china。

stat_type

String

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

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

service_area

String

服务区域。

top_url_summary

Array of TopUrlSummary objects

详情数据对象。

表3 TopUrlSummary

参数

参数类型

描述

url

String

URL名称。

value

Long

对应查询类型的值。(流量单位:Byte)

start_time

Long

查询起始时间戳。

end_time

Long

查询结束时间戳

stat_type

String

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

请求示例

响应示例

状态码: 200

OK

{
  "top_url_summary" : [ {
    "url" : "www.xxx.com",
    "value" : 888,
    "start_time" : 1511366400000,
    "end_time" : 1511452799640,
    "stat_type" : "req_num"
  }, {
    "url" : "www.yyy.com",
    "value" : 666,
    "start_time" : 1511366400000,
    "end_time" : 1511452799640,
    "stat_type" : "req_num"
  } ],
  "service_area" : "mainland"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

分享:

    相关文档

    相关产品

close