すべてのプロダクト
Search
ドキュメントセンター

Cloud Enterprise Network:CreateCenRouteMap

最終更新日:Apr 21, 2026

ルートポリシーを使用すると、ルーティング情報をフィルターし、クラウドネットワーク接続をカスタマイズできます。CreateCenRouteMap API を呼び出して、ルートポリシーを作成できます。

操作説明

ルートマップは優先度順に処理されます。値が小さいほど優先度が高くなります。各ルートマップは、一連の一致条件とアクションで構成されます。システムは、ルートマップの一致条件に対して、優先度の高い順にルートを評価します。ルートがルートマップのすべての一致条件に一致する場合、システムは対応するアクションを適用して、ルートを許可または拒否します。ルートが許可された場合、そのルート属性を変更することもできます。ルートがいずれのルートマップにも一致しない場合、システムはデフォルトでそのルートを許可します。詳細については、「ルートマップの概要」をご参照ください。

CreateCenRouteMap API は非同期です。この API を呼び出すと、ルートマップがバックグラウンドで作成されている間に、システムはルートマップ ID を返します。DescribeCenRouteMaps API を呼び出して、ルートマップのステータスをクエリできます。

  • ステータスが Creating の場合、ルートマップが作成中であることを示します。この状態では、クエリ操作のみ実行できます。

  • ステータスが Active の場合、ルートマップが作成されたことを示します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cen:CreateCenRouteMap

create

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

CenId

string

必須

Cloud Enterprise Network (CEN) インスタンスの ID。

cen-7qthudw0ll6jmc****

CenRegionId

string

必須

ルートマップが適用されるリージョンの ID。

DescribeChildInstanceRegions API を呼び出してリージョン ID をクエリできます。

cn-hangzhou

TransmitDirection

string

必須

ルートマップが適用される方向。有効値:

  • RegionIn:インバウンド方向。ルートマップは、リージョンゲートウェイにアドバタイズされるルートに適用されます。

たとえば、ルートは現在のリージョンのネットワークインスタンスからリージョンゲートウェイに、または別のリージョンから現在のリージョンのリージョンゲートウェイにアドバタイズされます。

  • RegionOut:アウトバウンド方向。ルートマップは、リージョンゲートウェイからアドバタイズされるルートに適用されます。

たとえば、ルートは現在のリージョンのリージョンゲートウェイから現在のリージョンのネットワークインスタンスに、または別のリージョンのリージョンゲートウェイにアドバタイズされます。

RegionIn

Description

string

任意

ルートマップの説明。

説明は、空または 1~256 文字で指定できます。http:// または https:// で始めることはできません。

desctest

Priority

integer

必須

ルートマップの優先度。値は 1100 の整数です。値が小さいほど優先度が高くなります。

説明

同じリージョンおよび同じ方向に適用されるルートマップの優先度は一意である必要があります。システムは、優先度の昇順でこれらのマップに対してルートを照合します。したがって、目的の照合順序を確実にするために、優先度を慎重に設定してください。

3

MapResult

string

必須

ルートがすべての一致条件に一致した場合に実行するアクション。有効値:

  • Permit:条件に一致するルートを許可します。

  • Deny:条件に一致するルートを拒否します。

Permit

NextPriority

integer

任意

次に関連付けられるルートマップの優先度。

  • このパラメーターは、MapResultPermit に設定されている場合にのみ指定できます。許可されたルートは、次に関連付けられたルートマップに進み、さらに照合されます。

  • 次に関連付けられるルートマップは、現在のルートマップと同じリージョンにあり、同じ方向である必要があります。

  • 次に関連付けられるルートマップの優先度は、現在のルートマップの優先度よりも低くする必要があります。

20

CidrMatchMode

string

任意

プレフィックスリストの一致モード。有効値:

  • Include:あいまい一致。一致条件のプレフィックスにルートのプレフィックスが含まれている場合、ルートは一致します。

たとえば、一致条件のプレフィックス 10.10.0.0/16 は、ルート 10.10.1.0/24 と一致します。

  • Complete:完全一致。ルートのプレフィックスが一致条件のプレフィックスと同じである場合にのみ、ルートは一致します。

たとえば、一致条件のプレフィックス 10.10.0.0/16 は、ルート 10.10.0.0/16 とのみ一致します。

Include

AsPathMatchMode

string

任意

AS パスリストの一致モード。有効値:

  • Include:あいまい一致。ルートの AS パスが一致条件の AS パスリストと重複する場合、ルートは一致します。

  • Complete:完全一致。ルートの AS パスが一致条件で指定された AS 番号のシーケンスと同一である場合にのみ、ルートは一致します。

