NAT IPアドレスを削除します。

使用上の注意

  • DeleteNatIpは非同期操作です。 リクエストを行った後、リクエストのIDが返されますが、指定されたNAT IPアドレスは削除されません。 システムはバックグラウンドでNAT IPアドレスを削除します。 ListNatIps操作を呼び出して、NAT IPアドレスのステータスを照会できます。
    • NAT IPアドレスが削除中の場合、NAT IPアドレスは削除中です。 この場合、NAT IPアドレスのみを照会できますが、その他の操作は実行できません。
    • NAT IPアドレスが見つからない場合は削除されます。
  • DeleteNatIp操作を繰り返し呼び出して、指定された期間内にNAT IPアドレスを削除することはできません。

デバッグ

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

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
RegionId String 必須 cn-qingdao

削除するNAT IPアドレスが属するNATゲートウェイのリージョンID。

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

NatIpId String 必須 vpcnatip-gw8y7q3cpk3fggs87 ****

削除するNAT IPアドレスのID。

DryRun Boolean いいえ false

操作を実行せずにリクエストをチェックするかどうかを指定します。 有効な値：

  • true: 操作を実行せずにリクエストをチェックします。 システムは、AccessKeyペア、RAMユーザー権限、および必要なパラメーターをチェックします。リクエストがチェックに合格しなかった場合、対応するエラーメッセージが返されます。 リクエストがチェックに合格すると、DryRunOperationエラーコードが返されます。
  • false: リクエストを送信します。 デフォルト値です。 リクエストが事前チェックを通過すると、2XX HTTPステータスコードが返され、NAT IPアドレスが削除されます。
ClientToken String 任意 5A2CFF0E-5718-45B5-9D4D-70B3FF3898

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを含めることができます。

説明 このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 各APIリクエストのRequestIdは異なる場合があります。
操作 String 必須 DeleteNatIp

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

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String E9AD97A0-5338-43F8-8A80-5E274CCBA11B

リクエストの ID です。

例

リクエストの例

http(s):// [エンドポイント]/?RegionId=cn-qingdao
&NatIpId=vpcnatip-gw8y7q3cpk3fggs87 ****
&DryRun=false
&ClientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF3898
&アクション=DeleteNatIp
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

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

<DeleteNatIpResponse>
    <RequestId>E9AD97A0-5338-43F8-8A80-5E274CCBA11B</RequestId>
</DeleteNatIpResponse>

JSON 形式 

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

{
  "RequestId" : "E9AD97A0-5338-43F8-8A80-5E274CCBA11B"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明　
400 IncorrectStatus.NatIp % s [% s] の状態が正しくありません。 NAT IPアドレスのステータスが無効な場合に返されるエラーメッセージ。
400 DependencyViolation.NatIp 指定された % sのリソースは % sに依存するため、操作を完了できません。 NATゲートウェイがNAT IPアドレスに関連付けられており、操作を実行できない場合に返されるエラーメッセージ。
400 IncorrectStatus.NatGateway % % s [% s] の状態が正しくありません。 NATゲートウェイが無効な状態にある場合に返されるエラーメッセージ。
404 InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。
404 ResourceNotFound.NatIp 指定された % sのリソースが見つかりません。 NAT IPアドレスが見つからない場合に返されるエラーメッセージ。

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