You need to enable JavaScript to run this app.
导航
TrafficRoute DNS 套件
  • 文档首页
    • /TrafficRoute DNS 套件/私网解析 PrivateZone/API 参考/请求量统计接口/QueryZoneStatistics-获取主域名的请求量实时统计
QueryZoneStatistics-获取主域名的请求量实时统计
最近更新时间：2024.08.12 11:01:03首次发布时间：2023.02.08 13:13:46
我的收藏

获取一个主域名在指定时间范围内的请求量实时统计。

私网解析 PrivateZone 会以一小时作为数据采样间隔。例如，您将时间范围设置为从 1671285600 到 1671289200，则私网解析 PrivateZone 会返回 1671285600 时刻和 1671289200 时刻的请求量实时统计。

请求说明

  • 请求方式：GET
  • 请求地址：https://open.volcengineapi.com?Action=QueryZoneStatistics?Version=2022-06-01

请求参数

除了以下参数，您还需要 对请求进行鉴权。

Query

名称类型是否必选示例值描述
ActionString是QueryZoneStatistics表示 API 的名称。该参数的取值是 QueryZoneStatistics。
VersionString是2022-06-01表示 API 的版本。该参数的取值是 2022-06-01。
ZIDInteger是1234标识主域名的唯一 ID。您可以通过以下 API 获取：
StartInteger否1639548697开始时间。格式为 Unix 时间戳，单位为秒。例如 1639548697。
如果您不设置该参数，开始时间默认为三天前。
EndInteger否1639548697结束时间。格式为 Unix 时间戳，单位为秒。例如 1639548697。
如果您不设置该参数，结束时间默认为当前时间。

返回参数

ResponseMetadata 对象

名称
类型
描述
RequestId
String
标识本次请求的 ID。
Action
String
Action 查询参数的值。
Version
String
API 版本。
Service
String
服务类型。
Region
String
服务所在地域。

Result 对象

名称
类型
描述
TimeStamp
Integer
统计数据的 Unix 时间戳（秒）。
Total
Integer
主域名的总访问数。

示例

请求示例

GET https://open.volcengineapi.com/?Action=QueryZoneStatistics&Version=2022-06-01&ZID=1340&StartTime=1671285600&EndTime=1671289200

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20221220214036010208037080167C97C2",
        "Action": "QueryZoneStatistics",
        "Version": "2022-06-01",
        "Service": "private_zone",
        "Region": "cn"
    },
    "Result": [
        {
            "Timestamp": 1671285600,
            "Total": 479
        },
        {
            "Timestamp": 1671289200,
            "Total": 504
        }
    ]
}

错误码

您可访问公共错误码，获取详细信息。