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

Cloud Enterprise Network:ModifyCenRouteMap

最終更新日:Sep 02, 2026

ルーティングポリシーを変更します。

操作説明

ModifyCenRouteMap 操作は非同期です。リクエストを送信すると、システムは RequestId を返しますが、ルーティングポリシーはまだ変更済みではありません。変更タスクはバックグラウンドで実行されます。DescribeCenRouteMaps 操作を呼び出して、ルーティングポリシーのステータスをクエリできます。

  • ルーティングポリシーが Modifying 状態の場合、ルーティングポリシーは変更中です。この状態では、クエリ操作のみを実行できます。

  • ルーティングポリシーが 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:ModifyCenRouteMap

update

*CenInstance

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

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

CenId

string

必須

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

cen-7qthudw0ll6jmc****

CenRegionId

string

必須

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

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

cn-hangzhou

RouteMapId

string

必須

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

cenrmap-abcdedfghij****

Description

string

任意

ルーティングポリシーの説明。

説明は空、または 1~256 文字の長さに設定でき、http:// または https:// で始めることはできません。

desctest

MapResult

string

必須

すべての一致条件に合致するルートに対して実行する操作。有効な値:

  • Permit: ルートの通過を許可します。

  • Deny: ルートの通過を拒否します。

列挙値:

  • Permit :

    許可。

  • Deny :

    拒否。

Permit

NextPriority

integer

任意

次に関連付けられるルーティングポリシーのポリシー優先度。

  • 次に関連付けられるルーティングポリシーのポリシー優先度は、MapResult が Permit に設定されている場合にのみ設定できます。通過を許可されたルートのみが、次に関連付けられるルーティングポリシーとの一致判定を続行します。

  • 次に関連付けられるルーティングポリシーは、現在のルーティングポリシーと同じリージョンおよび方向である必要があります。

  • 次に関連付けられるルーティングポリシーのポリシー優先度は、現在のルーティングポリシーのポリシー優先度より低い (数値として大きい) 値である必要があります。

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 とのみ完全に一致します。

列挙値:

  • Complete :

    完全に一致。

  • Include :

    あいまい一致。

Include

AsPathMatchMode

string

任意

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

  • Include: あいまい一致。一致条件の AS パスが、一致対象のルートの AS パスと重複する場合、一致とみなされます。

  • Complete: 完全に一致。一致条件の AS パスが、一致対象のルートの AS パスと同一である場合にのみ、一致とみなされます。

列挙値:

  • Complete :

    完全に一致。

  • Include :

    あいまい一致。

Include

CommunityMatchMode

string

任意

Community の一致モード。有効な値:

  • Include: あいまい一致。一致条件の Community が、一致対象のルートの Community と重複する場合、一致とみなされます。

  • Complete: 完全に一致。一致条件の Community が、一致対象のルートの Community と同一である場合にのみ、一致とみなされます。

  • Contain: 包含一致。一致対象のルートの Community が、一致条件で指定されたすべての Community を含む場合にのみ、一致とみなされます。

列挙値:

  • Complete :

    完全に一致。

  • Include :

    あいまい一致。

  • Contain :

    包含一致。

Include

CommunityOperateMode

string

任意

Community に対して実行する操作。有効な値:

  • Additive: ルートに Community を追加します。

  • Replace: ルートの元の Community を置き換えます。

このパラメーターは、ルートが一致条件に合致した後にルートに対して実行する操作を指定します。

列挙値:

  • Replace :

    置き換え。

  • Additive :

    追加。

Additive

Preference

integer

任意

変更済みのルートの優先度。

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

このパラメーターは、ルートが一致条件に合致した後にルートに対して実行する操作を指定します。

22

Priority

integer

必須

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

説明

同じリージョンで同じ方向のルーティングポリシーのポリシー優先度は一意である必要があります。システムがルーティングポリシーを実行する際、優先度数値が最も小さいルーティングポリシーから条件付きの文の一致判定を開始します。期待される一致の順序に基づいてポリシー優先度を指定してください。

10

SourceInstanceIdsReverseMatch

boolean

任意

