Enterprise Editionトランジットルーターの仮想ボーダールーター (VBR) 接続を削除します。

使用上の注意

DeleteTransitRouterVbrAttachmentは非同期操作です。 リクエストを送信した後、システムはリクエストIDを返しますが、操作はシステムのバックグラウンドで実行中です。 ListTransitRouterVbrAttachmentsを呼び出して、VBR接続のステータスを照会できます。

  • VBR接続がデタッチ状態の場合、VBR接続は削除中です。 VBR接続を照会できますが、他の操作は実行できません。
  • VBR接続が見つからない場合、VBR接続は削除されます。

前提条件

Enterprise EditionトランジットルーターのVBR接続を削除する前に、次の要件が満たされていることを確認してください。

  • 関連する転送の相関関係は、VBR接続とEnterprise Editionトランジットルーターのルートテーブルの間に確立されません。 関連する転送相関を削除する方法の詳細については、「DissociateTransitRouterAttachmentFromRouteTable」をご参照ください。
  • VBR接続とEnterprise Editionトランジットルーターのルートテーブルの間には、ルート学習の相関関係が確立されていません。 ルート学習相関を削除する方法の詳細については、「DisableTransitRouterRouteTablePropagation」をご参照ください。
  • Enterprise Editionトランジットルーターのルートテーブルには、ネクストホップがネットワークインスタンス接続であるカスタムルートエントリが含まれていません。 カスタムルートエントリを削除する方法の詳細については、「DeleteTransitRouterRouteEntry」をご参照ください。
  • Enterprise Editionトランジットルーターのルートテーブルには、ネクストホップがVBR接続であり、プレフィックスリストから生成されるルートは含まれません。 プレフィックスリストからルートテーブルの関連付けを解除することで、このようなルートを削除できます。 詳細については、「DeleteTransitRouterPrefixListAssociation」をご参照ください。

デバッグ

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

リクエストパラメーター

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

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

ClientToken String 任意 02fb3da4-130e-11e9-8e44-001****

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

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

説明 このパラメーターを設定しない場合、ClientTokenRequestIdの値に設定されます。 各APIリクエストのRequestIdの値は異なる場合があります。
TransitRouterAttachmentId String 必須 tr-attach-9nlnjv7by7n7a ****

VBR接続のID。

DryRun Boolean いいえ false

権限やインスタンスのステータスなどの情報を事前チェックするかどうかを指定します。 有効な値:

  • false (デフォルト): リクエストを送信します。 リクエストが事前チェックに合格した場合、VBR接続は削除されます。
  • true: 事前チェックのリクエストのみを送信します。 リクエストが事前チェックを通過した後、VBR接続は削除されません。 この値を使用すると、システムは必要なパラメーターとリクエスト構文をチェックします。 リクエストが事前チェックに合格しなかった場合、エラーメッセージが返されます。 要求がチェックに合格した場合、システムは要求のIDを返します。

レスポンスパラメーター

項目 データ型 例: 説明 
RequestId String 3EDA94DE-0AE5-41FC-A91E-7170E408E0FD

リクエストの ID です。

リクエストの例

http(s)://[Endpoint]/? アクション=DeleteTransitRouterVbrAttachment
&ClientToken=02fb3da4-130e-11e9-8e44-001 ****
&TransitRouterAttachmentId=tr-attach-9nlnjv7by7n7a ****
&DryRun=false
&共通リクエストパラメータ

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

XML 形式

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

<DeleteTransitRouterVbrAttachmentResponse>
<RequestId>3EDA94DE-0AE5-41FC-A91E-7170E408E0FD</RequestId>
</DeleteTransitRouterVbrAttachmentResponse>

JSON 形式

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

{
  "RequestId" : "3EDA94DE-0AE5-41FC-A91E-7170E408E0FD"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明 
400 OperationFailed.RouteTableAssociationExist TransitRouterRouteTableが存在するため、操作に失敗しました 関連付けられた転送相関が設定されているときに操作を実行できない場合に返されるエラーメッセージ。
400 OperationFailed.RouteEntryExist TransitRouterAttachmentがRouteTableに存在するため、操作に失敗しました。 指定されたリージョン間接続がルートテーブルの1つ以上のルートのネクストホップとして指定されている場合、操作を実行できないために返されるエラーメッセージ。

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