文档中心

NAT网关

DeleteNatGateway - 删除NAT网关

调用 DeleteNatGateway 接口，删除NAT网关实例。

使用说明

使用本接口删除NAT网关，必须同时满足如下条件：

NAT网关为按量计费，或包年包月NAT网关已到期。包年包月NAT网关到期前不支持删除，若需要提前释放，请参考退订说明。

NAT网关下没有SNAT规则。更多操作，请参考 DescribeSnatEntries 和 DeleteSnatEntry。

NAT网关下没有DNAT规则。更多操作，请参考 DescribeDnatEntries 和 DeleteDnatEntry。

NAT网关未绑定公网IP。更多操作，请参考 DescribeNatGatewayAttributes 和 DisassociateEipAddress 。

NAT网关未被其他云服务托管。若被托管，请根据托管系统标签和对应云服务确认不再使用NAT网关后，解除托管。

将NAT网关托管给云服务，云服务可以使用NAT网关的功能，并控制NAT网关的权限，即用户只能查看和修改托管NAT网关，不能删除NAT网关。

NAT网关被云服务托管时，会被添加标签键（key）为volc:{ServiceCode}:ServiceManaged的托管系统标签，该标签键如volc:vke:ServiceManaged。

调试

API Explorer

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

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DeleteNatGateway

要执行的操作，取值：DeleteNatGateway。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

NatGatewayId string 必选示例值：ngw-vv3t043k05sm****

NAT网关的ID。

您可以调用 DescribeNatGateways接口，查询NAT网关的ID。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

RequestId string 示例值：2021062415303301022514515207C4****

请求ID。

请求示例

GET /?Action=DeleteNatGateway&Version=2020-04-01&NatGatewayId=ngw-vv3t043k05sm**** HTTP/1.1​
Host: natgateway.cn-beijing.volcengineapi.com​
Service: natgateway​
Region: cn-beijing​

返回示例

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

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter	The request is missing a required parameter.	该请求缺少必要参数。
400	InvalidNatGateway.InvalidBillingType	The specified NAT gateway is not in the correct billing type for the request.	指定的NAT网关所处计费类型无法响应该请求。
400	InvalidNatGateway.InvalidStatus	The specified NAT gateway is not in the correct status for the request.	指定的NAT网关所处的状态无法响应该请求。
400	InvalidNatGateway.InUse	The specified NAT gateway has dependent resource of an EIP.	指定的NAT网关已经绑定EIP，无法删除。
400	InvalidNatGateway.InUse	The specified NAT gateway has dependent resource of ip bandwidth limit rule.	指定的NAT网关残留ip限速规则，无法删除。
403	Forbidden	You are not authorized to perform operations on the specified NAT gateway. The specified NAT gateway is a service-managed NAT gateway.	无权限对指定NAT网关进行操作。指定的NAT网关为服务管控NAT网关。
404	InvalidNatGateway.NotFound	The specified NAT gateway does not exist.	指定的NAT网关不存在。
409	InvalidOperation.Conflict	The specified resource operation conflicts.	指定的资源操作冲突。
412	InvalidNatGateway.DependenceDnatEntryExist	The specified NAT gateway has a dependency on DNAT entry.	指定的NAT网关与DNAT规则有依赖，无法响应该请求。
412	InvalidNatGateway.DependenceSnatEntryExist	The specified NAT gateway has a dependency on SNAT entry.	指定的NAT网关与SNAT规则有依赖，无法响应该请求。
412	InvalidNatGateway.DependenceNatIPExist	The specified NAT gateway has a dependency on nat ip.	指定的NAT网关与NAT IP有依赖，无法响应该请求。
500	InternalError	An internal error has occurred.	发生内部错误。

最近更新时间：2026.03.27 17:44:42

这个页面对您有帮助吗？

有用

无用