DeleteSubnet--私有网络-火山引擎

文档中心

导航

DeleteSubnet

最近更新时间：2024.10.08 17:58:24首次发布时间：2021.07.29 14:11:53

调用 DeleteSubnet 接口，删除指定的子网。

调用说明

前提条件	说明
子网内无网卡	您可调用 DescribeNetworkInterfaces 接口，查看是否存在网卡。若存在，可调用 DeleteNetworkInterface 接口删除网卡。
子网未关联SNAT规则	您可调用 DescribeSnatEntries 接口，查看是否关联SNAT规则。若已关联，可调用 DeleteSnatEntry 接口删除SNAT规则。
子网无高可用虚拟IP	您可调用 DescribeHaVips 接口，查看是否存在高可用虚拟IP。若存在，可调用 DeleteHaVip 接口删除高可用虚拟IP。
子网未关联网络ACL	您可调用 DescribeSubnets 接口，查看是否关联网络ACL。若存在，可调用 DisassociateNetworkAcl 接口与网络ACL解除关联。

DeleteSubnet 为异步接口，即返回请求ID时，系统后台仍在删除。您可调用 DescribeSubnetAttributes 查看子网的状态，Pending表示删除中，查看失败表示删除成功。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数名称	类型	是否必选	示例值	描述
Action	String	是	DeleteSubnet	要执行的操作，取值： DeleteSubnet。
Version	String	是	2020-04-01	API版本信息，取值为：2020-04-01。
SubnetId	String	是	subnet-bp15zckdt37pq72zv****	待删除子网的ID。您可以调用 DescribeSubnets 接口，查询子网的ID。

返回数据

参数名称	类型	示例值	描述
RequestId	String	2021062415303301022514515207C4****	请求ID。

请求示例

GET /?Action=DeleteSubnet&Version=2020-04-01&SubnetId=subnet-bp15zdt37pq72zv**** HTTP/1.1
Host: open.volcengineapi.com
Service: vpc
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021062415303301022514515207C4****",
        "Action": "DeleteSubnet",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-beijing"
    },
   "Result": {
        "RequestId": "2021062415303301022514515207C4****"
    }
}

错误码

此处仅展示当前API的错误码，更多错误码请参见公共错误码。

HttpCode	错误码	错误信息	描述
400	InvalidCen.InvalidStatus	The CEN that the specified VPC attached to is not in the correct status for the request.	VPC关联的CEN实例所处的状态无法响应请求，请稍后再试。
400	InvalidSubnet.InUse	The specified subnet has dependent resource of an elastic network interface.	指定的子网包含网卡，无法删除。
400	InvalidSubnet.InUse	The specified subnet has dependent resource of an SNAT entry.	指定的子网包含SNAT规则，无法删除。
400	InvalidSubnet.InUse	The specified subnet is associated with Network ACL.	指定的子网被网络ACL关联，无法删除。
400	InvalidSubnet.InUse	The specified subnet has dependent resource of an HaVip.	指定的子网包含高可用虚拟IP，无法删除。
400	InvalidSubnet.InvalidStatus	The specified subnet is not in the correct status for the request.	指定的子网所处的状态无法响应该请求。
400	InvalidVpc.InvalidStatus	The specified VPC is not in the correct status for the request.	指定的VPC所处状态无法响应该请求。
404	InvalidSubnet.NotFound	The specified subnet does not exist.	指定的子网不存在。