You need to enable JavaScript to run this app.
导航

检查域名是否符合添加条件

最近更新时间2023.12.06 10:39:30

首次发布时间2022.11.24 20:57:30

API 说明

API 名称:CheckZone
API 域名:open.volcengineapi.com
API 描述:添加域名前,您可以使用该 API 检查域名的状态。如果检查结果符合要求,您就可以添加该域名。

请求方法

GET

调用限制

每秒最多调用 5 次。

请求参数

除了以下参数,您还需要 对请求进行鉴权

参数名称数据类型参数类型是否必选参数说明
ActionString查询参数API 的名称。该参数的取值是 CheckZone
VersionString查询参数API 的版本。该参数的取值是 2018-08-01
ZoneNameString查询参数待检查的域名。

响应正文

ResponseMetadata 对象

参数名称
数据类型
参数说明
RequestId
String
标识本次请求的 ID。
Action
String
Action 查询参数的值。
Version
String
API 版本。
Service
String
服务类型。
Region
String
服务所在区域。

Result 对象

参数名称数据类型参数说明
ZoneNameString被检查的域名。
NameServerString[]域名在域名注册商处分配的 NS 服务器列表。

Registered

Boolean

域名是否已注册。该参数有以下取值:

  • true:域名已注册。

  • false:域名未注册。

Message

String

域名检查结果的信息。该参数有以下取值:

  • 未查询到域名的DNS服务器配置信息:域名检查出现异常。异常通常由以下原因造成:

    • 域名未实名认证导致域名被注册局或注册商停用。

    • 域名未配置 DNS 服务器。

    • 域名未注册。

    • API 在查询时超时。超时原因可能是网络问题引起的。

  • 暂不支持子域独立托管:您输入的域名不是二级域名。当前,您只能添加二级域名。

  • 域名已存在:域名已存在于云解析 DNS 中。您无需重复添加。

  • 空字符串(""):域名符合要求。您可以调用 CreateZone API 添加该域名。

示例

请求示例

GET https://open.volcengineapi.com?Version=2018-08-01&Action=CheckZone&ZoneName=example.com

响应示例

{
    "ResponseMetadata": {
        "RequestId": "20211215143549010225110011003276CE",
        "Action": "CheckZone",
        "Version": "2018-08-01",
        "Service": "dns",
        "Region": "cn-north-1"
    },
    "Result": {
        "ZoneName": "example.com",
        "NameServer": ["ns1.aaab-test.com","ne2.aaab-test.com"],
        "Registered": true,
        "Message":"域名已存在"
    }
}