最近更新时间:2024.03.19 15:37:21
首次发布时间:2022.11.24 20:57:31
API 名称:QueryDomainStatistics
。
API 域名:open.volcengineapi.com
。
API 描述:对某个主域名的子域名按小时粒度统计解析请求数。对于最近一个小时内的解析请求数的统计可能会有延时。通常情况下,延时最多是 1 小时。
GET
除了以下参数,您还需要 对请求进行鉴权。
参数名称 | 数据类型 | 参数类型 | 是否必选 | 参数说明 |
---|---|---|---|---|
Action | String | 查询参数 | 是 | API 的名称。该参数的取值是 QueryDomainStatistics 。 |
Version | String | 查询参数 | 是 | API 的版本。该参数的取值是 2018-08-01 。 |
ZID | Integer | 查询参数 | 是 | 域名的 ID。 |
Name | String | 查询参数 | 是 | 需要统计的子域名。 |
Start | Integer | 查询参数 | 否 | 统计时间段的开始时间。格式是 Unix 时间戳。如果您不指定 Start 和 End 参数,统计时间段默认是过去的 3 天。这里过去 3 天这个时间段的开始时间是调用 API 的时间。 |
End | Integer | 查询参数 | 否 | 统计时间段的结束时间。格式是 Unix 时间戳。 |
参数名称 | 数据类型 | 参数说明 |
---|---|---|
RequestId | String | 标识本次请求的 ID。 |
Action | String | Action 查询参数的值。 |
Version | String | API 版本。 |
Service | String | 服务类型。 |
Region | String | 服务所在区域。 |
参数名称 | 数据类型 | 参数说明 |
---|---|---|
Timestamp | Integer | 一个统计小时的开始时间。格式是 Unix 时间戳。第一个统计小时的开始时间是基于 Start 向后取整。例如您在请求中指定的 Start 表示的时间是 14:15:03,End 表示的时间是 18:47:45。此时:
End 表示的时间是 18:47:45,但是最后一个统计时间段会统计 18:00:00-18:59:59 内的请求数。也就是说,最后一个统计时间段统计的数据包含 18:47:46-18:59:59 的请求数。 |
Success | Integer | 在 Timestamp 指定的小时内,子域名解析成功的次数。 |
NotExists | Integer | 在 Timestamp 指定的小时内,子域名的解析响应是 NXDOMAIN 的次数。NXDOMAIN 表示子域名不存在。常见原因是子域名没有对应的解析记录。 |
Error | Integer | 在 Timestamp 指定的小时内,在云解析 DNS 处理解析请求时,发生内部错误的次数。 |
Total | Integer | 在 Timestamp 指定的小时内,子域名的解析请求总数。 |
GET https://open.volcengineapi.com?Version=2018-08-01&Action=QueryDomainStatistics&ZID=1376&Name=img.example.com&Start=1639540000&End=1639550000
{ "ResponseMetadata": { "RequestId": "2021121519380901022513314301363456", "Action": "QueryDomainStatistics", "Version": "2018-08-01", "Service": "dns", "Region": "cn-north-1" }, "Result": [ { "Timestamp": 1639310400, "Success": 22, "NotExists": 0, "Error": 0, "Total": 22 }, { "Timestamp": 1639314000, "Success": 22, "NotExists": 0, "Error": 0, "Total": 22 } ] }