CENインスタンスのルーティングポリシーを作成します。

使用上の注意

ルーティングポリシーを設定して、ルートをフィルタリングおよび変更できます。 これにより、クラウド内のネットワーク通信を管理できます。

ルーティングポリシーは優先順位でソートされます。 値が小さいほど、優先度が高くなります。 各ルーティングポリシーは、条件文と実行文の集まりです。 最も高い優先度を有するルーティングポリシーから開始して、システムは、ルーティングポリシーによって指定されたマッチ条件に対してルートをマッチさせる。 ルートがルーティングポリシーのすべての一致条件を満たす場合、システムはルーティングポリシーで指定されたアクションに基づいてルートを許可または拒否します。 許可されたルートの属性を変更することもできます。 デフォルトでは，いずれの一致条件も満たさない経路を許可します。 詳細については、「ルーティングポリシーの概要」をご参照ください。

デバッグ

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

リクエストパラメーター

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

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

CenId String 必須 cen-7qthudw0ll6jmc****

CEN インスタンスの ID。

CenRegionId String 必須 cn-hangzhou

ルーティングポリシーが適用されるリージョンのID。

DescribeChildInstanceRegionsを呼び出して、最新のリージョンリストを照会できます。

TransmitDirection String 必須 RegionIn

ルーティングポリシーが適用される方向。 設定可能な値は以下のとおりです。

  • RegionIn: ルートは、CENインスタンスによって接続されているリージョンのゲートウェイにアドバタイズされます。

    たとえば、ルートは、現在のリージョンまたは他のリージョンにデプロイされたネットワークインスタンスから、現在のリージョンにデプロイされたゲートウェイに通知されます。

  • RegionOut: ルートは、CENインスタンスによって接続されているリージョンのゲートウェイからアドバタイズされます。

    たとえば、ルートは、現在のリージョンにデプロイされているゲートウェイから、同じリージョンにデプロイされているネットワークインスタンス、または他のリージョンにデプロイされているゲートウェイに通知されます。

説明 String 任意 desktest

ルーティングポリシーの説明を入力します。

説明は2 ~ 256文字で、英数字、ハイフン (-) 、ピリオド (.) 、アンダースコア (_) を使用できます。 文字で始める必要があり、http:// またはhttps:// で始めることはできません。

Priority Integer 必須 3

ルーティングポリシーの優先度。有効な値: 1 to 100. 値が小さいほど、優先度が高くなります。

説明 同じリージョンと方向で適用されるルーティングポリシーに同じ優先度を指定することはできません。 システムは、優先度の高い順にルーティングポリシーの一致条件に対してルートを一致させます。 値が小さいほど、優先度が高くなります。 優先順位を適切な値に設定する必要があります。
MapResult String 必須 Permit

すべての一致条件を満たすルートで実行されるアクション。 設定可能な値は以下のとおりです。

  • 許可: ルートは許可されています。
  • 拒否: ルートは拒否されます。
NextPriority Integer 任意 20

現在のルーティングポリシーに関連付けるルーティングポリシーの優先度を指定します。

  • このパラメーターは、MapResultパラメーターが [許可] に設定されている場合にのみ有効です。 このように、許可されたルートは、次のルーティングポリシーと照合される。
  • 関連付けるルーティングポリシーのリージョンと方向は、現在のルーティングポリシーと同じである必要があります。
  • 次のルーティングポリシーの優先度は、現在のルーティングポリシーの優先度よりも低くなければなりません。
CidrMatchMode String 任意 Include

プレフィックスに基づいてルートを照合するために使用されるmatchメソッド。 設定可能な値は以下のとおりです。

  • 含める: あいまい一致。 経路プレフィックスが一致条件に含まれる場合、経路は一致となる。

    たとえば、一致条件を10.10.0.0/16に設定し、ファジー一致が有効になっている場合、プレフィックスが10.10.1.0/24のルートは一致します。

  • Complete: 完全一致。経路は，経路のプレフィックスが一致条件で指定したプレフィックスと同じ場合に限り，一致とする。

    たとえば、一致条件を10.10.0.0/16に設定し、完全一致が有効になっている場合、プレフィックスが10.10.0.0/16の場合にのみルートが一致します。

AsPathMatchMode String 任意 Include

ASパスに基づいてルートを照合するために使用される照合方法。 設定可能な値は以下のとおりです。

  • 含める: あいまい一致。 ルートのASパスが一致条件で指定されたASパスと重複する場合、ルートは一致します。
  • Complete: 完全一致。 経路の AS パスが，一致条件で指定した AS パスと同じ場合に限り，一致とします。
