文档首页/ 内容分发网络 CDN/ API参考/ 历史API/ 统计分析/ 批量查询域名的区域、运营商统计明细-按域名单独返回
更新时间:2024-05-08 GMT+08:00

批量查询域名的区域、运营商统计明细-按域名单独返回

功能介绍

  • 支持查询90天内的数据。
  • 查询跨度是7天。
  • 最多同时指定100个域名。
  • 起始时间和结束时间,左闭右开,需要同时指定。
  • 开始时间、结束时间必须传毫秒级时间戳,且必须为5分钟整时刻点,如:0分、5分、10分、15分等,如果传的不是5分钟时刻点,返回数据可能与预期不一致。
  • 统一用开始时间表示一个时间段,如:2019-01-24 20:15:00 表示取 [20:15:00, 20:20:00)的统计数据,且左闭右开。
  • 流量类指标单位统一为Byte(字节)、带宽类指标单位统一为bit/s(比特/秒)、请求数类指标单位统一为次数。
  • 用于查询指定域名、指定统计指标的明细数据。
  • 如果传的是多个域名,则每个域名的数据分开返回。
  • 支持按区域、运营商维度查询统计数据, 回源指标除外。
  • 支持同时查询多个指标,不超过10个。
  • 域名为海外加速场景不适用。

URI

GET /v1.0/cdn/statistics/domain-item-location-details

表1 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

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

start_time

Long

查询开始时间戳,必须设为5分钟整时刻点

end_time

Long

查询结束时间戳,必须设为5分钟整时刻点

domain_name

String

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

stat_type

String

指标类型列表 网络资源消耗:bw(带宽),flux(流量),ipv6_bw(ipv6带宽),ipv6_flux(ipv6流量), https_bw(https带宽),https_flux(https流量) 访问情况:req_num(请求总数),hit_num(请求命中次数),req_time(请求时长) HTTP状态码(组合指标):status_code_2xx(状态码2xx),status_code_3xx(状态码3xx),status_code_4xx(状态码4xx),status_code_5xx(状态码5xx)

region

String

区域列表,以逗号分隔,all表示查询全部区域

isp

String

运营商列表,以逗号分隔,all表示查询全部运营商

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

domain_item_location_details

DomainItemLocationDetails object

域名详情数据列表

表4 DomainItemLocationDetails

参数

参数类型

描述

start_time

Long

数据起始时间戳,可能与请求时间不一致

end_time

Long

数据结束时间戳,可能与请求时间不一致

stat_type

String

指标类型

domains

Array of DomainRegion objects

域名详情数据列表

表5 DomainRegion

参数

参数类型

描述

domain_name

String

域名

region_isp_details

Array of Map<String,Object> objects

指标统计数据列表,如果该时间段内无值,则为空数组[]

请求示例

GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-item-location-details?start_time=1515996000000&end_time=1515999600000&domain_name=www.test1.com,www.test2.com&stat_type=flux&region=sichuan,guizhou&isp=dianxin

响应示例

状态码: 200

OK

{
  "domain_item_location_details" : {
    "start_time" : 1515996000000,
    "end_time" : 1515999600000,
    "stat_type" : "flux",
    "domains" : [ {
      "domain_name" : "www.test1.com",
      "region_isp_details" : [ {
        "region" : "sichuan",
        "isp" : "dianxin",
        "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
      }, {
        "region" : "guizhou",
        "isp" : "dianxin",
        "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
      } ]
    }, {
      "domain_name" : "www.test2.com",
      "region_isp_details" : [ {
        "region" : "sichuan",
        "isp" : "dianxin",
        "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
      }, {
        "region" : "guizhou",
        "isp" : "dianxin",
        "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
      } ]
    } ]
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码