Queries the summary list of public network authoritative resolution statistics.
Operation description
Real-time data is aggregated by the hour dimension.
This operation is available only to customers who have been added to the whitelist. To invoke this operation, contact your account manager or submit a ticket to request whitelist access permissions.
Try it now
Test
RAM authorization
Request syntax
GET HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| StartTimestamp |
integer |
No |
The start time of the query. The value is a UNIX timestamp in milliseconds. |
1516779348000 |
| EndTimestamp |
integer |
No |
The end time of the query. The value is a UNIX timestamp in milliseconds. Warning If the query time range is large and the domain name has a large volume of resolution logs, the query may time out or return inaccurate results. |
1741526400000 |
| ServerRegion |
string |
No |
The region of the resolution cluster. |
ap-southeast-3 |
| StatisticalType |
string |
No |
The statistical metric type. |
QTYPE_RATIO Valid values: QTYPE_RATIO: the ratio of DNS request record types. RCODE_DOMAIN: the top ranking of negative response domain names. RCODE_SOURCE_IP: the top ranking of request source addresses for a specific negative response domain name. REQUEST_ZONE: the ranking of domain name request volume at the zone level. REQUEST_DOMAIN: the ranking of subdomain request volume at the domain name level. SOURCE_REGION: the distribution of request source regions. SOURCE_ISP: the distribution of request source Internet service providers (ISPs). SOURCE_IP: the details of request source IP addresses, including region, ISP, and ratio. LINE_HIT: the details of resolution line hits. LINE_RATIO: the traffic ratio of resolution lines |
| ZoneName |
string |
No |
The zone name. |
example.com |
| DomainName |
string |
No |
The domain name. |
example.com |
| Direction |
string |
No |
The sort direction. Valid values:
|
DESC |
| PageNumber |
integer |
No |
The page number. The value starts from 1. Default value: 1. |
1 |
| PageSize |
integer |
No |
The number of entries per page for a paged query. Maximum value: 100. Default value: 20. |
1 |
| Rcode |
string |
No |
The DNS response code. |
0 |
| SourceType |
string |
No |
The route type. Valid values: cloud: cloud route. local: on-premises route. |
File |
| Period |
string |
No |
The sampling period. Valid values:
|
DAY |
| GrowType |
string |
No |
Used for the report on subdomains with sudden increases or decreases in request volume. |
up down |
| OrderBy |
string |
No |
The sort parameter. Valid values:
|
default |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
853805EA-3D47-47D5-9A1A-A45C24313ABD |
| CurPage |
integer |
The current page number. |
1 |
| PageSize |
integer |
The number of entries per page for a paged query. Maximum value: 100. Default value: 20. |
5 |
| TotalPage |
integer |
The total number of pages. |
5 |
| TotalSize |
integer |
The total number of entries. |
48 |
| PageData |
array<object> |
The paginated data. |
|
|
object |
The paginated data. |
||
| ZoneName |
string |
The zone name. |
longzi.xyz |
| DomainName |
string |
The domain name. Queries the transfer records of the specified domain name. |
nervermsf.com |
| Protocol |
string |
The protocol type of the DNS resolution query request. Valid values:
|
TCP%DF\" |
| Line |
string |
The resolution line. |
default |
| SourceRegion |
string |
The source region. If not specified, a random region is selected. |
cn-shenzhen |
| SourceIsp |
string |
The ISP of the request source. |
telecom |
| Count |
integer |
The number of requests. |
20 |
| Ratio |
integer |
The success rate or ratio. |
20 |
| Qtype |
string |
The request record type. |
A |
| Rcode |
string |
The DNS response code. |
0 |
| SourceIp |
string |
The source IP address. |
112.16.17.203 |
| PreviousCount |
integer |
The value of the previous period. |
2227 |
| AggrTimestamp |
integer |
The start time of the current period (the 0th second of the minute). |
1776754800000 |
| FluctuationValue |
integer |
The fluctuation rate. |
19 |
Examples
Success response
JSON format
{
"RequestId": "853805EA-3D47-47D5-9A1A-A45C24313ABD",
"CurPage": 1,
"PageSize": 5,
"TotalPage": 5,
"TotalSize": 48,
"PageData": [
{
"ZoneName": "longzi.xyz",
"DomainName": "nervermsf.com",
"Protocol": "TCP%DF\\\"",
"Line": "default",
"SourceRegion": "cn-shenzhen",
"SourceIsp": "telecom",
"Count": 20,
"Ratio": 20,
"Qtype": "A",
"Rcode": "0",
"SourceIp": "112.16.17.203",
"PreviousCount": 2227,
"AggrTimestamp": 1776754800000,
"FluctuationValue": 19
}
]
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.