edit-icon download-icon

Retrieving Domain Name Information

Last Updated: May 27, 2016

Description

Queries the information on a specified domain name based on input parameters.

Request Parameters

Name Type Required? Description
Action String Yes Operation interface name, required parameter. Value: DescribeDomainInfo
DomainName String Yes Domain name

Return Parameters

Public return parameters. For details, see Public Return Parameters

Name Type Description
RequestId String The unique request identifier
DomainId String Domain name ID
DomainName String Domain name
AliDomain Boolean Whether or not it is an Alibaba Cloud HiChina domain name
GroupId String Domain name group ID
GroupName String The name of the domain name group
InstanceId String The Alibaba Cloud DNS product ID, blank if it is the free version
VersionCode String The Alibaba Cloud DNS version ID
PunyCode String punycode returned only for a Chinese domain name
DnsServers DnsServerType The DNS list for a domain name in the resolution system

Error Codes

For errors common to all interfaces, please refer to the Error Code Table .

Error Code Description HTTP Status Code Meaning
IncorrectDomainUser The domain name does not belong to this user. 400 The domain name does not exist under this account
InvalidDomainName.NoExist The domain is not exist in Alibaba Cloud DNS system. 400 The domain name does not exist in the Alibaba Cloud DNS system

Example

Request Example

http://dns.aliyuncs.com/?Action=DescribeDomainInfo
&DomainName=example.com
&<Public Request Parameters>

Return Example

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 Example

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