最近更新时间:2024.03.19 19:29:48
首次发布时间:2022.11.24 20:57:30
API 名称:CheckRetrieveZone
。
API 域名:open.volcengineapi.com
。
API 描述:收回域名解析管理权。参见 常见问题 了解如何收回域名解析管理权。
POST
每秒最多调用一次。
除了以下参数,您还需要 对请求进行鉴权。
参数名称 | 数据类型 | 参数类型 | 是否必选 | 参数说明 |
---|---|---|---|---|
Action | String | 查询参数 | 是 | API 的名称。该参数的取值是 CheckRetrieveZone 。 |
Version | String | 查询参数 | 是 | API 的版本。该参数的取值是 2018-08-01 。 |
ZoneName | String | 请求正文参数 | 是 | 待收回域名解析管理权的域名。域名必须是二级域名,并且不能是泛域名。 |
RetrieveType | String | 请求正文参数 | 否 | 收回域名解析管理权的方式。
|
参数名称 | 数据类型 | 参数说明 |
---|---|---|
RequestId | String | 标识本次请求的 ID。 |
Action | String | Action 查询参数的值。 |
Version | String | API 版本。 |
Service | String | 服务类型。 |
Region | String | 服务所在区域。 |
如果收回域名解析管理权成功,该 API 返回 "Success": "true"
。如果收回域名解析管理权失败,该 API 不返回 Result 对象。同时,该 API 通过 ResponseMetadata 对象返回错误消息 type TXT record not found
。
如果收回域名解析管理权成功,该 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" } }
{ "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": "验证记录未找到" } } }
{ "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": "未找到域名" } } }