调用 DeletePrefixList 接口，删除前缀列表。 ## 调用说明 * 前缀列表未关联安全组或路由表。若已关联，请参考 [修改安全组规则](https://www.volcengine.com/docs/6401/68895#%E4%BF%AE%E6%94%B9%E5%AE%89%E5%85%A8%E7%BB%84%E8%A7%84%E5%88%99) 和 [删除路由条目](https://www.volcengine.com/docs/6401/68874#%E5%88%A0%E9%99%A4%E8%B7%AF%E7%94%B1%E6%9D%A1%E7%9B%AE)。 * DeletePrefixList 为异步接口，即返回请求ID时，系统后台仍在删除。您可调用 [DescribePrefixLists](https://www.volcengine.com/docs/6401/1124629) 查看网卡的状态，`Deleting`表示创建中，查看失败表示删除完成。 ## 调试 ## 请求参数 |参数名称 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Action |String |是 |DeletePrefixList |要执行的操作，取值：DeletePrefixList。 | |Version |String |是 |2020\-04\-01 |API版本信息，取值为：2020\-04\-01。 | |PrefixListId |String |是 |pl\-bp1fg655nh68xyz9\*\*\*\* |要删除的前缀列表的ID。|\ | | | | |您可以调用 [DescribePrefixLists](https://www.volcengine.com/docs/6401/1124629) 接口，查询前缀列表的ID。 | |ClientToken |String |否 |123e4567\-e89b\-12d3\-a456\-42665544\*\*\*\* |客户端Token，用于保证请求幂等性。|\ | | | | ||\ | | | | |* 由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。|\ | | | | |* 仅支持ASCII字符，且不能超过64个字符。|\ | | | | |* 若不传入ClientToken，则此次API调用不进行幂等校验。 | |DryRun |Boolean |否 |false |是否只预检此次请求。|\ | | | | |请严格按照以下枚举值的大小写输入，不要传入其他取值。|\ | | | | ||\ | | | | |* true：发送检查请求，不会删除前缀列表。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。|\ | | | | |* false（默认值）：发送正常请求，通过检查后返回HTTP 2xx状态码并直接删除前缀列表。 | ## 返回数据 |参数名称 |类型 |示例值 |描述 | |---|---|---|---| |RequestId |String |2021062415303301022514515207C4\*\*\*\* |请求ID。 | ## 请求示例 ```Plain Text GET /?Action=DeletePrefixList&Version=2020-04-01&NetworkInterfaceId=eni-bp1fgnh68xyz9**** HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing ``` ## 返回示例 ```Plain Text { "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "DeletePrefixList", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result": { "RequestId": "2021062415303301022514515207C4****" } } ``` ## 错误码此处仅展示当前API的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6401/70814)。 |HttpCode |错误码 |错误信息 |描述 | |---|---|---|---| |400 |DryRunOperation |Exception raised to indicate a successfully authorized action when the DryRun flag is set to true. |该请求设置为DryRun操作，操作授权已获得许可，但未被实际执行。 | |400 |IdempotentParameterMismatch |Arguments on this idempotent request are inconsistent with arguments used in previous request(s). |此幂等请求的参数与前一个请求中使用的参数不一致。 | |400 |InvalidParameter.ClientTokenMalformed |The specified parameter ClientToken is malformed. |指定的参数ClientToken格式不合法，长度不能超过64个ASCII字符。 | |400 |InvalidPrefixList.InUse |The specified prefix list is in use, and can't be deleted. |指定的前缀列表在使用中，无法删除。 | |400 |InvalidPrefixList.InvalidStatus |The specified prefix list is not in the correct status for the request. |指定的前缀列表所处状态无法响应该请求。 | |404 |InvalidPrefixList.NotFound |The specified prefix list does not exist. |指定的前缀列表不存在。 | |412 |IdempotentProcessing |The request uses the same client token as a previous one that is still in process. |幂等请求处理中。 |

私有网络