文档

CheckDomain

更新时间:

调用CheckDomain验证域名。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

DomainId

Integer

153345

域名ID。

Action

String

CheckDomain

系统规定参数。取值:CheckDomain。

返回数据

名称

类型

示例值

描述

DomainStatus

Integer

1

域状态,说明是否验证成功:

0:可用,已验证通过

1:不可用,验证未通过

2:可使用,未做cname,未备案

3:可使用,未备案

4:可使用,未做cname

RequestId

String

F0B82E83-A1D9-4FE6-97D2-F4B231F80B02

请求ID

示例

请求示例

http(s)://dm.aliyuncs.com/?Action=CheckDomain
&DomainId=153345
&<公共请求参数>

正常返回示例

XML 格式

<CheckDomainResponse>
      <DomainStatus>1</DomainStatus>
      <RequestId>F0B82E83-A1D9-4FE6-97D2-F4B231F80B02</RequestId>
</CheckDomainResponse>

JSON 格式

{
    "RequestId":"F0B82E83-A1D9-4FE6-97D2-F4B231F80B02",
    "DomainStatus":1
}

错误码

错误代码

描述

Http状态码

语义

InvalidDomainId.Malformed

The specified domain ID does not exist.

404

域名ID不存在

CheckDomain.Failed

Domain check failed.

400

域名验证失败

InvalidDomainName.DuplicateTLD

The top-level domain of the specified domain name already exists.

400

主域名已存在

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