Calls the DescribeDnsProductInstances operation to query the list of paid Alibaba Cloud DNS instances based on input parameters.

Note If the response parameters of an Alibaba Cloud DNS instance do not contain domain names, no domain names are bound to the instance.

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 DescribeDnsProductInstances

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

AccessKeyId String No your_accesskey_id

The AccessKey ID provided to you by Alibaba Cloud.

Lang String No en

The language type.

PageNumber Long No 1

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

PageSize Long No 20

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

UserClientIp String No 1.1.1.1

The IP address of the client.

VersionCode String No version1

The version code of the Alibaba Cloud DNS instance.

Response parameters

Parameter Type Example Description
DnsProducts Array

The list of Alibaba Cloud DNS instances obtained by this operation.

DnsProduct

Details about an Alibaba Cloud DNS instance obtained by this operation.

BindCount Long 3

The number of times you can change domain names that are bound to the DNS instance. It can be specified by the user who uses Alibaba Cloud DNS of the custom version.

BindDomainCount Long 5

The number of domain names that can be bound to the DNS instance.

BindDomainUsedCount Long 3

The number of domain names that have been bound to the DNS instance.

BindUsedCount Long 1

The number of times you have changed domain names that are bound to the DNS instance. It can be specified by the user who uses Alibaba Cloud DNS of the custom version.

DDosDefendFlow Long 50

The DDoS protection traffic. Unit: GB.

DDosDefendQuery Long 50

The DDoS protection frequency. Unit: 10,000 QPS.

DnsSLBCount Long 15

The number of IP addresses supported by a domain name or line.

DnsSecurity String no

The DNS security policy. Valid values:

  • no: not required.
  • basic: anti-DDoS basic.
  • advanced: anti-DDoS advanced.
Domain String abc.com

The bound domain name.

EndTime String 2015-12-12T09:23Z

The time at which the instance expired.

EndTimestamp Long 1474335170000

The UNIX timestamp representing the expiration time of the instance.

Gslb Boolean true

Indicates whether global server load balancing (GSLB) was allowed.

ISPLines String telecom、mobile、unicom、edu

The list of ISP lines.

ISPRegionLines String telecom(provinces)、(provinces)、unicom(provinces)、edu(provinces)

The list of ISP line subdivisions.

InBlackHole Boolean false

Indicates whether the request for domain name resolution was in the black hole.

InClean Boolean false

Indicates whether the request for domain name resolution was being cleared.

InstanceId String i-8fj

The ID of the Alibaba Cloud DNS instance.

MonitorFrequency Long 50

The monitoring frequency. Unit: minutes.

MonitorNodeCount Long 5

The number of monitored nodes.

MonitorTaskCount Long 2

The number of monitoring tasks.

OverseaDDosDefendFlow Long 1

DDoS protection traffic outside China. Unit: GB.

OverseaLine String oversea

The type of the overseas line.

RegionLines Boolean true

Indicates whether regional lines were allowed.

SearchEngineLines String search、google、baidu、biying

The list of search engine lines.

StartTime String 2015-12-12T09:23Z

The time when the DNS instance was purchased.

StartTimestamp Long 1474335170000

The UNIX timestamp representing when the DNS instance was purchased.

SubDomainLevel Long 6

The number of subdomain name levels.

TTLMinValue Long 10

The minimum TTL. Unit: seconds.

URLForwardCount Long 20

The URL forwarding quantity.

VersionCode String version1

The version code of the Alibaba Cloud DNS instance.

VersionName String Enterprise Ultimate Edition

The version name of the Alibaba Cloud DNS instance.

PageNumber Long 1

The page number of the returned page.

PageSize Long 2

The number of entries returned per page.

RequestId String 536E9CAD-DB30-4647-AC87-AA5CC38C5382

The ID of the request.

TotalCount Long 2

The total number of domain names.

Examples

Sample requests


http(s)://alidns.aliyuncs.com/?Action=DescribeDnsProductInstances
&<Common request parameters>

Sample success responses

XML format

<DescribeDnsProductInstancesResponse>
      <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
      <TotalCount>1</TotalCount>
      <PageNumber>1</PageNumber>
      <PageSize>2</PageSize>
      <DnsProducts>
            <DnsProduct>
                  <InstanceId>i-8fj</InstanceId>
                  <StartTime>2015-12-12T09:23Z</StartTime>
                  <EndTime>2016-12-12T09:23Z</EndTime>
                  <Domain>abc.com</Domain>
                  <BindCount>3</BindCount>
                  <BindUsedCount>1</BindUsedCount>
                  <TTLMinValue>10</TTLMinValue>
                  <SubDomainLevel>6</SubDomainLevel>
                  <DnsSLBCount>15</DnsSLBCount>
                  <URLForwardCount>20</URLForwardCount>
                  <DDosDefendFlow>50</DDosDefendFlow>
                  <DDosDefendQuery>50</DDosDefendQuery>
                  <OverseaDDosDefendFlow>1</OverseaDDosDefendFlow>
                  <SearchEngineLines>search、google、baidu、biying</SearchEngineLines>
                  <ISPLines>telecom、mobile、unicom、edu</ISPLines>
                  <ISPRegionLines>telecom(provinces)、(provinces)、unicom(provinces)、edu(provinces)</ISPRegionLines>
                  <OverseaLine>oversea</OverseaLine>
            </DnsProduct>
      </DnsProducts>
</DescribeDnsProductInstancesResponse>

JSON format

{
	"DescribeDnsProductInstancesResponse":{
		"PageNumber":"1",
		"TotalCount":"1",
		"PageSize":"2",
		"RequestId":"536E9CAD-DB30-4647-AC87-AA5CC38C5382",
		"DnsProducts":{
			"DnsProduct":{
				"DnsSLBCount":"15",
				"ISPRegionLines":"telecom(provinces)、(provinces)、unicom(provinces)、edu(provinces)",
				"Domain":"abc.com",
				"InstanceId":"i-8fj",
				"DDosDefendQuery":"50",
				"URLForwardCount":"20",
				"BindUsedCount":"1",
				"BindCount":"3",
				"OverseaLine":"oversea",
				"DDosDefendFlow":"50",
				"OverseaDDosDefendFlow":"1",
				"ISPLines":"telecom、mobile、unicom、edu",
				"TTLMinValue":"10",
				"SubDomainLevel":"6",
				"EndTime":"2016-12-12T09:23Z",
				"StartTime":"2015-12-12T09:23Z",
				"SearchEngineLines":"search、google、baidu、biying"
			}
		}
	}
}

Error codes

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