関連付けられた転送相関を作成します。

説明

ネットワークインスタンス接続を確立した後、ネットワークインスタンス接続とルートテーブルを関連付けるために、関連する転送相関を作成することができます。 次に、ネットワークインスタンス接続は、関連付けられたルートテーブルに基づいてネットワークトラフィックを転送できます。

制限事項

Enterprise Editionのみが関連する転送相関をサポートします。 Enterprise Editionトランジットルーターをサポートするリージョンとゾーンの詳細については、「トランジットルーター」をご参照ください。

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 任意 AssociateTransitRouterAttachmentWithRouteTable

実行したい操作。 値をAssociateTransitRouterAttachmentWithRouteTableに設定します。

TransitRouterAttachmentId String 必須 tr-attach-nls9fzkfat8934****

ネットワークインスタンス接続のID。

TransitRouterRouteTableId String 必須 vtb-bp1dudbh2d5na6b50 ****

Enterprise EditionトランジットルーターのルートテーブルのID。

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

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

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

DryRun Boolean 任意 false

リクエストのみを事前チェックするかどうかを指定します。 チェック項目には、アクセス許可とトランジットルーターのステータスが含まれます。 設定可能な値は以下のとおりです。

  • false (デフォルト): 通常のリクエストを送信します。 リクエストが事前チェックに合格した場合、関連する転送相関が作成されます。
  • true: 事前チェックのリクエストのみを送信します。 リクエストが事前チェックを通過した後、関連する転送の相関は作成されない。このオプションを選択すると、必要なパラメーターが設定されているかどうか、およびリクエスト構文が有効かどうかが確認されます。 リクエストが事前チェックに合格しなかった場合、システムはエラーを返します。 リクエストが事前チェックに合格した場合、システムはリクエストのIDを返します。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 4EC47282-1B74-4534-BD0E-403F3EE64CAF

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/?Action=AssociateTransitRouterAttachmentWithRouteTable
&TransitRouterAttachmentId=tr-attach-nls9fzkfat8934 ****
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50 ****
&<共通リクエストパラメーター>

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

XML 形式 

<AssociateTransitRouterAttachmentWithRouteTableResponse> 
  <RequestId>4EC47282-1B74-4534-BD0E-403F3EE64CAF</RequestId>
</AssociateTransitRouterAttachmentWithRouteTableResponse>

JSON 形式 

{
    "RequestId":"4EC47282-1B74-4534-BD0E-403F3EE64CAF"
    }

エラーコード

HttpCode エラーコード エラーメッセージ 説明
400 AssociationExist.TransitRouterTable 指定された関連付けは既に存在します。 指定されたルートテーブルが関連する転送相関関係に既に関連付けられている場合に返されるエラーメッセージ。
404 InvalidRouteTableId.NotFound 指定されたRouteTableIdが見つかりません。 指定されたルートテーブルIDが存在しない場合に返されるエラーメッセージ。
404 InvalidAttachmentId.NotFound 指定されたAttachmentIdが見つかりません。 指定されたネットワークインスタンス接続IDが存在しない場合に返されるエラーメッセージ。

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