最近更新时间:2024.03.19 15:37:20
首次发布时间:2022.11.24 20:57:31
API 名称:ListZoneStatistics
。
API 域名:open.volcengineapi.com
。
API 描述:对指定的每个主域名统计解析请求数。统计的解析请求数包括主域名以及所有子域名的解析请求数。 对于最近一小时内的解析请求数的统计可能会有延时。通常情况下,延时最多是一小时。
GET
每秒最多调用 5 次。
除了以下参数,您还需要 对请求进行鉴权。
参数名称 | 数据类型 | 参数类型 | 是否必选 | 参数说明 |
---|---|---|---|---|
Action | String | 查询参数 | 是 | API 的名称。该参数的取值是 ListZoneStatistics 。 |
Version | String | 查询参数 | 是 | API 的版本。该参数的取值是 2018-08-01 。 |
Name | String | 查询参数 | 否 | 需要统计请求数的域名,也可以是域名包含的关键字。云解析 DNS 根据 Name 和 SearchMode 确定这些域名,并对每个域名统计解析请求数。 |
PageSize | Integer | 查询参数 | 否 | 每页包含的域名数量。 |
PageNumber | Integer | 查询参数 | 否 | 页码。API 返回该页码所包含的每个域名的统计数据。该参数的默认值是 1 。 |
SearchMode | String | 查询参数 | 否 |
该参数的默认值是 |
Start | Integer | 查询参数 | 否 | 统计时间段的开始时间。格式是 Unix 时间戳。如果您不指定 |
End | Integer | 查询参数 | 否 | 统计时间段的结束时间。格式是 Unix 时间戳。 |
Threshold | Integer | 查询参数 | 否 | 请求数的阈值。如果您指定了该参数,API 会过滤掉请求数大于该参数的域名。 |
SearchOrder | String | 查询参数 | 否 | 请求结果的排序。
|
OrderKey | String | 查询参数 | 否 | 请求结果排序的键值。
|
参数名称 | 数据类型 | 参数说明 |
---|---|---|
RequestId | String | 标识本次请求的 ID。 |
Action | String | Action 查询参数的值。 |
Version | String | API 版本。 |
Service | String | 服务类型。 |
Region | String | 服务所在区域。 |
参数名称 | 数据类型 | 参数说明 |
---|---|---|
Total | Integer | 表示返回的域名的总数。该参数值不受 PageNumber 参数的影响。假设您指定的 PageNumber 没有包含任何域名。此时 Data 参数不会展示任何域名的统计数据。但是 TotalCount 仍然会显示该 API 实际统计的域名总数。 |
PageSize | Integer | 表示每个分页所包含的域名的数量。 |
PageNumber | Integer | 表示 Data 展示的域名所在的页码。 |
Data | Array of Objects | 表示域名的列表。 |
GET https://open.volcengineapi.com?Version=2018-08-01&Action=ListZoneStatistics&Threshold=100&Start=1639540000&End=1639550000
{ "ResponseMetadata": { "RequestId": "20211215192232010225243153052A63E3", "Action": "ListZoneStatistics", "Version": "2018-08-01", "Service": "dns", "Region": "cn-north-1" }, "Result": { "PageNumber": 1, "PageSize": 10, "Total": 2, "Data": [ { "Timestamp": 0, "Success": 1610, "NotExists": 0, "Error": 0, "Total": 1610, "Name": "example.com.", "ZID": 839, "CacheStage": 0 }, { "Timestamp": 0, "Success": 1605, "NotExists": 0, "Error": 0, "Total": 1605, "Name": "test.com.", "ZID": 841, "CacheStage": 0 } ] } }