Include

CommunityMatchMode

string

任意

community 属性の一致モード。有効値:

  • Include:あいまい一致。ルートの community 属性に、一致条件で指定された community が少なくとも 1 つ含まれている場合、ルートは一致します。

  • Complete:完全一致。ルートの community 属性が一致条件の community 属性と同一である場合にのみ、ルートは一致します。

Include

CommunityOperateMode

string

任意

一致したルートの community 属性を変更する方法を指定します。有効値:

  • Additive:指定された community をルートに追加します。

  • Replace:ルートの元の community を指定された community に置き換えます。

Additive

Preference

integer

任意

一致するルートに設定する新しい優先度の値。

値は 1100 の整数です。デフォルトの優先度は 50 です。値が小さいほど優先度が高くなります。

50

SourceInstanceIdsReverseMatch

boolean

任意

送信元インスタンス ID の逆マッチを実行するかどうかを指定します。有効値:

  • false (デフォルト):ルートの送信元インスタンス ID が SourceInstanceIds リストにある場合、ルートは一致します。

  • true:ルートの送信元インスタンス ID が SourceInstanceIds リストにない場合、ルートは一致します。

false

DestinationInstanceIdsReverseMatch

boolean

任意

宛先インスタンス ID の逆マッチを実行するかどうかを指定します。有効値:

  • false (デフォルト):ルートの宛先インスタンス ID が DestinationInstanceIds リストにある場合、ルートは一致します。

  • true:ルートの宛先インスタンス ID が DestinationInstanceIds リストにない場合、ルートは一致します。

false

MatchAddressType

string

任意

一致させるルートの IP バージョン。有効値:

  • IPv4:IPv4 ルートのみを照合します。

  • IPv6:IPv6 ルートのみを照合します。

このパラメーターを指定しない場合、ルートマップはすべての IP バージョンのルートを照合します。

IPv4

TransitRouterRouteTableId

string

任意

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

ルートテーブル ID を指定しない場合、システムは自動的にルートマップをトランジットルーターのデフォルトルートテーブルに関連付けます。

vtb-gw8nx3515m1mbd1z1****

SourceInstanceIds

array

任意

一致させる送信元インスタンス ID。次のインスタンスタイプがサポートされています:

  • VPC

  • VBR

  • CCN

  • Smart Access Gateway (SAG)

  • IPsec 接続

最大 64 個のインスタンス ID を入力できます。

vpc-adeg3544fdf34vf****

string

任意

一致させる送信元インスタンス ID。次のインスタンスタイプがサポートされています:

  • VPC

  • VBR

  • CCN

  • Smart Access Gateway (SAG)

  • IPsec 接続

最大 64 個のインスタンス ID を入力できます。

vpc-adeg3544fdf34vf****

DestinationInstanceIds

array

任意

一致させる宛先インスタンス ID。次のインスタンスタイプがサポートされています:

  • VPC

  • VBR

  • CCN

  • Smart Access Gateway (SAG)

  • IPsec 接続

最大 64 個のインスタンス ID を入力できます。

説明

この条件は、ルートマップがアウトバウンド方向に適用され、かつ宛先インスタンスがルートマップと同じリージョンにある場合にのみ評価されます。

vpc-afrfs434465fdf****

string

任意

一致させる宛先インスタンス ID。次のインスタンスタイプがサポートされています:

  • VPC

  • VBR

  • CCN

  • Smart Access Gateway (SAG)

  • IPsec 接続

最大 64 個のインスタンス ID を入力できます。

説明

この条件は、ルートマップがアウトバウンド方向に適用され、かつ宛先インスタンスがルートマップと同じリージョンにある場合にのみ評価されます。

vpc-afrfs434465fdf****

SourceRouteTableIds

array

任意

一致させる送信元ルートテーブル ID。最大 64 個のルートテーブル ID を入力できます。

vtb-adfr233vf34rvd4****

string

任意

一致させる送信元ルートテーブル ID。最大 64 個のルートテーブル ID を入力できます。

vtb-adfr233vf34rvd4****

DestinationRouteTableIds

array

任意

一致させる宛先ルートテーブル ID。最大 64 個のルートテーブル ID を入力できます。

説明

このパラメーターは、ルートマップがアウトバウンド方向に適用され、かつ宛先ルートテーブルがルートマップと同じリージョン内のネットワークインスタンスに属している場合にのみ有効です。

vtb-adefrgtr144vf****

string

任意

一致させる宛先ルートテーブル ID。最大 64 個のルートテーブル ID を入力できます。

説明

このパラメーターは、ルートマップがアウトバウンド方向に適用され、かつ宛先ルートテーブルがルートマップと同じリージョン内のネットワークインスタンスに属している場合にのみ有効です。

