You need to enable JavaScript to run this app.
导航
TrafficRoute DNS 套件
  • 文档首页
    • /
  • TrafficRoute DNS 套件

获取分组的请求量统计

最近更新时间：2024.02.02 10:14:51

首次发布时间：2024.02.02 10:14:51

我的收藏

API 说明

API 名称：ListZoneStatisticsByGroup。
API 域名：open.volcengineapi.com。
API 描述：为指定的主域名获取按子域名、解析状态、解析类型或 VPC ID 分组的 DNS 查询请求量统计列表。

请求方法

GET

请求参数

除了以下参数，您还需要在请求头中指定 请求方法 并包含 签名参数。

参数名称
数据类型参数类型是否必选参数说明
ActionString查询参数是API 的名称。该参数的取值是 ListZoneStatisticsByGroup。
VersionString查询参数是表示 API 的版本。该参数的取值是 2022-06-01。
ZIDInteger查询参数是标识主域名的唯一 ID。您可以通过以下 API 获取：
VpcIdString查询参数否与主域名关联的 VPC 的 ID，例如 vpc-xxxxx。
NameString查询参数否子域名，例如 abc.example.com。
GroupString查询参数是分组的标准。
  • 1：子域名。
  • 2：解析状态。
  • 3：解析记录类型。
  • 5：关联的 VPC ID。
PageNumberInteger查询参数否页码。页数由获取的主域名总数和 PageSize 确定。
默认为 1。

PageSize

Integer

查询参数

否

每页包含的主域名的数量。
默认为 10。
返回结果会将获取的主域名进行分页显示。页数由获取的主域名总数和 PageSize 确定。

SearchModeString查询参数否查询模式，用于 Name 参数。包括以下模式：
  • LIKE（默认）：模糊查询。例如 %example%。
  • EXACT：精确查询。例如 example。

StartInteger查询参数否开始时间。格式为 Unix 时间戳，单位为秒。例如 1639548697。
如果您不设置该参数，开始时间默认为三天前。
EndInteger查询参数否结束时间。格式为 Unix 时间戳，单位为秒。例如 1639548697。
如果您不设置该参数，结束时间默认为当前时间。
SearchOrderString查询参数否结果的排列顺序。
  • asc：升序排列。
  • desc（默认）：降序排列。
OrderKeyString查询参数否结果的排序键。
  • GroupName：分组名称。
  • Count（默认）：请求量。

响应正文

参数名称
数据类型
参数说明
ResponseMetadata
Object
响应的元数据。
Result
JSON Object
返回结果。

示例

请求示例

GET https://open.volcengineapi.com/?Action=ListZoneStatisticsByGroup&Version=2022-06-01&ZID=89810&Group=1

响应示例

{
    "ResponseMetadata": {
        "RequestId": "202401232023526B32439380D037E5F671",
        "Action": "ListZoneStatisticsByGroup",
        "Version": "2022-06-01",
        "Service": "private_zone",
        "Region": "cn"
    },
    "Result": {
        "PageNumber": 1,
        "PageSize": 10,
        "Total": 4651,
        "Data": [
            {
                "GroupName": "001.example.com.",
                "Count": 56257688,
                "Percent": 0.24396246997026416
            },
            {
                "GroupName": "002.example.com.",
                "Count": 37679707,
                "Percent": 0.1633987231660827
            },
            {
                "GroupName": "003.example.com.",
                "Count": 24965099,
                "Percent": 0.10826159822088977
            },
            {
                "GroupName": "004.example.com.",
                "Count": 15811720,
                "Percent": 0.06856780651345333
            },
            {
                "GroupName": "005.example.com.",
                "Count": 12653122,
                "Percent": 0.05487048980674586
            },
            {
                "GroupName": "006.example.com.",
                "Count": 9855930,
                "Percent": 0.04274041668143251
            },
            {
                "GroupName": "007.example.com.",
                "Count": 6107171,
                "Percent": 0.026483856245403618
            },
            {
                "GroupName": "008.example.com.",
                "Count": 4882023,
                "Percent": 0.021170980036215474
            },
            {
                "GroupName": "009.example.com.",
                "Count": 2583189,
                "Percent": 0.011202045289170374
            },
            {
                "GroupName": "010.example.com.",
                "Count": 2072263,
                "Percent": 0.008986405554170471
            }
        ]
    }
}