ソースインスタンス ID リストに逆再生モードを使用するかどうかを指定します。有効な値:

  • false (デフォルト): いいえ。ルートのソースインスタンス ID が SourceInstanceIds.N に含まれる場合、一致とみなされます。

  • true: はい。ルートのソースインスタンス ID が SourceInstanceIds.N に含まれない場合、一致とみなされます。

false

DestinationInstanceIdsReverseMatch

boolean

任意

宛先インスタンス ID リストに逆再生モードを使用するかどうかを指定します。有効な値:

  • false (デフォルト): いいえ。ルートの宛先インスタンス ID が DestinationInstanceIds.N に含まれる場合、一致とみなされます。

  • true: はい。ルートの宛先インスタンス ID が DestinationInstanceIds.N に含まれない場合、一致とみなされます。

false

MatchAddressType

string

任意

ルートが一致する必要のある IP アドレスタイプ。有効な値:

  • IPv4: IPv4 ルートのみと一致します。

  • IPv6: IPv6 ルートのみと一致します。

このパラメーターは空にすることができ、その場合はすべてのタイプのルートが一致対象となります。

IPv4

SourceInstanceIds

array

任意

ルートが一致する必要のあるソースインスタンス ID の注文。以下のタイプのインスタンス ID がサポートされています:

  • Virtual Private Cloud (VPC) インスタンス ID

  • Virtual Border Router (VBR) インスタンス ID

  • Cloud Connect Network (CCN) インスタンス ID

  • Smart Access Gateway インスタンス ID

  • IPsec 接続 ID

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

vpc-afsfdf5435vcvc****

string

任意

ルートが一致する必要のあるソースインスタンス ID の注文。以下のタイプのインスタンス ID がサポートされています:

  • Virtual Private Cloud (VPC) インスタンス ID

  • Virtual Border Router (VBR) インスタンス ID

  • Cloud Connect Network (CCN) インスタンス ID

  • Smart Access Gateway インスタンス ID

  • IPsec 接続 ID

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

vpc-afsfdf5435vcvc****

DestinationInstanceIds

array

任意

ルートが一致する必要のある宛先インスタンス ID の注文。以下のタイプのインスタンス ID がサポートされています:

  • Virtual Private Cloud (VPC) インスタンス ID

  • Virtual Border Router (VBR) インスタンス ID

  • Cloud Connect Network (CCN) インスタンス ID

  • Smart Access Gateway インスタンス ID

  • IPsec 接続 ID

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

説明

宛先インスタンス ID リストは、ルーティングポリシーの方向が「リージョナルゲートウェイからのエクスポート」であり、かつ宛先インスタンス ID がローカルリージョンにある場合にのみ効果が得られます。

vpc-avcdsg34ds****

string

任意

ルートが一致する必要のある宛先インスタンス ID の注文。以下のタイプのインスタンス ID がサポートされています:

  • Virtual Private Cloud (VPC) インスタンス ID

  • Virtual Border Router (VBR) インスタンス ID

  • Cloud Connect Network (CCN) インスタンス ID

  • Smart Access Gateway インスタンス ID

  • IPsec 接続 ID

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

説明

宛先インスタンス ID リストは、ルーティングポリシーの方向が「リージョナルゲートウェイからのエクスポート」であり、かつ宛先インスタンス ID がローカルリージョンにある場合にのみ効果が得られます。

vpc-avcdsg34ds****

SourceRouteTableIds

array

任意

ルートが一致する必要のあるソースルートテーブル ID のリスト。最大 64 個のルートテーブル ID を指定できます。

vtb-acdbvtbr342cd****

string

任意

ルートが一致する必要のあるソースルートテーブル ID のリスト。最大 64 個のルートテーブル ID を指定できます。

vtb-acdbvtbr342cd****

DestinationRouteTableIds

array

任意

ルートが一致する必要のある送信先ルートテーブル ID のリスト。最大 64 個のルートテーブル ID を指定できます。

説明

送信先ルートテーブル ID リストは、ルーティングポリシーの方向が「リージョナルゲートウェイからのエクスポート」であり、かつ送信先ルートテーブル ID がローカルリージョンのネットワークインスタンスのルートテーブル ID である場合にのみ効果が得られます。

vtb-adfg53c322v****

string

任意

ルートが一致する必要のある送信先ルートテーブル ID のリスト。最大 64 個のルートテーブル ID を指定できます。

