Obtains the query volumes of DNS over HTTPS (DoH) subdomains.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDohSubDomainStatisticsSummary

The operation that you want to perform. Set the value to DescribeDohSubDomainStatisticsSummary.

DomainName String Yes example.com

The domain name.

PageNumber Integer Yes 1

The number of the page to return. Pages start from page 1. Default value: 1.

StartDate String Yes 2019-07-04

The beginning of the time range to query. Specify the time in the YYYY-MM-DD format.

You can query only the DNS records of the last 90 days. The value of StartDate must be greater than or equal to the difference between the current date and 90.

Lang String No en

The language type.

PageSize Integer No 20

The number of entries to return on each page. Maximum value: 100. Default value: 20.

EndDate String No 2019-07-04

The end of the time range to query. Specify the time in the YYYY-MM-DD format.

The default value is the day when you query the required data.

SubDomain String No www.example.com

The subdomain.

Response parameters

Parameter Type Example Description
PageNumber Integer 1

The page number of the returned page.

PageSize Integer 10

The number of entries returned per page.

RequestId String 0F32959D-417B-4D66-8463-68606605E3E2

The ID of the request.

Statistics Array of Statistic

The statistics list.

HttpCount Long 3141592653

The number of HTTP requests.

HttpsCount Long 3141592653

The number of HTTPS requests.

IpCount Long 20

The number of IP addresses.

SubDomain String www.example.com

The subdomain.

TotalCount Long 14141592653

Total number of requests.

V4HttpCount Long 3141592653

The number of IPv4-based HTTP requests.

V4HttpsCount Long 3141592653

The number of IPv4-based HTTPS requests.

V6HttpCount Long 3141592653

The number of IPv6-based HTTP requests.

V6HttpsCount Long 3141592653

The number of IPv6-based HTTPS requests.

TotalItems Integer 100

Total number of entries returned.

TotalPages Integer 50

Total number of pages returned.

Examples

Sample requests

http(s)://alidns.aliyuncs.com/?Action=DescribeDohSubDomainStatisticsSummary
&DomainName=example.com
&PageNumber=1
&StartDate=2019-07-04	
&<Common request parameters>

Sample success responses

XML format

<RequestId>0F32959D-417B-4D66-8463-68606605E3E2</RequestId>
<PageSize>10</PageSize>
<PageNumber>1</PageNumber>
<TotalPages>50</TotalPages>
<TotalItems>100</TotalItems>
<Statistics>
    <SubDomain>www.example.com</SubDomain>
    <TotalCount>14141592653</TotalCount>
    <IpCount>20</IpCount>
    <V4HttpCount>3141592653</V4HttpCount>
    <V6HttpCount>3141592653</V6HttpCount>
    <HttpCount>3141592653</HttpCount>
    <HttpsCount>3141592653</HttpsCount>
    <V4HttpsCount>3141592653</V4HttpsCount>
    <V6HttpsCount>3141592653</V6HttpsCount>
</Statistics>

JSON format

{
	"RequestId": "0F32959D-417B-4D66-8463-68606605E3E2",
	"PageSize": "10",
	"PageNumber": "1",
	"TotalPages": "50",
	"TotalItems": "100",
	"Statistics": [{
		"SubDomain": "www.example.com",
		"TotalCount": "14141592653",
		"IpCount": "20",
		"V4HttpCount": "3141592653",
		"V6HttpCount": "3141592653",
		"HttpCount": "3141592653",
		"HttpsCount": "3141592653",
		"V4HttpsCount": "3141592653",
		"V6HttpsCount": "3141592653"
	}]
}

Error codes

For a list of error codes, visit the API Error Center.