调用DescribeDomainNs根据传入域名获取域名DNS服务器名称,以及域名DNS服务器是否属于阿里云解析DNS。

说明 此接口通过直接查询注册局权威服务器来获取域名DNS服务器名称,如果域名处于未生效状态(例如:serverHold、clientHold、未实名认证),可能会返回异常。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDomainNs

系统规定参数。取值:DescribeDomainNs

DomainName String example.com

域名

Lang String en

用户语言

返回数据

名称 类型 示例值 描述
RequestId String 16C7DC7A-2FA7-4D14-8B12-88A2BB6373DB

请求ID

AllAliDns Boolean true

是否全部为阿里云解析DNS

IncludeAliDns Boolean true

是否包含阿里云解析DNS

DnsServers List vip1.alidns.com,vip2.alidns.com

域名当前设置的DNS服务器名称

ExpectDnsServers List x1.alidns.com,x2.alidns.com

云解析DNS分配的域名DNS服务器名称

示例

请求示例

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

正常返回示例

XML 格式

<DescribeDomainNsResponse>
      <RequestId>16C7DC7A-2FA7-4D14-8B12-88A2BB6373DB</RequestId>
      <AllAliDns>true</AllAliDns>
      <DnsServers>
            <DnsServer>vip1.alidns.com</DnsServer>
            <DnsServer>vip2.alidns.com</DnsServer>
      </DnsServers>
      <IncludeAliDns>true</IncludeAliDns>
</DescribeDomainNsResponse>

JSON 格式

{
        "RequestId": "16C7DC7A-2FA7-4D14-8B12-88A2BB6373DB",
        "AllAliDns": true,
        "DnsServers": {
            "DnsServer": [
                "vip1.alidns.com",
                "vip2.alidns.com"
            ]
        },
        "IncludeAliDns": true
}

错误码

访问错误中心查看更多错误码。