説明

送信先ルートテーブル ID リストは、ルーティングポリシーの方向が「リージョナルゲートウェイからのエクスポート」であり、かつ送信先ルートテーブル ID がローカルリージョンのネットワークインスタンスのルートテーブル ID である場合にのみ効果が得られます。

vtb-adfg53c322v****

SourceRegionIds

array

任意

ルートが一致する必要のあるソースリージョン ID のリスト。最大 64 個のリージョン ID を指定できます。

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

cn-beijing

string

任意

ルートが一致する必要のあるソースリージョン ID のリスト。最大 64 個のリージョン ID を指定できます。

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

cn-beijing

SourceChildInstanceTypes

array

任意

ルートが一致する必要のあるソースインスタンスタイプのリスト。以下のインスタンスタイプがサポートされています:

  • VPC: VPC インスタンス。

  • VBR: 罫線ルーターインスタンス。

  • CCN: CCN インスタンス。

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

    • IPsec 接続または SSL サーバーが VPN ゲートウェイインスタンスにアタッチされている場合、このパラメーターが効果を得るには、VPN ゲートウェイインスタンスに関連付けられた VPC がトランジットルーターインスタンスに接続されており、かつ VPN ゲートウェイインスタンスが BGP 動的ルートプロトコルを実行している必要があります。

    • IPsec 接続がトランジットルーターインスタンスに直接アタッチされている場合、このパラメーターは効果が得られます。

VPC

string

任意

ルートが一致する必要のあるソースインスタンスタイプのリスト。以下のインスタンスタイプがサポートされています:

  • VPC: VPC インスタンス。

  • VBR: 罫線ルーターインスタンス。

  • CCN: CCN インスタンス。

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

    • IPsec 接続または SSL サーバーが VPN ゲートウェイインスタンスにアタッチされている場合、このパラメーターが効果を得るには、VPN ゲートウェイインスタンスに関連付けられた VPC がトランジットルーターインスタンスに接続されており、かつ VPN ゲートウェイインスタンスが BGP 動的ルートプロトコルを実行している必要があります。

    • IPsec 接続がトランジットルーターインスタンスに直接アタッチされている場合、このパラメーターは効果が得られます。

VPC

DestinationChildInstanceTypes

array

任意

ルートが一致する必要のある宛先インスタンスタイプのリスト。以下のインスタンスタイプがサポートされています:

  • VPC: VPC インスタンス。

  • VBR: VBR インスタンス。

  • CCN: CCN インスタンス。

  • VPN: IPsec 接続。

    説明

    IPsec 接続または SSL サーバーが VPN ゲートウェイインスタンスにバインドされており、VPN ゲートウェイインスタンスに関連付けられた VPC を介してトランジットルーターインスタンスに接続されている場合、このパラメーターは効果が得られません。このパラメーターは、IPsec 接続がトランジットルーターインスタンスに直接バインドされている場合にのみ効果が得られます。

宛先インスタンスタイプリストは、ルーティングポリシーの方向が「リージョナルゲートウェイからのエクスポート」であり、かつ宛先インスタンスタイプがローカルリージョンのインスタンスタイプである場合にのみ効果が得られます。

VPC

string

任意

ルートが一致する必要のある宛先インスタンスタイプのリスト。以下のインスタンスタイプがサポートされています:

  • VPC: VPC インスタンス。

  • VBR: VBR インスタンス。

  • CCN: CCN インスタンス。

  • VPN: IPsec 接続。

    説明

    IPsec 接続または SSL サーバーが VPN ゲートウェイインスタンスにバインドされており、VPN ゲートウェイインスタンスに関連付けられた VPC を介してトランジットルーターインスタンスに接続されている場合、このパラメーターは効果が得られません。このパラメーターは、IPsec 接続がトランジットルーターインスタンスに直接バインドされている場合にのみ効果が得られます。

宛先インスタンスタイプリストは、ルーティングポリシーの方向が「リージョナルゲートウェイからのエクスポート」であり、かつ宛先インスタンスタイプがローカルリージョンのインスタンスタイプである場合にのみ効果が得られます。

VPC

DestinationCidrBlocks

array

任意

ルートが一致する必要のあるプレフィックスリスト。

