Domain name for API request: teo.tencentcloudapi.com.
This API is used to get DNS requests.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: DescribeDnsData. |
Version | Yes | String | Common Params. The value used for this API: 2022-09-01. |
Region | No | String | Common Params. This parameter is not required. |
StartTime | Yes | Timestamp ISO8601 | The start time. |
EndTime | Yes | Timestamp ISO8601 | The end time. |
Filters.N | No | Array of Filter | Filter criteria. Each filter criteria can have up to 20 entries.zone :Filter by site name, such as tencent.com (up to one entry) Type: String Required: No host :Filter by domain name, such as test.tencent.com (up to one entry) Type: String Required: No type :Filter by DNS record type Type: String Required: No Values: A : A recordAAAA : AAAA recordCNAME : CNAME recordMX : MX recordTXT : TXT recordNS : NS recordSRV : SRV recordCAA : CAA recordcode :Filter by DNS status code Type: String Required: No Values: NoError : SuccessNXDomain : Not found the request domainNotImp : Not supported request typeRefused : The domain name server refuses to execute the request for policy reasonsarea :Filter by DNS region Type: String Required: No Values: Asia Europe Africa Oceania Americas |
Interval | No | String | The query time granularity. Values:min : 1 minute;5min : 5 minute;hour : 1 hour;day : 1 day.min if not specified. |
Parameter Name | Type | Description |
---|---|---|
Data | Array of DnsData | DNS statistics. |
RequestId | String | The unique request ID, which is returned for each request. RequestId is required for locating a problem. |
POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeDnsData
<Common request parameters>
{
"StartTime": "2020-09-01T00:00:00+00:00",
"EndTime": "2020-09-22T00:01:00+00:00",
"Filters": [
{
"Name": "zone",
"Values": [
"tencent.com"
]
}
]
}
{
"Response": {
"RequestId": "9cc50b24-7dc5-44f4-96ce-95825d53ff2f",
"Data": [
{
"Time": "2020-09-01T00:00:00+00:00",
"Value": 101
},
{
"Time": "2020-09-01T00:01:00+00:00",
"Value": 102
},
{
"Time": "2020-09-01T00:02:00+00:00",
"Value": 103
},
{
"Time": "2020-09-01T00:03:00+00:00",
"Value": 104
},
{
"Time": "2020-09-01T00:04:00+00:00",
"Value": 105
},
{
"Time": "2020-09-01T00:05:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:06:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:07:00+00:00",
"Value": 107
},
{
"Time": "2020-09-01T00:08:00+00:00",
"Value": 108
},
{
"Time": "2020-09-01T00:09:00+00:00",
"Value": 109
}
]
}
}
POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeDnsData
<Common request parameters>
{
"StartTime": "2020-09-01T00:00:00+00:00",
"EndTime": "2020-09-01T00:09:59+00:00",
"Filters": [
{
"Name": "zone",
"Values": [
"tencent.com"
]
},
{
"Name": "host",
"Values": [
"test.tencent.com"
]
}
]
}
{
"Response": {
"RequestId": "9cc50b24-7dc5-44f4-96ce-95825d53ff2f",
"Data": [
{
"Time": "2020-09-01T00:00:00+00:00",
"Value": 101
},
{
"Time": "2020-09-01T00:01:00+00:00",
"Value": 102
},
{
"Time": "2020-09-01T00:02:00+00:00",
"Value": 103
},
{
"Time": "2020-09-01T00:03:00+00:00",
"Value": 104
},
{
"Time": "2020-09-01T00:04:00+00:00",
"Value": 105
},
{
"Time": "2020-09-01T00:05:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:06:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:07:00+00:00",
"Value": 107
},
{
"Time": "2020-09-01T00:08:00+00:00",
"Value": 108
},
{
"Time": "2020-09-01T00:09:00+00:00",
"Value": 109
}
]
}
}
POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeDnsData
<Common request parameters>
{
"StartTime": "2020-09-01T00:00:00+00:00",
"EndTime": "2020-09-01T00:09:59+00:00",
"Filters": [
{
"Name": "zone",
"Values": [
"tencent.com"
]
},
{
"Name": "area",
"Values": [
"Asia",
"Africa"
]
}
]
}
{
"Response": {
"RequestId": "9cc50b24-7dc5-44f4-96ce-95825d53ff2f",
"Data": [
{
"Time": "2020-09-01T00:00:00+00:00",
"Value": 101
},
{
"Time": "2020-09-01T00:01:00+00:00",
"Value": 102
},
{
"Time": "2020-09-01T00:02:00+00:00",
"Value": 103
},
{
"Time": "2020-09-01T00:03:00+00:00",
"Value": 104
},
{
"Time": "2020-09-01T00:04:00+00:00",
"Value": 105
},
{
"Time": "2020-09-01T00:05:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:06:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:07:00+00:00",
"Value": 107
},
{
"Time": "2020-09-01T00:08:00+00:00",
"Value": 108
},
{
"Time": "2020-09-01T00:09:00+00:00",
"Value": 109
}
]
}
}
POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeDnsData
<Common request parameters>
{
"StartTime": "2020-09-01T00:00:00+00:00",
"EndTime": "2020-09-01T00:09:59+00:00",
"Filters": [
{
"Name": "zone",
"Values": [
"tencent.com"
]
},
{
"Name": "code",
"Values": [
"NXDomain",
"NotImp",
"Refused"
]
}
]
}
{
"Response": {
"RequestId": "9cc50b24-7dc5-44f4-96ce-95825d53ff2f",
"Data": [
{
"Time": "2020-09-01T00:00:00+00:00",
"Value": 101
},
{
"Time": "2020-09-01T00:01:00+00:00",
"Value": 102
},
{
"Time": "2020-09-01T00:02:00+00:00",
"Value": 103
},
{
"Time": "2020-09-01T00:03:00+00:00",
"Value": 104
},
{
"Time": "2020-09-01T00:04:00+00:00",
"Value": 105
},
{
"Time": "2020-09-01T00:05:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:06:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:07:00+00:00",
"Value": 107
},
{
"Time": "2020-09-01T00:08:00+00:00",
"Value": 108
},
{
"Time": "2020-09-01T00:09:00+00:00",
"Value": 109
}
]
}
}
POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeDnsData
<Common request parameters>
{
"StartTime": "2020-09-01T00:00:00+00:00",
"EndTime": "2020-09-01T00:09:59+00:00",
"Filters": [
{
"Name": "zone",
"Values": [
"tencent.com"
]
},
{
"Name": "type",
"Values": [
"A"
]
}
]
}
{
"Response": {
"RequestId": "9cc50b24-7dc5-44f4-96ce-95825d53ff2f",
"Data": [
{
"Time": "2020-09-01T00:00:00+00:00",
"Value": 101
},
{
"Time": "2020-09-01T00:01:00+00:00",
"Value": 102
},
{
"Time": "2020-09-01T00:02:00+00:00",
"Value": 103
},
{
"Time": "2020-09-01T00:03:00+00:00",
"Value": 104
},
{
"Time": "2020-09-01T00:04:00+00:00",
"Value": 105
},
{
"Time": "2020-09-01T00:05:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:06:00+00:00",
"Value": 0
},
{
"Time": "2020-09-01T00:07:00+00:00",
"Value": 107
},
{
"Time": "2020-09-01T00:08:00+00:00",
"Value": 108
},
{
"Time": "2020-09-01T00:09:00+00:00",
"Value": 109
}
]
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
OperationDenied | Operation denied. |
ResourceNotFound | The resource doesn’t exist. |
UnauthorizedOperation.CamUnauthorized | CAM is not authorized. |
UnauthorizedOperation.NoPermission | The sub-account is not authorized for the operation. Please get permissions first. |
本页内容是否解决了您的问题?