删除一个指定的域名。
您只能删除免费版的域名。您无法删除其他功能版本的域名。
请求频率:每秒最多调用 5 次。
除了以下参数,您还需要 对请求进行鉴权。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DeleteZone | 要执行的操作,取值:DeleteZone。 |
Version | String | 是 | 2018-08-01 | API的版本,取值:2018-08-01。 |
ZID | Long | 是 | 1234 | 需要删除的域名的 ID。您可以通过 CreateZone API 或 ListZones API 获取域名 ID。 |
本接口无特有的返回参数。更多信息请见返回结构。
POST /?Action=DeleteZone&Version=2018-08-01 HTTP/1.1 Host: open.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20240831T112648Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240831/cn-beijing/dns/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "ZID": 1234 }
{ "ResponseMetadata": { "RequestId": "20240831192656196201007248BD7224", "Action": "DeleteZone", "Version": "2018-08-01", "Service": "dns", "Region": "cn-beijing" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | ErrParsingParams | parsing params error | 解析请求失败。 |
400 | ErrParamInvalid | validation fail:%s | 参数校验失败。 |
400 | ErrDBNotFound | record not found :%s | 数据库条目未找到。 |
400 | ErrZoneNotFound | zone not found | 未找到域名。 |
400 | ErrVipZoneCanNotBeDeleted | vip zone can not be deleted | 付费版域名不支持删除。 |
500 | ErrInternalServer | server internal error | 服务内部错误。 |