プレフィックスリスト内の IP アドレス範囲は CIDR フォーマットです。最大 64 個の IP アドレス範囲を指定できます。

10.10.10.0/24

string

任意

ルートが一致する必要のあるプレフィックスリスト。

プレフィックスリスト内の IP アドレス範囲は CIDR フォーマットです。最大 64 個の IP アドレス範囲を指定できます。

10.10.10.0/24

RouteTypes

array

任意

ルートが一致する必要のあるルーティングタイプリスト。以下のルーティングタイプがサポートされています:

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

  • Custom: ユーザーによって手動で追加されるカスタムルート。

  • BGP: BGP ルーティングプロトコルを通じて伝播される BGP ルート。

System

string

任意

ルートが一致する必要のあるルーティングタイプリスト。以下のルーティングタイプがサポートされています:

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

  • Custom: ユーザーによって手動で追加されるカスタムルート。

  • BGP: BGP ルーティングプロトコルを通じて伝播される BGP ルート。

System

MatchAsns

array

任意

ルートが一致する必要のある AS パスリスト。

説明

AS SEQUENCE のみがサポートされています。AS SET、AS CONFED SEQUENCE、および AS CONFED SET はサポートされていません。具体的には、AS 番号リストのみがサポートされており、セットおよびサブリストはサポートされていません。

65501

integer

任意

ルートが一致する必要のある AS パスリスト。

説明

AS SEQUENCE のみがサポートされています。AS SET、AS CONFED SEQUENCE、および AS CONFED SET はサポートされていません。具体的には、AS 番号リストのみがサポートされており、セットおよびサブリストはサポートされていません。

65501

MatchCommunitySet

array

任意

ルートが一致する必要のある Community セット。

各 Community は n:m フォーマットで、n および m の値の範囲は 1~65535 です。Community は RFC 1997 に準拠している必要があります。Large Communities (RFC 8092) はサポートされていません。

最大 64 個の Community を指定できます。

説明

Community の構成が正しくないと、オンプレミスデータセンターへのルートのアドバタイズが失敗する可能性があります。

65501:1

string

任意

ルートが一致する必要のある Community セット。

各 Community は n:m フォーマットで、n および m の値の範囲は 1~65535 です。Community は RFC 1997 に準拠している必要があります。Large Communities (RFC 8092) はサポートされていません。

最大 64 個の Community を指定できます。

説明

Community の構成が正しくないと、オンプレミスデータセンターへのルートのアドバタイズが失敗する可能性があります。

65501:1

OperateCommunitySet

array

任意

実行する Community セット。

各 Community は n:m フォーマットで、n および m の値の範囲は 1~65535 です。Community は RFC 1997 に準拠している必要があります。Large Communities (RFC 8092) はサポートされていません。

最大 32 個の Community を指定できます。

説明

Community の構成が正しくないと、オンプレミスデータセンターへのルートのアドバタイズが失敗する可能性があります。

65501:1

string

任意

実行する Community セット。

各 Community は n:m フォーマットで、n および m の値の範囲は 1~65535 です。Community は RFC 1997 に準拠している必要があります。Large Communities (RFC 8092) はサポートされていません。

最大 32 個の Community を指定できます。

説明

Community の構成が正しくないと、オンプレミスデータセンターへのルートのアドバタイズが失敗する可能性があります。

65501:1

PrependAsPath

array

任意

リージョナルゲートウェイがルートエントリを受信または公開する際に先頭に追加される AS パス。

先頭に追加する AS パスの設定要件は、ルーティングポリシーの方向によって異なります:

  • 「リージョナルゲートウェイへのインポート」方向の先頭に追加する AS パスを設定する場合、一致条件にソースインスタンス ID リストおよびソースリージョンを設定する必要があり、ソースリージョンはルーティングポリシーが適用されるリージョンと同じである必要があります。

  • 「リージョナルゲートウェイからのエクスポート」方向の先頭に追加する AS パスを設定する場合、一致条件に宛先インスタンス ID リストを設定する必要があります。

このパラメーターは、ルートが一致条件に合致した後にルートに対して実行する操作を指定します。

65501

integer

任意

リージョナルゲートウェイがルートエントリを受信または公開する際に先頭に追加される AS パス。

