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

收回域名解析管理权

最近更新时间2024.03.19 19:29:48

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

API 说明

API 名称:CheckRetrieveZone
API 域名:open.volcengineapi.com
API 描述:收回域名解析管理权。参见 常见问题 了解如何收回域名解析管理权。

请求方法

POST

调用限制

每秒最多调用一次。

请求参数

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

参数名称数据类型参数类型是否必选参数说明
ActionString查询参数API 的名称。该参数的取值是 CheckRetrieveZone
VersionString查询参数API 的版本。该参数的取值是 2018-08-01
ZoneNameString请求正文参数待收回域名解析管理权的域名。域名必须是二级域名,并且不能是泛域名。
RetrieveTypeString请求正文参数收回域名解析管理权的方式。
  • TXT(默认):通过创建一条 TXT 记录收回域名解析管理权。
  • Domain:通过验证该账号是否在 火山引擎域名服务 拥有该域名的所有权的方式在云解析 DNS 中收回域名解析管理权。

响应正文

ResponseMetadata 对象

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

Result 对象

RetrieveType 是 TXT

如果收回域名解析管理权成功,该 API 返回 "Success": "true"。如果收回域名解析管理权失败,该 API 不返回 Result 对象。同时,该 API 通过 ResponseMetadata 对象返回错误消息 type TXT record not found

RetrieveType 是 Domain

如果收回域名解析管理权成功,该 API 返回 "Success": "true"。如果收回域名解析管理权失败,该 API 不返回 Result 对象。同时,该 API 通过 ResponseMetadata 对象返回错误消息 zone not found

示例

请求示例

POST https://open.volcengineapi.com?Version=2018-08-01&Action=CheckRetrieveZone
{
  "ZoneName": "example.com",
  "RetrieveType": "TXT"
}

响应示例:成功收回域名解析管理权

{
    "ResponseMetadata": {
        "RequestId": "20221101155301010225243125056CA34D",
        "Action": "CheckRetrieveZone",
        "Version": "2018-08-01",
        "Service": "dns",
        "Region": "cn-north-1"
    },
    "Result": {
        "Success": "true"
    }
}

响应示例:RetrieveType 是 TXT,收回域名解析管理权失败

{
    "ResponseMetadata": {
        "RequestId": "20211215202125010225243125052DB635",
        "Action": "CheckRetrieveZone",
        "Version": "2018-08-01",
        "Service": "dns",
        "Region": "cn-north-1",
        "Error": {
            "CodeN": 400125,
            "Code": "ErrTXTRecordNotFound",
            "Message": "type txt record not found",
            "MessageCN": "验证记录未找到"
        }
    }
}

响应示例:RetrieveType 是 Domain,收回域名解析管理权失败

{
    "ResponseMetadata": {
        "RequestId": "20211215202125010225243125052DB635",
        "Action": "CheckRetrieveZone",
        "Version": "2018-08-01",
        "Service": "dns",
        "Region": "cn-north-1",
        "Error": {
            "CodeN": 400105,
            "Code": "ErrZoneNotFound",
            "Message": "zone not found",
            "MessageCN": "未找到域名"
        }
    }
}