批量删除自定义线路。
如果您需要删除的自定义线路被一条或多条解析记录使用,则删除会失败。您可以通过 ListRecordDigestByLine API 查询使用该自定义线路的所有解析记录。
请求频率:每秒最多调用 1 次。
除了以下参数,您还需要 对请求进行鉴权。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | BatchDeleteCustomLine | 要执行的操作,取值:BatchDeleteCustomLine。 |
Version | String | 是 | 2018-08-01 | API的版本,取值:2018-08-01。 |
Lines | Array of String | 是 | custom-101 | 一个或多个自定义线路的 ID。您可以通过 ListCustomLines API 所返回的 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
TotalCount | Integer | 1 | 被删除的自定义线路总数。 |
POST /?Action=BatchDeleteCustomLine&Version=2018-08-01 HTTP/1.1 Host: open.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20240909T090423Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240909/cn-beijing/dns/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "Lines": [ "custom-101" ] }
{ "ResponseMetadata": { "RequestId": "20240909170431015116161145DFD1E1", "Action": "BatchDeleteCustomLine", "Version": "2018-08-01", "Service": "dns", "Region": "cn-beijing" }, "Result": { "TotalCount": 1 } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
---|---|---|
400 | ErrParsingParams | 解析请求失败。 |
400 | ErrParamInvalid | 参数校验失败。 |
400 | ErrDBNotFound | 数据库条目未找到。 |
500 | ErrInternalServer | 服务内部错误。 |