指定されたインターネットNATゲートウェイまたはVirtual Private Cloud (VPC) NATゲートウェイを削除します。

使用上の注意

  • DeleteNatGatewayは非同期操作です。 リクエストを行った後、リクエストのIDが返されますが、NATゲートウェイは削除されません。 システムはバックグラウンドでNATゲートウェイを削除します。 DescribeNatGatewaysを呼び出して、NATゲートウェイのステータスを照会できます。
    • NAT gatewayが [Deleting] 状態の場合、NAT gatewayは削除中です。 この場合、NAT gatewayを照会できますが、他の操作は実行できません。

    • NAYゲートウェイが見つからない場合、NATゲートウェイは削除されます。

      NAT gatewayを削除すると、NAT gatewayを復元できなくなります。 操作は慎重に行ってください。

  • DeleteNatGatewayを繰り返し呼び出して、指定された期間内にNATゲートウェイを削除することはできません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 DeleteNatGateway

実行する操作です。 値をDeleteNatGatewayに設定します。

RegionId String 必須 cn-hangzhou

NATゲートウェイがデプロイされているリージョンのID。

DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

NatGatewayId String 必須 ngw-bp1uewa15k4iy5770 ****

削除するNATゲートウェイのID。

フォース Boolean いいえ false

NAT gatewayを強制削除するかどうかを指定します。 有効な値：

  • true: yes値をtrueに設定した場合:
    • NATゲートウェイにSNATエントリがある場合、システムはそれらを自動的に削除します。
    • NATゲートウェイにDNATエントリがある場合、システムはそれらを自動的に削除します。
    • NATゲートウェイがelastic IPアドレス (EIP) に関連付けられている場合、システムはEIPをNATゲートウェイから自動的に分離します。
    • NATゲートウェイがNAT帯域幅プランに関連付けられている場合、システムは自動的にNAT帯域幅プランとNATゲートウェイの関連付けを解除します。
  • false (デフォルト): no値をfalseに設定した場合:
    • NAT gatewayがNAT帯域幅プランに関連付けられている場合は、まずNAT gatewayをNAT帯域幅プランから切り離します。
    • NAT gatewayにSNATエントリがある場合は、まず削除します。
    • NATゲートウェイにDNATエントリがある場合は、まず削除します。
    • NATゲートウェイがEIPに関連付けられている場合は、まずNATゲートウェイから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. Bandwidthパッケージ 指定されたNatGatewayに削除されないBandwidthPackagesがあります。 1つ以上のNAT帯域幅プランがNATゲートウェイに関連付けられている場合に返されるエラーメッセージ。 NAT gatewayからすべてのNAT帯域幅プランの関連付けを解除し、再試行します。
400 IncorrectStatus.NatIp % s [% s] の状態が正しくありません。 NAT IPアドレスのステータスが無効な場合に返されるエラーメッセージ。
404 InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。
404 InvalidNatGatewayId.NotFound 指定された NatGatewayId はレコードに存在しません。 指定されたNATゲートウェイIDが存在しない場合に返されるエラーメッセージ。 NatGatewayIdパラメーターの値が有効かどうかを確認します。

エラーコードリストについては、「API エラーセンター」をご参照ください。