Calls the DescribeDnsProductInstance operation to query details about a paid Alibaba Cloud DNS instance based on the instance ID.

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 DescribeDnsProductInstance

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

InstanceId String Yes i-8fxxxx

The ID of the instance. You can call the DescribeDomainInfo operation to obtain the instance ID.

Lang String No en

The language type.

UserClientIp String No 1.1.1.1

The IP address of the client.

Response parameters

Parameter Type Example Description
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 you can bind 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 advanced

The DNS security policy. Valid values:

  • no: not required.
  • basic: anti-DDoS basic.
  • advanced: anti-DDoS advanced.
DnsServers List {"DnsServer": ["vip1.alidns.com","vip2.alidns.com"]}

The list of DNS servers.

DnsServer

Details about a DNS server.

Domain String abc.com

The bound domain name.

If this parameter is not specified, no domain name is bound.

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 GSLB was allowed.

ISPLines String telecom、mobile、unicom、edu

The list of ISP lines.

ISPRegionLines String telecom(provinces)、mobile(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-8fxxx

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.

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

The ID of the request.

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.

Examples

Sample requests


http(s)://alidns.aliyuncs.com/?Action=DescribeDnsProductInstance
&InstanceId=i-8fxxxx
&<Common request parameters>

Sample success responses

XML format

<DescribeDnsProductInstanceResponse>
      <MonitorFrequency>1</MonitorFrequency>
      <InstanceId>i-4fxxxxx</InstanceId>
      <DDosDefendQuery>2</DDosDefendQuery>
      <URLForwardCount>2</URLForwardCount>
      <StartTimestamp>1474335170000</StartTimestamp>
      <MonitorTaskCount>10</MonitorTaskCount>
      <OverseaLine>oversea</OverseaLine>
      <DDosDefendFlow>2</DDosDefendFlow>
      <OverseaDDosDefendFlow>1</OverseaDDosDefendFlow>
      <ISPLines>telecom、mobile、unicom、edu</ISPLines>
      <SubDomainLevel>5</SubDomainLevel>
      <StartTime>2016-09-20T01:32Z</StartTime>
      <SearchEngineLines>search、google、baidu、biying</SearchEngineLines>
      <DnsSLBCount>10</DnsSLBCount>
      <Domain>almmmwhois.com</Domain>
      <ISPRegionLines>unicom(provinces)、mobile(provinces)</ISPRegionLines>
      <MonitorNodeCount>10</MonitorNodeCount>
      <DnsServers>
            <DnsServer>vip1.alidns.com</DnsServer>
            <DnsServer>vip2.alidns.com</DnsServer>
      </DnsServers>
      <BindUsedCount>1</BindUsedCount>
      <BindCount>2</BindCount>
      <VersionName>Alibaba CloudDNS(Subscription)</VersionName>
      <TTLMinValue>600</TTLMinValue>
      <VersionCode>dingzhi</VersionCode>
      <RequestId>04350372-B9A1-4A07-A43F-853503F28DAF</RequestId>
      <EndTimestamp>1487606400000</EndTimestamp>
      <EndTime>2017-02-20T16:00Z</EndTime>
</DescribeDnsProductInstanceResponse>

JSON format

{
	"MonitorFrequency":1,
	"DDosDefendQuery":2,
	"InstanceId":"i-4fxxxxx",
	"URLForwardCount":2,
	"StartTimestamp":1474335170000,
	"MonitorTaskCount":10,
	"OverseaLine":"oversea",
	"DDosDefendFlow":2,
	"OverseaDDosDefendFlow":1,
	"ISPLines":"telecom、mobile、unicom、edu",
	"SubDomainLevel":5,
	"StartTime":"2016-09-20T01:32Z",
	"SearchEngineLines":"search、google、baidu、biying",
	"DnsSLBCount":10,
	"Domain":"almmmwhois.com",
	"ISPRegionLines":"unicom(provinces)、mobile(provinces)",
	"MonitorNodeCount":10,
	"DnsServers":{
		"DnsServer":[
			"vip1.alidns.com",
			"vip2.alidns.com"
		]
	},
	"BindUsedCount":1,
	"BindCount":2,
	"VersionName":"Alibaba CloudDNS(Subscription)",
	"TTLMinValue":600,
	"VersionCode":"dingzhi",
	"RequestId":"04350372-B9A1-4A07-A43F-853503F28DAF",
	"EndTime":"2017-02-20T16:00Z",
	"EndTimestamp":1487606400000
}

Error codes

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