文档首页/ 内容分发网络 CDN/ API参考/ API/ 统计分析/ 按区域运营商查询域名统计数据
更新时间:2024-07-19 GMT+08:00
分享

按区域运营商查询域名统计数据

功能介绍

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

  • 支持多指标同时查询,不超过5个。

  • 最多同时指定20个域名。

  • 起始时间和结束时间需要同时指定,左闭右开,毫秒级时间戳,且时间点必须为与查询时间间隔参数匹配的整时刻点。比如查询时间间隔为5分钟时,起始时间和结束时间必须为5分钟整时刻点,如:0分、5分、10分、15分等,如果时间点与时间间隔不匹配,返回数据可能与预期不一致。统一用开始时间表示一个时间段,如:2019-01-24 20:15:00 表示取 [20:15:00, 20:20:00)的统计数据,且左闭右开。

  • action取值:location_detail,location_summary

  • 流量类指标单位统一为Byte(字节)、带宽类指标单位统一为bit/s(比特/秒)、请求数类和状态码类指标单位统一为次数。用于查询指定域名、指定统计指标的区域运营商明细数据。

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

调用方法

请参见如何调用API

URI

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

表1 Query参数

参数

是否必选

参数类型

描述

action

String

  • 动作名称,可选location_summary、location_detail。

  • location_summary:查询汇总数据

  • location_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)

interval

Long

  • 查询时间间隔,单位:秒,取值说明:

  • 300(5分钟):最大查询跨度2天

  • 3600(1小时):最大查询跨度7天

  • 86400(1天):最大查询跨度31天

  • 如果不传,默认取对应时间跨度的最小间隔。

country

String

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

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

  • 访问top_url数据时不能填写

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

province

String

省份编码,当country为cn(中国)时有效,多个以英文逗号分隔,all表示全部,取值见附录

isp

String

运营商编码,多个以英文逗号分隔,all表示全部,取值见附录

group_by

String

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

enterprise_project_id

String

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

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

group_by

String

数据分组方式

result

Map<String,Object>

按指定的分组方式组织的数据

状态码: default

表3 响应Body参数

参数

参数类型

描述

error

ErrMsg object

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

表4 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

  • 不分组域名详情数据

    GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-location-stats?action=location_summary&start_time=1667030400000&end_time=1667116800000&domain_name=www.test1.com&stat_type=flux&interval=300&country=cn&province=sichuan&isp=dianxin&enterprise_project_id=all
  • 按域名分组域名详情数据

    GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-location-stats?action=location_summary&start_time=1667030400000&end_time=1667116800000&domain_name=www.test1.com&stat_type=flux&interval=300&country=cn&province=sichuan&isp=dianxin&group_by=domain&enterprise_project_id=all

响应示例

状态码: 200

正常响应

  • 不分组域名详情数据

    {
      "result" : {
        "flux" : [ 0, 1, 2 ]
      }
    }
  • 按域名分组域名详情数据

    {
      "group_by" : "domain",
      "result" : {
        "www.test1.com" : {
          "flux" : [ 0, 1, 2 ]
        },
        "www.test2.com" : {
          "flux" : [ 0, 1, 2 ]
        }
      }
    }
  • 按国家分组域名详情数据

    {
      "group_by" : "country",
      "result" : {
        "cn" : {
          "flux" : [ 0, 1, 2 ]
        },
        "jp" : {
          "flux" : [ 0, 1, 2 ]
        }
      }
    }
  • 按省份分组域名详情数据

    {
      "group_by" : "province",
      "result" : {
        "sichuan" : {
          "flux" : [ 0, 1, 2 ]
        },
        "hubei" : {
          "flux" : [ 0, 1, 2 ]
        }
      }
    }
  • 按运营商分组域名详情数据

    {
      "group_by" : "isp",
      "result" : {
        "dianxin" : {
          "flux" : [ 0, 1, 2 ]
        },
        "liantong" : {
          "flux" : [ 0, 1, 2 ]
        }
      }
    }
  • 按域名、国家分组域名详情数据

    {
      "group_by" : "domain,country",
      "result" : {
        "www.test1.com" : {
          "cn" : {
            "flux" : [ 0, 1, 2 ]
          },
          "gb" : {
            "flux" : [ 0, 1, 2 ]
          }
        },
        "www.test2.com" : {
          "cn" : {
            "flux" : [ 0, 1, 2 ]
          },
          "gb" : {
            "flux" : [ 0, 1, 2 ]
          }
        }
      }
    }
  • 按域名、运营商分组域名详情数据

    {
      "group_by" : "domain,isp",
      "result" : {
        "www.test1.com" : {
          "dianxin" : {
            "req_num" : [ 0, 1, 2 ]
          }
        },
        "www.test2.com" : {
          "dianxin" : {
            "req_num" : [ 0, 1, 2 ]
          }
        }
      }
    }
  • 不分组域名总体数据

    {
      "result" : {
        "flux" : 1024
      }
    }
  • 按域名分组域名总体数据

    {
      "group_by" : "domain",
      "result" : {
        "www.test1.com" : {
          "flux" : 1024
        },
        "www.test2.com" : {
          "flux" : 1024
        }
      }
    }
  • 按国家分组域名总体数据

    {
      "group_by" : "country",
      "result" : {
        "cn" : {
          "flux" : 1024
        },
        "jp" : {
          "flux" : 1024
        }
      }
    }

状态码

状态码

描述

200

正常响应

default

异常响应

错误码

请参见错误码

相关文档