DNAT エントリを削除します。

使用上の注意

  • DeleteForwardEntryは非同期操作です。 リクエストを行うと、リクエストのIDが返されますが、指定されたDNATエントリは削除されません。 システムはバックグラウンドでエントリを削除します。 DescribeForwardTableEntriesを呼び出して、DNATエントリのステータスを照会できます。
    • DNATエントリがDeleting状態の場合、システムはDNATエントリを削除しています。 この場合、DNATエントリのステータスのみを照会できますが、他の操作は実行できません。
    • DNATエントリが見つからない場合は、削除されます。
説明 DNATテーブルにPending状態のDNATエントリがある場合、DNATエントリを削除することはできません。
  • DeleteForwardEntryを繰り返し呼び出して、指定された期間内にDNATエントリを削除することはできません。

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

NATゲートウェイのリージョンID。

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

ForwardTableId String 必須 ftb-8vbx8xu2lqj9qb334 ****

DNATエントリが属するDNATテーブルのID。

ForwardEntryId String 必須 fwd-8vbn3bc8roygjp0gy ****

削除するDNATエントリのID。

ClientToken String 任意 123e4567-e89b-12d3-a456-426655440000

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

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

説明 このパラメーターを指定しない場合、システムはRequestIdをClientTokenとして使用します。 RequestIdは、APIリクエストごとに異なる場合があります。

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/?Action=DeleteForwardEntry
&RegionId=cn-hangzhou
&ForwardTableId=ftb-8vbx8xu2lqj9qb334 ****
&ForwardEntryId=fwd-8vbn3bc8roygjp0gy ****
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&共通リクエストパラメータ

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

XML 形式 

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

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

JSON 形式 

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

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

エラーコード

HttpCode エラーコード エラーメッセージ 説明　
400 IncorretForwardEntryStatus 一部のForward entryステータスがこの操作をブロックしました。 指定された操作を実行する権限がない場合に返されるエラーメッセージ。 DNATテーブルの1つ以上のDNATエントリがPendingまたはModifying状態にある場合に返されるエラーメッセージ。
400 IncorretForwardEntryStatus 指定された forwardEntry は存在しません 指定されたDNATエントリが存在しない場合に返されるエラーメッセージ。
400 MissingParameter 必須パラメータがありません 1つ以上の必須パラメーターが設定されていない場合に返されるエラーメッセージ。 この操作を呼び出す前に、必要なパラメーターをすべて設定しているかどうかを確認してください。
400 IncorrectStatus.NATGW 指定されたNAT gatewayのステータスが異常です。 NATゲートウェイが無効な状態にある場合に返されるエラーメッセージ。
400 IncorrectStatus.ForwardEntry % s [% s] の状態が正しくありません。 削除するDNATエントリが無効な状態の場合に返されるエラーメッセージ。
404 InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。
404 InvalidForwardEntryId.NotFound 指定された転送エントリIDが存在しません 指定されたDNATエントリが存在しない場合に返されるエラーメッセージ。
404 InvalidForwardTableId.NotFound 指定された転送テーブルは存在しません。 指定されたDNATテーブルが存在しない場合に返されるエラーメッセージ。 パラメーターを確認して、もう一度お試しください。

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