vtb-adefrgtr144vf****

SourceRegionIds

array

任意

一致させる送信元リージョン ID。最大 64 個のリージョン ID を入力できます。

DescribeChildInstanceRegions API を呼び出してリージョン ID をクエリできます。

cn-beijing

string

任意

一致させる送信元リージョン ID。最大 64 個のリージョン ID を入力できます。

DescribeChildInstanceRegions API を呼び出してリージョン ID をクエリできます。

cn-beijing

SourceChildInstanceTypes

array

任意

一致させる送信元インスタンスタイプ。次のインスタンスタイプがサポートされています:

  • VPC

  • VBR

  • CCN

  • VPN:VPN ゲートウェイまたは IPsec 接続。

    • この値は、IPsec 接続または SSL サーバーが、BGP ルーティングを使用し、関連付けられた VPC がトランジットルーターにアタッチされている VPN ゲートウェイにバインドされている場合に適用されます。

    • このパラメーターは、IPsec 接続がトランジットルーターに直接アタッチされている場合にも有効です。

複数のインスタンスタイプを入力できます。

VPC

string

任意

一致させる送信元インスタンスタイプ。次のインスタンスタイプがサポートされています:

  • VPC

  • VBR

  • CCN

  • VPN:VPN ゲートウェイまたは IPsec 接続。

    • この値は、IPsec 接続または SSL サーバーが、BGP ルーティングを使用し、関連付けられた VPC がトランジットルーターにアタッチされている VPN ゲートウェイにバインドされている場合に適用されます。

    • このパラメーターは、IPsec 接続がトランジットルーターに直接アタッチされている場合にも有効です。

複数のインスタンスタイプを入力できます。

VPC

DestinationChildInstanceTypes

array

任意

一致させる宛先インスタンスタイプ。次のインスタンスタイプがサポートされています:

  • VPC

  • VBR

  • CCN

  • VPN:IPsec 接続。

    説明

    VPN タイプの場合、この条件はトランジットルーターに直接アタッチされている IPsec 接続にのみ適用されます。VPN ゲートウェイにバインドされている IPsec 接続または SSL サーバーには適用されません。

複数のインスタンスタイプを入力できます。

説明

宛先インスタンスタイプのリストは、ルートマップがアウトバウンド方向に適用され、かつ宛先インスタンスがルートマップと同じリージョンにある場合にのみ有効です。

VPC

string

任意

一致させる宛先インスタンスタイプ。次のインスタンスタイプがサポートされています:

  • VPC

  • VBR

  • CCN

  • VPN:IPsec 接続。

    説明

    VPN タイプの場合、この条件はトランジットルーターに直接アタッチされている IPsec 接続にのみ適用されます。VPN ゲートウェイにバインドされている IPsec 接続または SSL サーバーには適用されません。

複数のインスタンスタイプを入力できます。

説明

宛先インスタンスタイプのリストは、ルートマップがアウトバウンド方向に適用され、かつ宛先インスタンスがルートマップと同じリージョンにある場合にのみ有効です。

VPC

DestinationCidrBlocks

array

任意

一致させる宛先プレフィックスのリスト。

CIDR 表記で最大 64 個のプレフィックスを指定します。

IPv4 と IPv6 の両方のプレフィックスがサポートされています。

10.10.10.0/24

string

任意

一致させる宛先プレフィックスのリスト。

CIDR 表記で最大 64 個のプレフィックスを指定します。

IPv4 と IPv6 の両方のプレフィックスがサポートされています。

10.10.10.0/24

RouteTypes

array

任意

一致させるルートタイプ。次のルートタイプがサポートされています:

  • System:システムによって自動的に生成されるシステムルート。

  • Custom:ユーザーが手動で追加するカスタムルート。

  • BGP:BGP ピアから学習したルート。

複数のルートタイプを入力できます。

System

string

任意

一致させるルートタイプ。次のルートタイプがサポートされています:

  • System:システムによって自動的に生成されるシステムルート。

  • Custom:ユーザーが手動で追加するカスタムルート。

  • BGP:BGP ピアから学習したルート。

複数のルートタイプを入力できます。

System

MatchAsns

array

任意

一致させる AS パス。

最大 64 個の AS 番号を入力できます。

説明

パスは AS 番号のシーケンスとして指定する必要があります。AS_SET、AS_CONFED_SEQUENCE、AS_CONFED_SET などの他のフォーマットはサポートされていません。

65501

integer

任意

一致させる AS パス。

最大 64 個の AS 番号を入力できます。

説明