CommunityMatchMode String 任意 Include

コミュニティに基づいてルートを照合するために使用される照合方法。 設定可能な値は以下のとおりです。

  • 含める: あいまい一致。 経路のコミュニティが，マッチ条件に指定したコミュニティと重複している場合，マッチとなります。
  • Complete: 完全一致。 ルートは、ルートのコミュニティが一致条件で指定されたコミュニティと同じである場合にのみ一致します。
CommunityOperateMode String 任意 Additive

ルートのコミュニティで実行されるアクション。 設定可能な値は以下のとおりです。

  • Additive: コミュニティをルートに追加します。
  • Replace: ルートの元のコミュニティを置き換えます。

このパラメータは、ルートが一致条件を満たしたときに実行されるアクションを指定します。

Preference Integer 任意 50

ルートの新しい優先度。

有効な値: 1〜100。 デフォルトの優先度は50です。 値が小さいほど、優先度が高くなります。

本パラメータは，経路が一致条件に合致したときに実行する動作を指定する。
SourceInstanceIdsReverseMatch Boolean 任意 false

移行元ネットワークインスタンスIDを除外するかどうかを指定します。 設定可能な値は以下のとおりです。

  • false (default value): で指定したリストに、送信元のネットワークインスタンスIDが含まれていれば、その経路は一致する。 SourceInstanceIds.N.
  • true: ソースネットワークインスタンスIDがSourceInstanceIds.Nで指定されたリストにない場合、ルートは一致します。
DestinationInstanceIdsReverseMatch Boolean 任意 false

宛先ネットワークインスタンスIDを除外するかどうかを指定します。 設定可能な値は以下のとおりです。

  • false (デフォルト値): 宛先ネットワークインスタンスIDがDestinationInstanceIds.Nで指定されたリストにある場合、ルートは一致します。
  • true: 宛先ネットワークインスタンスIDがDestinationInstanceIds.Nで指定されたリストにない場合、ルートは一致します。
TransitRouterRouteTableId String 任意 vtb-gw8nx3515m1mbd1z1 ****

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

ルートテーブルIDを指定しない場合、ルーティングポリシーはトランジットルーターのデフォルトルートテーブルに自動的に関連付けられます。

SourceInstanceIds.N String 任意 vpc-adeg3544fdf34vf ****

ルートが属するソースネットワークインスタンスのID。 次のネットワークインスタンスタイプがサポートされています。

  • 仮想プライベートクラウド (VPC)
  • 仮想ボーダールーター (VBR)
  • Cloud Connect Network (CCN) インスタンス
  • Smart Access Gateway (SAG) インスタンス

最大32のネットワークインスタンスIDを入力できます。

DestinationInstanceIds.N String 任意 vpc-afrfs434465fdf ****

ルートが属する宛先ネットワークインスタンスのID。 次のネットワークインスタンスタイプがサポートされています。

  • VPC
  • VBR
  • CCNインスタンス
  • SAGインスタンス

最大32のネットワークインスタンスIDを入力できます。

説明 宛先ネットワークインスタンスIDは、現在のリージョンのゲートウェイから現在のリージョンのネットワークインスタンスにルートが通知されるシナリオにルーティングポリシーが適用されている場合にのみ有効です。
SourceRouteTableIds.N String 任意 vtb-adfr233vf34rvd4 ****

ルートが属するソースルートテーブルのID。 最大32のルートテーブルIDを入力できます。

DestinationRouteTableIds.N String 任意 vtb-adefrgtr144vf ****

ルートが属する宛先ルートテーブルのID。 最大32のルートテーブルIDを入力できます。

説明 宛先ルートテーブルIDは、現在のリージョンのゲートウェイから現在のリージョンのルートテーブルにルートが通知されるシナリオにルーティングポリシーが適用されている場合にのみ有効です。
SourceRegionIds.N String 任意 cn-beijing

ルートが属するソースリージョンのID。 最大32のリージョンIDを入力できます。

DescribeChildInstanceRegionsを呼び出して、最新のリージョンリストを照会できます。

SourceChildInstanceTypes.N String 任意 VPC

ルートが属するソースネットワークインスタンスのタイプ。 次のタイプのネットワークインスタンスがサポートされています。

  • VPC: VPC
  • VBR：VBR
  • CCN: CCNインスタンス

1つ以上のネットワークインスタンスタイプを指定できます。

DestinationChildInstanceTypes.N String 任意 VPC

