调用DeleteNatGateway接口删除指定的公网NAT网关或VPCNAT网关

使用说明

DeleteNatGateway接口属于异步接口，即系统会先返回一个请求ID，但该NAT网关实例并未删除完成，系统后台的删除任务仍在进行。您可以调用DescribeNatGateways查询NAT网关的状态：
- 当NAT网关处于Deleting状态时，表示NAT网关正在删除中，在该状态下，您只能执行查询操作，不能执行其他操作。
- 当查询不到该NAT网关实例时，表示NAT网关删除完成。
  
  删除NAT网关操作不可恢复，请您谨慎操作。
DeleteNatGateway接口在同一个NAT网关内不支持并发删除NAT网关。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DeleteNatGateway	系统规定参数。取值：DeleteNatGateway。
RegionId	String	是	cn-hangzhou	NAT网关所在的地域ID。您可以通过调用DescribeRegions接口获取地域ID。
NatGatewayId	String	是	ngw-bp1uewa15k4iy5770****	要删除的NAT网关的实例ID。
Force	Boolean	否	false	是否强制删除NAT网关，取值： true：强制删除。当取值为true时，说明如下：如果NAT网关有SNAT规则，系统会自动帮您删除SNAT规则。如果NAT网关有DNAT规则，系统会自动帮您删除DNAT规则。如果NAT网关有绑定EIP，系统会自动帮您解绑。如果NAT网关有未删除的NAT带宽包，系统会自动帮您删除NAT带宽包。 false（默认值）：不强制删除。当取值为false时，说明如下：如果NAT网关有未删除的NAT带宽包，请先删除NAT带宽包。如果NAT网关有SNAT规则，请先删除SNAT规则。如果NAT网关有DNAT规则，请先删除DNAT规则。如果NAT网关有绑定EIP，请先解绑EIP。

返回数据


名称	类型	示例值	描述
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DeleteNatGateway
&RegionId=cn-hangzhou
&NatGatewayId=ngw-bp1uewa15k4iy5770****
&Force=false
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteNatGatewayResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</DeleteNatGatewayResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

错误码


HttpCode	错误码	错误信息	描述
400	DependencyViolation.BandwidthPackages	There are BandwidthPackages on specified NatGateway not deleted.	NAT网关上有尚未删除的带宽包，请删除NAT网关下的所有带宽包后再重新操作。
400	IncorrectStatus.NatIp	The status of %s [%s] is incorrect.	NatIp当前状态不正确。
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.	指定的RegionId不存在。
404	InvalidNatGatewayId.NotFound	The specified NatGatewayId does not exist in our records.	指定的 NatGatewayId 不存在，请您检查填写的 NatGatewayId 是否正确。

访问错误中心查看更多错误码。