Calls the DescribeDomainInfo operation to query information about a specified domain name based on input parameters.

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 DescribeDomainInfo

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

DomainName String Yes example.com

The domain name.

AccessKeyId String No your_accesskey_id

The AccessKey ID provided to you by Alibaba Cloud.

Lang String No en

The language type.

NeedDetailAttributes Boolean No false

Specifies whether detail attributes are required. Default value: false, which indicates that detail attributes are not required.

Response parameters

Parameter Type Example Description
AliDomain Boolean true

Indicates whether the domain name is an Alibaba Cloud HiChina domain name.

AvailableTtls List [600,1800,3600,43200,86400]

The list of available TTL values.

AvailableTtl

Details about an available TTL value.

DnsServers List ["vip3.alidns.com", "vip4.alidns.com"]

Information about DNS servers.

DnsServer

Information about a DNS server.

DomainId String 00efd71a-770e-4255-b54e-6fe5659baffe

The ID of the domain name.

DomainName String example.com

The domain name.

GroupId String 2223

The ID of the domain name group.

GroupName String mygroup

The name of the domain name group.

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-7bg

The ID of the Alibaba Cloud DNS instance.

LineType String region_province

The type of the line.

MinTtl Long 1

The minimum TTL.

PunyCode String example.com

The punycode is only returned for Chinese domain names.

RecordLineTreeJson String {"default":{},"unicom":{},"telecom":{},"mobile":{},"edu":{},"oversea":{},"baidu":{},"biying":{},"google":{}}

The list of tree-based resolution lines.

RecordLines Array

The list of resolution lines.

RecordLine

Details about a resolution line.

FatherCode String internal

The code of the parent line. Leave it blank if there is no parent line.

LineCode String cn_region_xibei

The code of the child line.

LineDisplayName String cn_region_xibei

The name of the parent line.

LineName String cn_region_xibei

The name of the child line.

RegionLines Boolean false

Indicates whether it is a regional line.

Remark String remark

The description of the line.

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

The ID of the request.

SlaveDns Boolean true

Indicates whether secondary DNS is allowed.

VersionCode String version1

The version code of the Alibaba Cloud DNS instance.

VersionName String Enterprise Standard Edition

The version name of the Alibaba Cloud DNS instance.

Examples

Sample requests


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

Sample success responses

XML format

<DescribeDomainInfoResponse>
      <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
      <DomainId>00efd71a-770e-4255-b54e-6fe5659baffe</DomainId>
      <DomainName>example.com</DomainName>
      <AliDomain>true</AliDomain>
      <GroupId>2223</GroupId>
      <GroupName>MyGroup</GroupName>
      <InstanceId>i-7bg</InstanceId>
      <VersionCode>version1</VersionCode>
      <PunyCode>example.com</PunyCode>
      <DnsServers>
            <DnsServer>dns1.hichina.com</DnsServer>
            <DnsServer>dns2.hichina.com</DnsServer>
      </DnsServers>
</DescribeDomainInfoResponse>

JSON format

{
	"GroupName":"MyGroup",
	"PunyCode":"example.com",
	"VersionCode":"version1",
	"InstanceId":"i-7bg",
	"RequestId":"536E9CAD-DB30-4647-AC87-AA5CC38C5382",
	"AliDomain":"true",
	"DomainName":"example.com",
	"DomainId":"00efd71a-770e-4255-b54e-6fe5659baffe",
	"DnsServers":{
		"DnsServer":[
			"ns1.alidns.com",
			"ns2.alidns.com"
		]
	},
	"GroupId":"2223"
}

Error codes

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