すべてのプロダクト
Search

このプロダクト

    Cloud Enterprise Network:ModifyCenRouteMap

    ドキュメントセンター

    Cloud Enterprise Network:ModifyCenRouteMap

    最終更新日:Apr 21, 2026

    ModifyCenRouteMap を使用してルートマップを変更します。

    操作説明

    ModifyCenRouteMap は非同期 API です。システムはすぐに RequestId を返しますが、変更タスクはバックグラウンドで実行されます。DescribeCenRouteMaps API を呼び出して、ルートマップの状態をクエリできます。

    • ルートマップが 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
    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 にのみ一致します。

    Include

    AsPathMatchMode

    string

    任意

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

    • Include：部分一致。ルートの AS パスに一致条件で指定された AS 番号が含まれている場合、ルートは一致したとみなされます。

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

    Include
    CommunityMatchMode

    string

    任意

    コミュニティの一致モード。有効な値：

    • Include：部分一致。ルートのコミュニティ属性に一致条件で指定されたコミュニティ値が含まれている場合、ルートは一致したとみなされます。

    • Complete：完全一致。ルートのコミュニティ属性が一致条件で指定されたコミュニティと同一である場合にのみ、ルートは一致したとみなされます。

    Include
    CommunityOperateMode

    string

    任意

    コミュニティ属性に対して実行するアクション。有効な値：

    • Additive：指定されたコミュニティをルートに追加します。

    • Replace：ルートの元のコミュニティを指定されたコミュニティに置き換えます。

    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 ルートのみを照合します。

    このパラメーターを設定しない場合、すべての IP バージョンのルートが照合されます。

    IPv4
    SourceInstanceIds

    array

    任意

    照合するソースインスタンス ID のリスト。以下のインスタンスタイプがサポートされています：

    • VPC インスタンス ID

    • VBR インスタンス ID

    • CCN インスタンス ID

    • Smart Access Gateway (SAG) インスタンス ID

    • IPsec 接続 ID

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

    vpc-afsfdf5435vcvc****

    string

    任意

    照合するソースインスタンス ID。

    vpc-afsfdf5435vcvc****
    DestinationInstanceIds

    array

    任意

    照合する宛先インスタンス ID のリスト。以下のインスタンスタイプがサポートされています：

    • VPC インスタンス ID

    • VBR インスタンス ID

    • CCN インスタンス ID

    • Smart Access Gateway (SAG) インスタンス ID

    • IPsec 接続 ID

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

    説明

    この条件は、ルートマップが同じリージョン内のゲートウェイからネットワークインスタンスにアドバタイズされるルートに使用される場合にのみ適用されます。

    vpc-avcdsg34ds****

    string

    任意

    照合する宛先インスタンス ID。

    説明

    vpc-avcdsg34ds****
    SourceRouteTableIds

    array

    任意

    照合するソースルートテーブル ID のリスト。最大 64 個のルートテーブル ID を指定できます。

    vtb-acdbvtbr342cd****

    string

    任意

    照合するソースルートテーブル ID。

    vtb-acdbvtbr342cd****
    DestinationRouteTableIds

    array

    任意

    照合する宛先ルートテーブル ID のリスト。最大 64 個のルートテーブル ID を指定できます。

    説明

    この条件は、ルートマップが同じリージョン内のゲートウェイからネットワークインスタンスにアドバタイズされるルートに使用される場合にのみ適用されます。

    vtb-adfg53c322v****

    string

    任意

    照合する宛先ルートテーブル ID。

    説明

    vtb-adfg53c322v****
    SourceRegionIds

    array

    任意

    照合するソースリージョン ID のリスト。最大 64 個のリージョン ID を指定できます。

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

    cn-beijing

    string

    任意

    照合するソースリージョン ID。

    cn-beijing
    SourceChildInstanceTypes

    array

    任意

    照合するソースインスタンスタイプのリスト。以下のインスタンスタイプがサポートされています：

    • VPC：VPC インスタンス。

    • VBR：VBR インスタンス。

    • CCN：CCN インスタンス。

    • VPN：VPN Gateway インスタンスまたは IPsec 接続。

      • IPsec 接続または SSL サーバーが VPN Gateway にバインドされている場合にこのパラメーターを有効にするには、関連付けられた VPC がトランジットルーターに接続され、VPN Gateway が BGP 動的ルーティングを使用する必要があります。

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

    VPC

    string

    任意

    照合するソースインスタンスタイプ。

    VPC
    DestinationChildInstanceTypes

    array

    任意

    照合する宛先インスタンスタイプのリスト。以下のインスタンスタイプがサポートされています：

    • VPC：VPC インスタンス。

    • VBR：VBR インスタンス。

    • CCN：CCN インスタンス。

    • VPN：IPsec 接続。

      説明

      このパラメーターは、トランジットルーターに直接アタッチされている IPsec 接続に対してのみ有効です。VPN Gateway にバインドされている接続には適用されません。

    この条件は、ルートマップが同じリージョン内のゲートウェイからネットワークインスタンスにアドバタイズされるルートに使用される場合にのみ適用されます。

    VPC

    string

    任意

    照合する宛先インスタンスタイプ。

    • 説明

    VPC
    DestinationCidrBlocks

    array

    任意

    照合するプレフィックスリスト。

    IP アドレスを CIDR 表記で指定します。最大 64 個の CIDR ブロックを指定できます。

    10.10.10.0/24

    string

    任意

    照合するリストのプレフィックス。

    10.10.10.0/24
    RouteTypes

    array

    任意

    照合するルートタイプのリスト。1 つ以上のタイプを指定できます。以下のルートタイプがサポートされています：

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

    • Custom：手動で追加されたルート。

    • BGP：BGP を介して学習されたルート。

    System

    string

    任意

    照合するルートタイプ。

    System
    MatchAsns

    array

    任意

    照合する AS パスリスト。

    説明

    AS_SEQUENCE のみがサポートされています。AS_SET、AS_CONFED_SEQUENCE、および AS_CONFED_SET はサポートされていません。AS 番号のリストのみを指定できます。

    65501

    integer

    任意

    照合する AS 番号。

    説明

    65501
    MatchCommunitySet

    array

    任意

    照合するコミュニティセット。

    各コミュニティは n:m 形式である必要があり、n と m は 1 から 65535 までの整数です。コミュニティは RFC 1997 に準拠する必要があります。Large Communities (RFC 8092) はサポートされていません。

    最大 64 個のコミュニティを入力できます。

    説明

    コミュニティの構成が正しくないと、ルートがオンプレミスデータセンターにアドバタイズされなくなる可能性があります。

    65501:1

    string

    任意

    照合するコミュニティ値。

    説明

    65501:1
    OperateCommunitySet

    array

    任意

    適用するコミュニティセット。

    各コミュニティは n:m 形式である必要があり、n と m は 1 から 65535 までの整数です。コミュニティは RFC 1997 に準拠する必要があります。Large Communities (RFC 8092) はサポートされていません。

    最大 32 個のコミュニティを入力できます。

    説明

    コミュニティの構成が正しくないと、ルートがオンプレミスデータセンターにアドバタイズされなくなる可能性があります。

    65501:1

    string

    任意

    適用するコミュニティ値。

    説明

    65501:1
    PrependAsPath

    array

    任意

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

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

    • ルートマップがインバウンドルート (ゲートウェイによって受信される) に適用される場合、一致条件でソースインスタンス ID とソースリージョンを指定する必要があります。ソースリージョンは、ルートマップのリージョンと同じである必要があります。

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

    65501

    integer

    任意

    先頭に追加する AS 番号。

    65501
    DestinationRegionIds

    array

    任意

    照合する宛先リージョン ID のリスト。最大 64 個のリージョン ID を入力できます。

    string

    任意

    照合する宛先リージョン 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.
    400 InvalidOperation.CenRouteMapExist Operation is invalid because an route map config exist.
    400 Invid.Parameter When using GatewayRegionId, SourceRegionId must not be null
    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.
    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 InvalidOperation.PrependAsPathWithInvalidSourceRegionId When using PrependAsPath in the RegionIn direction, SourceRegionId must be local region ID.
    400 InvalidOperation.PrependAsPathWithInvalidSourceInstanceIds When using PrependAsPath in the RegionIn direction, SourceInstanceIds must be local instance ids.
    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.

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

    変更履歴

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