ルート学習相関を作成します。

説明

トランジットルーターでネットワークインスタンス接続を確立した後、ネットワークインスタンス接続のルート学習相関を作成できます。 次に、接続されたネットワークインスタンスのルートが、トランジットルーターのルートテーブルに自動的に通知されます。

制限事項

ルート学習相関は、Enterprise Editionトランジットルーターでのみ作成できます。 Enterprise Editionトランジットルーターをサポートするリージョンとゾーンの詳細については、「トランジットルーター」をご参照ください。

デバッグ

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

リクエストパラメーター

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

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

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

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

TransitRouterRouteTableId String 必須 vtb-bp1dudbh2d5na6b50 ****

Enterprise Editionトランジットルーターに属するルートテーブルのID。

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

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

You can use the client to generate a token, but you must make sure that it is unique among different requests. トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。

DryRun Boolean 任意 false

リクエストのみを事前チェックするかどうかを指定します。 Check items include permissions and the status of the transit router. 設定可能な値は以下のとおりです。

  • false (デフォルト): 通常のリクエストを送信します。 リクエストが事前チェックに合格すると、ルート学習相関が作成されます。
  • true: 事前チェックのリクエストのみを送信します。 リクエストが事前チェックを通過した後、ルート学習相関は作成されません。 If you select this option, the system checks whether the required parameters are set, and whether the request syntax is valid. リクエストが事前チェックに合格しなかった場合、システムはエラーを返します。 リクエストが事前チェックに合格した場合、システムはリクエストのIDを返します。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 59CF8BF9-DE61-421E-B903-D56AF46A303C

リクエストの ID です。

例

リクエストの例

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

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

XML 形式 

<EnableTransitRouterRouteTablePropagationResponse> 
  <RequestId>59CF8BF9-DE61-421E-B903-D56AF46A303C</RequestId>
</EnableTransitRouterRouteTablePropagationResponse>

JSON 形式 

{
  "RequestId": "59CF8BF9-DE61-421E-B903-D56AF46A303C"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明
404 InvalidRouteTableId.NotFound 指定されたRouteTableIdが見つかりません。 指定されたルートテーブルIDが存在しない場合に返されるエラーメッセージ。
404 InvalidAttachmentId.NotFound The specified AttachmentId is not found. 指定されたAttachmentIdが存在しない場合に返されるエラーメッセージ。

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