パスは AS 番号のシーケンスとして指定する必要があります。AS_SET、AS_CONFED_SEQUENCE、AS_CONFED_SET などの他のフォーマットはサポートされていません。

65501

MatchCommunitySet

array

任意

一致させる community セット。

各 community は n:m 形式である必要があります。n と m は 165535 の整数です。community は RFC 1997 に準拠している必要があります。ラージコミュニティ (RFC 8092) はサポートされていません。

最大 64 個の community を入力できます。

説明

community の設定が正しくないと、ルートがオンプレミスデータセンターにアドバタイズされなくなる可能性があります。

65501:1

string

任意

一致させる community セット。

各 community は n:m 形式である必要があります。n と m は 165535 の整数です。community は RFC 1997 に準拠している必要があります。ラージコミュニティ (RFC 8092) はサポートされていません。

最大 64 個の community を入力できます。

説明

community の設定が正しくないと、ルートがオンプレミスデータセンターにアドバタイズされなくなる可能性があります。

65501:1

OperateCommunitySet

array

任意

適用する community セット。

各 community は n:m 形式である必要があります。n と m は 165535 の整数です。community は RFC 1997 に準拠している必要があります。ラージコミュニティ (RFC 8092) はサポートされていません。

最大 32 個の community を入力できます。

説明

community の設定が正しくないと、ルートがオンプレミスデータセンターにアドバタイズされなくなる可能性があります。

65501:1

string

任意

適用する community セット。

各 community は n:m 形式である必要があります。n と m は 165535 の整数です。community は RFC 1997 に準拠している必要があります。ラージコミュニティ (RFC 8092) はサポートされていません。

最大 32 個の community を入力できます。

説明

community の設定が正しくないと、ルートがオンプレミスデータセンターにアドバタイズされなくなる可能性があります。

65501:1

PrependAsPath

array

任意

リージョンゲートウェイがルートを受信またはアドバタイズするときに先頭に追加する AS パス。

AS パスを先頭に追加するための要件は、ルートマップが適用される方向によって異なります:

  • ルートマップがインバウンド方向に適用される場合、一致条件で送信元インスタンス ID と送信元リージョンを指定する必要があり、送信元リージョンはルートマップが適用されるリージョンと同じである必要があります。

  • ルートマップがアウトバウンド方向に適用される場合、一致条件で宛先インスタンス ID を指定する必要があります。

このアクションは、一致するルートに適用されます。最大 32 個の AS 番号を入力できます。

65501

integer

任意

リージョンゲートウェイがルートを受信またはアドバタイズするときに先頭に追加する AS パス。

AS パスを先頭に追加するための要件は、ルートマップが適用される方向によって異なります:

  • ルートマップがインバウンド方向に適用される場合、一致条件で送信元インスタンス ID と送信元リージョンを指定する必要があり、送信元リージョンはルートマップが適用されるリージョンと同じである必要があります。

  • ルートマップがアウトバウンド方向に適用される場合、一致条件で宛先インスタンス ID を指定する必要があります。

このアクションは、一致するルートに適用されます。最大 32 個の AS 番号を入力できます。

65501

DestinationRegionIds

array

任意

一致させる宛先リージョン ID。最大 64 個のリージョン ID を入力できます。

string

任意

一致させる宛先リージョン ID。最大 64 個のリージョン ID を入力できます。

cn-beijing

レスポンスフィールド

フィールド

説明

object

応答データ。

RouteMapId

string

ルートマップの ID。

cenrmap-w4yf7toozfol3q****

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 Forbidden.CenRouteMapExist The specified CEN route map ID already exists.
400 Invid.Parameter When using PrependAsPath in the RegionIn, SourceRegionId must be local region Id.
400 InvalidOperation.NoEffictiveAction No effective action be configured.
400 IncorrectStatus.TransitRouterInstance The status of TransitRouter is incorrect.
400 InvalidDescription Description is invalid.
400 IllegalParam.ZoneId The specified ZoneId is illegal.
400 Forbidden.NoMedAuthorized Med operation is unauthorized.
400 InvalidOperation.MedRouteMapExist Operation is invalid because the default med route map already exist.
400 InvalidOperation.MedRouteMapNotAllowedOtherAction Operation is invalid because the default med not allowed other action.
400 InvalidOperation.MedRouteMapActionMustPermit Operation is invalid because the default med map result must be permit.
400 InvalidParameter.MedRouteMapDestInstanceIds Param DestInstanceIds must be ecr instance id.
400 InvalidParameter.MedRouteMapDestInstanceType Param DestChildInstanceTypes must be ecr.
400 InvalidParameter Invalid parameter.
400 Unauthorized The AccessKeyId is unauthorized.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。