调用DescribeDomainNs根据传入域名获取域名当前的NS服务器列表,以及NS是否属于阿里云解析管理。

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

调试

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

请求参数

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

系统规定参数。取值:DescribeDomainNs

DomainName String example.com

域名

Lang String en

用户语言

返回数据

名称 类型 示例值 描述
AllAliDns Boolean true

是否全部为阿里云解析DNS

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

域名当前设置的dns列表

DnsServer

域名当前设置的dns列表

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

阿里云分配的dns列表

ExpectDnsServer

阿里云分配的dns列表

IncludeAliDns Boolean true

是否包含阿里云解析DNS

RequestId String 16C7DC7A-2FA7-4D14-8B12-88A2BB6373DB

请求ID

示例

请求示例


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,
	"IncludeAliDns":true,
	"DnsServers":{
		"DnsServer":[
			"vip1.alidns.com",
			"vip2.alidns.com"
		]
	}
}

错误码

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