ルートが属する宛先ネットワークインスタンスのタイプ。 次のタイプのネットワークインスタンスがサポートされています。

  • VPC: VPC
  • VBR：VBR
  • CCN: CCNインスタンス

1つ以上のネットワークインスタンスタイプを指定できます。

説明 宛先ネットワークインスタンスタイプは、現在のリージョンのゲートウェイから現在のリージョンのネットワークインスタンスにルートが通知されるシナリオにルーティングポリシーが適用されている場合にのみ有効です。
DestinationCidrBlocks.N String 任意 10.10.10.0/24

ルートのプレフィックス。

IPアドレスはCIDR表記で指定する必要があります。 最大32のCIDRブロックを入力できます。

RouteTypes.N String 任意 System

比較するルートのタイプ。 有効な値: 次のルートタイプがサポートされています。

  • System: システムによって自動的に生成されるシステムルート。
  • カスタム: 手動で追加されるカスタムルート。
  • BGP: Border Gateway Protocol (BGP) を介してアドバタイズされるルート。

複数のルートタイプを指定できます。

MatchAsns.N Long 任意 65501

どのルートが比較されるかに基づくASパス。

最大32のAS番号を指定できます。

説明 AS-SEQUENCEパラメータのみがサポートされています。 AS-SET、AS-CONFED-SEQUENCE、およびAS-CONFED-SETパラメーターはサポートされていません。 すなわち、AS番号リストのみがサポートされる。 セットとサブリストはサポートされていません。
MatchCommunitySet.N String 任意 65501:1

比較されるルートに基づくコミュニティセット。

フォーマットでコミュニティを指定する。n:m. nとmの有効値: 1〜65535。 各コミュニティは、RFC 1997標準に準拠する必要があります。 Border Gateway Protocol (BGP) の大規模コミュニティを定義するRFC 8092標準はサポートされていません。

最大32のコミュニティを指定できます。

説明 コミュニティの設定が正しくない場合、ルートがデータセンターにアドバタイズされない可能性があります。
OperateCommunitySet.N String 任意 65501:1

アクションが実行されるコミュニティセット。

コミュニティをn:mの形式で指定します。 nとmの有効値: 1〜65535。 Each community must comply with RFC 1997. BGPラージコミュニティを定義するRFC 8092標準はサポートされていません。

最大32のコミュニティを指定できます。

説明 コミュニティの設定が正しくない場合、ルートがデータセンターにアドバタイズされない可能性があります。
PrependAsPath.N Long 任意 65501

リージョナルゲートウェイがルートを受信またはアドバタイズするときに、アクションステートメントを使用して先頭に追加されるASパス。

ASパスは、ルーティングポリシーが適用される方向によって異なります。

  • 受信方向に適用されるルーティングポリシーの先頭にASパスが追加されている場合は、ソースネットワークインスタンスIDとソースリージョンを一致条件で指定する必要があります。 さらに、ソースリージョンは、ルーティングポリシーが適用されるリージョンと同じである必要があります。
  • アウトバウンド方向に適用されるルーティングポリシーの先頭にASパスが追加されている場合、一致条件で宛先ネットワークインスタンスIDを指定する必要があります。

このパラメータは、ルートが一致条件を満たしたときに実行されるアクションを指定します。 最大32のAS番号を指定できます。

レスポンスパラメーター

パラメーター データ型 例 説明
RouteMapId String cenrmap-w4yf7toozfol3q****

ルーティングポリシーの ID。

RequestId String 62172DD5-6BAC-45DF-8D44-56SDF467BAC

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/?Action=CreateCenRouteMap
&CenId=cen-7qthudw0ll6jmc ****
&CenRegionId=cn-hangzhou
&優先度=3
&TransmitDirection=RegionIn
&MapResult=許可
&<共通リクエストパラメーター>

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

XML 形式 

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

<CreateCenRouteMapResponse>
<RequestId>62172DD5-6BAC-45DF-8D44-56SDF467BAC</RequestId>
<RouteMapId>cenrmap-w4yf7toozfol3q ****</RouteMapId>
</CreateCenRouteMapResponse>

JSON 形式 

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

{
  "RequestId" : "62172DD5-6BAC-45DF-8D44-56SDF467BAC" 、
  "RouteMapId" : "cenrmap-w4yf7toozfol3q ****"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明
400 禁じられた。CenRouteMapExist 指定されたCENルートマップIDは既に存在します。 ルーティングポリシーがすでに存在するため、エラーメッセージが返されました。
400 InvalidOperation.NoEffictiveAction 有効なアクションは設定されません。 指定されたアクションが無効な場合に返されるエラーメッセージ。

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