为指定的主域名、转发规则或 VPC 获取 DNS 查询请求量实时统计数据。统计数据按流量类型分类，并按解析状态和解析类型分组。
私网解析 PrivateZone 会以一小时作为数据采样间隔。例如，您将时间范围设置为从 1671285600 到 1671289200，则私网解析 PrivateZone 会返回 1671285600 时刻和 1671289200 时刻的请求量实时统计。
除了以下参数，您还需要 对请求进行鉴权。
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | QueryZoneStatisticsByGroup | API 的名称。该参数的取值是 QueryZoneStatisticsByGroup。 |
| Version | String | 是 | 2022-06-01 | 表示 API 的版本。该参数的取值是 2022-06-01。 |
| ZID | Integer | 否 | 1234 | 主域名的 ID。 如果 TraffcType 参数被设置为 Authoritative，您必须设置 ZID。您可以通过 API 获取 ZID 的值：
|
| RuleID | Integer | 否 | 1234 | 转发规则的 ID。如果 TrafficType 参数被设置为 OUTBOUND，您必须至少设置 RuleID 和 VpcID 中的一个参数。您可以通过以下 API 获取转发规则的 ID： |
| VpcTrns.N | String | 否 | VpcTrns.1="trn:vpc:cn-beijing:12345678:vpc/vpc-3reow******hxad79k" | 域名或转发规则所关联的一个或多个 VPC 的 TRN。格式为 VpcTrns.N="trn:vpc:region:accountId:vpc/vpcId"。N 表示 VpcTrns 的序号。N 必须按照从小到大的顺序连续排序。多个 VpcTrns 之间使用 & 分隔。单次调用 API 时最多传入 100 个 VpcTrns。如果您需要验证子用户是否对域名关联的 VPC 所在的项目有操作权限，您需要传入该参数。 |
| RuleTrn | String | 否 | "trn:private_zone::21******4::rule/rule-1234" | 转发规则的 TRN。格式为 "trn:private_zone::accountId::rule/ep-ruleId"。如果您需要验证子用户是否对转发规则所在的项目有操作权限，您需要传入该参数。 |
| TrafficType | String | 否 | Authoritative | 流量类型。默认为全局流量。
|
| VpcID | String | 否 | vpc-xxxxx | 与主域名或转发规则关联的 VPC 的 ID。VpcID 参数是否可选取决于 TraffcType 参数：
|
| Region | String | 否 | cn-beijing | VPC 的地域。如果您设置了 VpcID，那么您必须设置 Region 参数。 |
| Name | String | 否 | abc.example.com | 子域名。 |
| Group | String | 否 | 0 | 分组的标准。
|
| Start | Integer | 否 | 1639548697 | 开始时间。格式为 Unix 时间戳，单位为秒。例如 1639548697。如果您不设置该参数，开始时间默认为三天前。 |
| End | Integer | 否 | 1639548697 | 结束时间。格式为 Unix 时间戳，单位为秒。例如 1639548697。如果您不设置该参数，结束时间默认为当前时间。 |
名称 | 类型 | 描述 |
|---|---|---|
RequestId | String | 标识本次请求的 ID。 |
Action | String | Action 查询参数的值。 |
Version | String | API 版本。 |
Service | String | 服务类型。 |
Region | String | 服务所在地域。 |
名称 | 类型 | 描述 |
|---|---|---|
Data | JSON Object | 统计数据。 |
GET https://open.volcengineapi.com/?Action=QueryZoneStatisticsByGroup&Version=2022-06-01&ZID=89810&Group=2
{ "ResponseMetadata": { "RequestId": "2024012410510949444C5D465C586CA280", "Action": "QueryZoneStatisticsByGroup", "Version": "2022-06-01", "Service": "private_zone", "Region": "cn" }, "Result": [ { "GroupName": "NOERROR", "Times": [ { "Timestamp": 1705802400, "GroupName": "NOERROR", "Count": 447616 }, { "Timestamp": 1705806000, "GroupName": "NOERROR", "Count": 3522252 }, { "Timestamp": 1705809600, "GroupName": "NOERROR", "Count": 3559659 }, { "Timestamp": 1705813200, "GroupName": "NOERROR", "Count": 3590555 }, { "Timestamp": 1705816800, "GroupName": "NOERROR", "Count": 3220973 }, { "Timestamp": 1705820400, "GroupName": "NOERROR", "Count": 3131774 }, { "Timestamp": 1705824000, "GroupName": "NOERROR", "Count": 3155156 }, { "Timestamp": 1705827600, "GroupName": "NOERROR", "Count": 3162278 }, { "Timestamp": 1705831200, "GroupName": "NOERROR", "Count": 3161601 }, { "Timestamp": 1705834800, "GroupName": "NOERROR", "Count": 3152487 }, { "Timestamp": 1705838400, "GroupName": "NOERROR", "Count": 3161841 }, { "Timestamp": 1705842000, "GroupName": "NOERROR", "Count": 3173351 }, { "Timestamp": 1705845600, "GroupName": "NOERROR", "Count": 3211158 }, { "Timestamp": 1705849200, "GroupName": "NOERROR", "Count": 3133563 }, { "Timestamp": 1705852800, "GroupName": "NOERROR", "Count": 3000154 }, { "Timestamp": 1705856400, "GroupName": "NOERROR", "Count": 2841843 }, { "Timestamp": 1705860000, "GroupName": "NOERROR", "Count": 2763515 }, { "Timestamp": 1705863600, "GroupName": "NOERROR", "Count": 2723584 }, { "Timestamp": 1705867200, "GroupName": "NOERROR", "Count": 2693981 }, { "Timestamp": 1705870800, "GroupName": "NOERROR", "Count": 2792343 }, { "Timestamp": 1705874400, "GroupName": "NOERROR", "Count": 2891469 }, { "Timestamp": 1705878000, "GroupName": "NOERROR", "Count": 3040161 }, { "Timestamp": 1705881600, "GroupName": "NOERROR", "Count": 3191056 }, { "Timestamp": 1705885200, "GroupName": "NOERROR", "Count": 3331832 }, { "Timestamp": 1705888800, "GroupName": "NOERROR", "Count": 3558627 }, { "Timestamp": 1705892400, "GroupName": "NOERROR", "Count": 3458984 }, { "Timestamp": 1705896000, "GroupName": "NOERROR", "Count": 3567207 }, { "Timestamp": 1705899600, "GroupName": "NOERROR", "Count": 3674541 }, { "Timestamp": 1705903200, "GroupName": "NOERROR", "Count": 3385693 }, { "Timestamp": 1705906800, "GroupName": "NOERROR", "Count": 3196575 }, { "Timestamp": 1705910400, "GroupName": "NOERROR", "Count": 3250259 }, { "Timestamp": 1705914000, "GroupName": "NOERROR", "Count": 3164745 }, { "Timestamp": 1705917600, "GroupName": "NOERROR", "Count": 3206368 }, { "Timestamp": 1705921200, "GroupName": "NOERROR", "Count": 3294777 }, { "Timestamp": 1705924800, "GroupName": "NOERROR", "Count": 3224011 }, { "Timestamp": 1705928400, "GroupName": "NOERROR", "Count": 3181990 }, { "Timestamp": 1705932000, "GroupName": "NOERROR", "Count": 3240571 }, { "Timestamp": 1705935600, "GroupName": "NOERROR", "Count": 3208174 }, { "Timestamp": 1705939200, "GroupName": "NOERROR", "Count": 2979632 }, { "Timestamp": 1705942800, "GroupName": "NOERROR", "Count": 2686050 }, { "Timestamp": 1705946400, "GroupName": "NOERROR", "Count": 2722906 }, { "Timestamp": 1705950000, "GroupName": "NOERROR", "Count": 2606039 }, { "Timestamp": 1705953600, "GroupName": "NOERROR", "Count": 2621562 }, { "Timestamp": 1705957200, "GroupName": "NOERROR", "Count": 2774432 }, { "Timestamp": 1705960800, "GroupName": "NOERROR", "Count": 2941209 }, { "Timestamp": 1705964400, "GroupName": "NOERROR", "Count": 3123811 }, { "Timestamp": 1705968000, "GroupName": "NOERROR", "Count": 3276938 }, { "Timestamp": 1705971600, "GroupName": "NOERROR", "Count": 3435391 }, { "Timestamp": 1705975200, "GroupName": "NOERROR", "Count": 4253186 }, { "Timestamp": 1705978800, "GroupName": "NOERROR", "Count": 3478318 }, { "Timestamp": 1705982400, "GroupName": "NOERROR", "Count": 3028406 }, { "Timestamp": 1705986000, "GroupName": "NOERROR", "Count": 2996035 }, { "Timestamp": 1705989600, "GroupName": "NOERROR", "Count": 3073777 }, { "Timestamp": 1705993200, "GroupName": "NOERROR", "Count": 3198414 }, { "Timestamp": 1705996800, "GroupName": "NOERROR", "Count": 3184950 }, { "Timestamp": 1706000400, "GroupName": "NOERROR", "Count": 3263244 }, { "Timestamp": 1706004000, "GroupName": "NOERROR", "Count": 3233141 }, { "Timestamp": 1706007600, "GroupName": "NOERROR", "Count": 3298778 }, { "Timestamp": 1706011200, "GroupName": "NOERROR", "Count": 3323101 }, { "Timestamp": 1706014800, "GroupName": "NOERROR", "Count": 3236845 }, { "Timestamp": 1706018400, "GroupName": "NOERROR", "Count": 3184937 }, { "Timestamp": 1706022000, "GroupName": "NOERROR", "Count": 3127697 }, { "Timestamp": 1706025600, "GroupName": "NOERROR", "Count": 2932348 }, { "Timestamp": 1706029200, "GroupName": "NOERROR", "Count": 2810512 }, { "Timestamp": 1706032800, "GroupName": "NOERROR", "Count": 2681380 }, { "Timestamp": 1706036400, "GroupName": "NOERROR", "Count": 2666113 }, { "Timestamp": 1706040000, "GroupName": "NOERROR", "Count": 2650207 }, { "Timestamp": 1706043600, "GroupName": "NOERROR", "Count": 2664504 }, { "Timestamp": 1706047200, "GroupName": "NOERROR", "Count": 2807966 }, { "Timestamp": 1706050800, "GroupName": "NOERROR", "Count": 2977749 }, { "Timestamp": 1706054400, "GroupName": "NOERROR", "Count": 3116744 }, { "Timestamp": 1706058000, "GroupName": "NOERROR", "Count": 3215571 }, { "Timestamp": 1706061600, "GroupName": "NOERROR", "Count": 2927593 } ] }, { "GroupName": "NXDOMAIN", "Times": [ { "Timestamp": 1705802400, "GroupName": "NXDOMAIN", "Count": 9996 }, { "Timestamp": 1705806000, "GroupName": "NXDOMAIN", "Count": 74643 }, { "Timestamp": 1705809600, "GroupName": "NXDOMAIN", "Count": 75053 }, { "Timestamp": 1705813200, "GroupName": "NXDOMAIN", "Count": 74022 }, { "Timestamp": 1705816800, "GroupName": "NXDOMAIN", "Count": 74940 }, { "Timestamp": 1705820400, "GroupName": "NXDOMAIN", "Count": 74554 }, { "Timestamp": 1705824000, "GroupName": "NXDOMAIN", "Count": 75371 }, { "Timestamp": 1705827600, "GroupName": "NXDOMAIN", "Count": 74469 }, { "Timestamp": 1705831200, "GroupName": "NXDOMAIN", "Count": 74850 }, { "Timestamp": 1705834800, "GroupName": "NXDOMAIN", "Count": 78579 }, { "Timestamp": 1705838400, "GroupName": "NXDOMAIN", "Count": 77628 }, { "Timestamp": 1705842000, "GroupName": "NXDOMAIN", "Count": 76630 }, { "Timestamp": 1705845600, "GroupName": "NXDOMAIN", "Count": 75076 }, { "Timestamp": 1705849200, "GroupName": "NXDOMAIN", "Count": 70327 }, { "Timestamp": 1705852800, "GroupName": "NXDOMAIN", "Count": 70579 }, { "Timestamp": 1705856400, "GroupName": "NXDOMAIN", "Count": 71036 }, { "Timestamp": 1705860000, "GroupName": "NXDOMAIN", "Count": 77837 }, { "Timestamp": 1705863600, "GroupName": "NXDOMAIN", "Count": 90725 }, { "Timestamp": 1705867200, "GroupName": "NXDOMAIN", "Count": 88930 }, { "Timestamp": 1705870800, "GroupName": "NXDOMAIN", "Count": 94464 }, { "Timestamp": 1705874400, "GroupName": "NXDOMAIN", "Count": 96031 }, { "Timestamp": 1705878000, "GroupName": "NXDOMAIN", "Count": 81471 }, { "Timestamp": 1705881600, "GroupName": "NXDOMAIN", "Count": 73265 }, { "Timestamp": 1705885200, "GroupName": "NXDOMAIN", "Count": 71297 }, { "Timestamp": 1705888800, "GroupName": "NXDOMAIN", "Count": 71098 }, { "Timestamp": 1705892400, "GroupName": "NXDOMAIN", "Count": 71977 }, { "Timestamp": 1705896000, "GroupName": "NXDOMAIN", "Count": 71513 }, { "Timestamp": 1705899600, "GroupName": "NXDOMAIN", "Count": 70368 }, { "Timestamp": 1705903200, "GroupName": "NXDOMAIN", "Count": 71219 }, { "Timestamp": 1705906800, "GroupName": "NXDOMAIN", "Count": 72728 }, { "Timestamp": 1705910400, "GroupName": "NXDOMAIN", "Count": 77648 }, { "Timestamp": 1705914000, "GroupName": "NXDOMAIN", "Count": 79076 }, { "Timestamp": 1705917600, "GroupName": "NXDOMAIN", "Count": 79535 }, { "Timestamp": 1705921200, "GroupName": "NXDOMAIN", "Count": 78877 }, { "Timestamp": 1705924800, "GroupName": "NXDOMAIN", "Count": 80617 }, { "Timestamp": 1705928400, "GroupName": "NXDOMAIN", "Count": 79383 }, { "Timestamp": 1705932000, "GroupName": "NXDOMAIN", "Count": 80093 }, { "Timestamp": 1705935600, "GroupName": "NXDOMAIN", "Count": 78690 }, { "Timestamp": 1705939200, "GroupName": "NXDOMAIN", "Count": 74879 }, { "Timestamp": 1705942800, "GroupName": "NXDOMAIN", "Count": 73671 }, { "Timestamp": 1705946400, "GroupName": "NXDOMAIN", "Count": 76837 }, { "Timestamp": 1705950000, "GroupName": "NXDOMAIN", "Count": 75405 }, { "Timestamp": 1705953600, "GroupName": "NXDOMAIN", "Count": 74442 }, { "Timestamp": 1705957200, "GroupName": "NXDOMAIN", "Count": 73566 }, { "Timestamp": 1705960800, "GroupName": "NXDOMAIN", "Count": 74591 }, { "Timestamp": 1705964400, "GroupName": "NXDOMAIN", "Count": 73860 }, { "Timestamp": 1705968000, "GroupName": "NXDOMAIN", "Count": 76405 }, { "Timestamp": 1705971600, "GroupName": "NXDOMAIN", "Count": 76630 }, { "Timestamp": 1705975200, "GroupName": "NXDOMAIN", "Count": 77195 }, { "Timestamp": 1705978800, "GroupName": "NXDOMAIN", "Count": 78186 }, { "Timestamp": 1705982400, "GroupName": "NXDOMAIN", "Count": 90395 }, { "Timestamp": 1705986000, "GroupName": "NXDOMAIN", "Count": 86148 }, { "Timestamp": 1705989600, "GroupName": "NXDOMAIN", "Count": 83262 }, { "Timestamp": 1705993200, "GroupName": "NXDOMAIN", "Count": 82696 }, { "Timestamp": 1705996800, "GroupName": "NXDOMAIN", "Count": 84236 }, { "Timestamp": 1706000400, "GroupName": "NXDOMAIN", "Count": 85245 }, { "Timestamp": 1706004000, "GroupName": "NXDOMAIN", "Count": 85027 }, { "Timestamp": 1706007600, "GroupName": "NXDOMAIN", "Count": 84535 }, { "Timestamp": 1706011200, "GroupName": "NXDOMAIN", "Count": 85477 }, { "Timestamp": 1706014800, "GroupName": "NXDOMAIN", "Count": 84206 }, { "Timestamp": 1706018400, "GroupName": "NXDOMAIN", "Count": 84911 }, { "Timestamp": 1706022000, "GroupName": "NXDOMAIN", "Count": 85134 }, { "Timestamp": 1706025600, "GroupName": "NXDOMAIN", "Count": 94261 }, { "Timestamp": 1706029200, "GroupName": "NXDOMAIN", "Count": 89863 }, { "Timestamp": 1706032800, "GroupName": "NXDOMAIN", "Count": 99525 }, { "Timestamp": 1706036400, "GroupName": "NXDOMAIN", "Count": 108396 }, { "Timestamp": 1706040000, "GroupName": "NXDOMAIN", "Count": 101587 }, { "Timestamp": 1706043600, "GroupName": "NXDOMAIN", "Count": 106783 }, { "Timestamp": 1706047200, "GroupName": "NXDOMAIN", "Count": 111454 }, { "Timestamp": 1706050800, "GroupName": "NXDOMAIN", "Count": 105294 }, { "Timestamp": 1706054400, "GroupName": "NXDOMAIN", "Count": 98472 }, { "Timestamp": 1706058000, "GroupName": "NXDOMAIN", "Count": 94418 }, { "Timestamp": 1706061600, "GroupName": "NXDOMAIN", "Count": 79676 } ] } ] }
您可访问公共错误码，获取详细信息。