获取域名信息_域名管理接口_API文档

描述

根据传入参数查询指定域名的信息。

请求参数

名称	类型	是否必须	描述
Action	String	是	操作接口名，系统规定参数，取值：DescribeDomainInfo
DomainName	String	是	域名名称

返回参数

公共返回参数，详见公共返回参数

名称	类型	描述
RequestId	String	唯一请求识别码
DomainId	String	域名ID
DomainName	String	域名名称
AliDomain	Boolean	是否为阿里云万网域名
GroupId	String	域名分组ID
GroupName	String	域名分组名称
InstanceId	String	云解析产品ID，如果是免费版则为空
VersionCode	String	云解析版本ID
PunyCode	String	只针对中文域名返回punycode码
DnsServers	DnsServerType	域名在解析系统中的DNS列表

错误码

对于所有接口的通用性错误，请参考错误代码表。

错误代码	描述	HTTP 状态码	语义
IncorrectDomainUser	The domain name does not belong to this user.	400	域名在本账户下不存在
InvalidDomainName.NoExist	The domain is not exist in Alibaba Cloud DNS system.	400	域名在云解析系统中不存在

示例

请求示例

http://alidns.aliyuncs.com/?Action=DescribeDomainInfo
&DomainName=example.com
&<公共请求参数>

返回示例

XML格式

<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示例

{
    "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"
        ]
    }
}