先頭に追加する AS パスの設定要件は、ルーティングポリシーの方向によって異なります:

  • 「リージョナルゲートウェイへのインポート」方向の先頭に追加する AS パスを設定する場合、一致条件にソースインスタンス ID リストおよびソースリージョンを設定する必要があり、ソースリージョンはルーティングポリシーが適用されるリージョンと同じである必要があります。

  • 「リージョナルゲートウェイからのエクスポート」方向の先頭に追加する AS パスを設定する場合、一致条件に宛先インスタンス ID リストを設定する必要があります。

このパラメーターは、ルートが一致条件に合致した後にルートに対して実行する操作を指定します。

65501

DestinationRegionIds

array

任意

ルートが一致する必要のある送信先リージョン ID のリスト。最大 64 個のリージョン ID を指定できます。

string

任意

ルートが一致する必要のある送信先リージョン ID のリスト。最大 64 個のリージョン ID を指定できます。

cn-beijing

レスポンスフィールド

フィールド

型

説明

例

object

応答パラメーター。

RequestId

string

リクエスト ID。

54B48E3D-DF70-471B-AA93-08E683A1B457

例

成功レスポンス

JSONJSON

{
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B457\t"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidOperation.NoEffictiveAction No effective action be configured. 有効な Action が存在しません。
400 InvalidOperation.CenRouteMapExist Operation is invalid because an route map config exist. ルートマップが存在します。現在の操作はサポートされていません。
400 Invid.Parameter When using GatewayRegionId, SourceRegionId must not be null GatewayRegionId と SourceRegionId を同じリージョンにすることはできません。
400 InvalidName Name is invalid. 名前が無効です。
400 InvalidDescription Description is invalid. 説明が無効です。
400 InvalidParam.DestinationInstanceIds When using "PrependAsPath" in the "RegionOut", "DestinationInstanceIds" must be local region instances. RegionOut 構成で PrependAsPath オプションを使用する場合、DestinationInstanceIds の宛先インスタンスはローカルリージョンにある必要があります。
400 Forbidden.NoMedAuthorized Med operation is unauthorized. 指定された Med ルートポリシーを操作できません。
400 InvalidOperation.MedRouteMapExist Operation is invalid because the default med route map already exist. この ECR インスタンスをネクストホップとする MED ルートマップがすでに存在するため、ポイントが無効です。
400 InvalidOperation.MedRouteMapNotAllowedOtherAction Operation is invalid because the default med not allowed other action. MED ポリシーが設定されたルートマップでは、他のポリシーを設定できません。
400 InvalidOperation.MedRouteMapActionMustPermit Operation is invalid because the default med map result must be permit. 操作が無効です。MED ルートマップのポリシーアクションは Allow である必要があります。
400 InvalidParameter.MedRouteMapDestInstanceIds Param DestInstanceIds must be ecr instance id. MED ルートマップの宛先インスタンスリストには ECR インスタンスを含める必要があります。
400 InvalidParameter.MedRouteMapDestInstanceType Param DestChildInstanceTypes must be ecr. MED ルートマップの宛先インスタンスタイプは ECR である必要があります。
400 InvalidOperation.PrependAsPathWithInvalidSourceRegionId When using PrependAsPath in the RegionIn direction, SourceRegionId must be local region ID. リージョンゲートウェイのインバウンド方向で AS Path プリペンディングを設定する場合、ソースリージョン ID はローカルリージョン ID である必要があります。
400 InvalidOperation.PrependAsPathWithInvalidSourceInstanceIds When using PrependAsPath in the RegionIn direction, SourceInstanceIds must be local instance ids. リージョンゲートウェイのインバウンド方向で AS Path プリペンディングを設定する場合、ソースインスタンス ID はローカルリージョンのインスタンスである必要があります。
400 InvalidOperation.TransitRouterNotExist Operation is invalid because the transit router not exist. トランジットルーターが存在しません。
400 InvalidParameter Invalid parameter. パラメーターが無効です。
400 Unauthorized The AccessKeyId is unauthorized. この操作を実行するために必須の権限がアカウントにありません。
400 InvalidParameter.RouteMapId The specified parameter RouteMapId is invalid.
400 InvalidParameter.CenId The specified parameter CenId is invalid.

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

変更履歴

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