ルーティングポリシーを変更します。
操作説明
ModifyCenRouteMap 操作は非同期です。リクエストを送信すると、システムは RequestId を返しますが、ルーティングポリシーはまだ変更済みではありません。変更タスクはバックグラウンドで実行されます。DescribeCenRouteMaps 操作を呼び出して、ルーティングポリシーのステータスをクエリできます。
ルーティングポリシーが Modifying 状態の場合、ルーティングポリシーは変更中です。この状態では、クエリ操作のみを実行できます。
ルーティングポリシーが Active 状態の場合、ルーティングポリシーは変更済みです。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cen:ModifyCenRouteMap |
update |
*CenInstance
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| 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 |
| NextPriority |
integer |
任意 |
次に関連付けられるルーティングポリシーのポリシー優先度。
|
20 |
| CidrMatchMode |
string |
任意 |
プレフィックスリストの一致モード。有効な値:
例えば、10.10.0.0/16 を定義するポリシーは、ルート 10.10.1.0/24 とあいまい一致します。
例えば、10.10.0.0/16 を定義するポリシーは、ルート 10.10.0.0/16 とのみ完全に一致します。 列挙値:
|
Include |
| AsPathMatchMode |
string |
任意 |
AS パスリストの一致モード。有効な値:
列挙値:
|
Include |
| CommunityMatchMode |
string |
任意 |
Community の一致モード。有効な値:
列挙値:
|
Include |
| CommunityOperateMode |
string |
任意 |
Community に対して実行する操作。有効な値:
このパラメーターは、ルートが一致条件に合致した後にルートに対して実行する操作を指定します。 列挙値:
|
Additive |
| Preference |
integer |
任意 |
変更済みのルートの優先度。 有効な値: 1~100。ルートのデフォルトの優先度は 50 です。値が小さいほど優先度が高くなります。 このパラメーターは、ルートが一致条件に合致した後にルートに対して実行する操作を指定します。 |
22 |
| Priority |
integer |
必須 |
ルーティングポリシーのポリシー優先度。有効な値: 1~100。値が小さいほど優先度が高くなります。 説明
同じリージョンで同じ方向のルーティングポリシーのポリシー優先度は一意である必要があります。システムがルーティングポリシーを実行する際、優先度数値が最も小さいルーティングポリシーから条件付きの文の一致判定を開始します。期待される一致の順序に基づいてポリシー優先度を指定してください。 |
10 |
| SourceInstanceIdsReverseMatch |
boolean |
任意 |
ソースインスタンス ID リストに逆再生モードを使用するかどうかを指定します。有効な値:
|
false |
| DestinationInstanceIdsReverseMatch |
boolean |
任意 |
宛先インスタンス ID リストに逆再生モードを使用するかどうかを指定します。有効な値:
|
false |
| MatchAddressType |
string |
任意 |
ルートが一致する必要のある IP アドレスタイプ。有効な値:
このパラメーターは空にすることができ、その場合はすべてのタイプのルートが一致対象となります。 |
IPv4 |
| SourceInstanceIds |
array |
任意 |
ルートが一致する必要のあるソースインスタンス ID の注文。以下のタイプのインスタンス ID がサポートされています:
最大 64 個のインスタンス ID を指定できます。 |
vpc-afsfdf5435vcvc**** |
|
string |
任意 |
ルートが一致する必要のあるソースインスタンス ID の注文。以下のタイプのインスタンス ID がサポートされています:
最大 64 個のインスタンス ID を指定できます。 |
vpc-afsfdf5435vcvc**** |
|
| DestinationInstanceIds |
array |
任意 |
ルートが一致する必要のある宛先インスタンス ID の注文。以下のタイプのインスタンス ID がサポートされています:
最大 64 個のインスタンス ID を指定できます。 説明
宛先インスタンス ID リストは、ルーティングポリシーの方向が「リージョナルゲートウェイからのエクスポート」であり、かつ宛先インスタンス ID がローカルリージョンにある場合にのみ効果が得られます。 |
vpc-avcdsg34ds**** |
|
string |
任意 |
ルートが一致する必要のある宛先インスタンス ID の注文。以下のタイプのインスタンス 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 |
|
string |
任意 |
ルートが一致する必要のあるソースインスタンスタイプのリスト。以下のインスタンスタイプがサポートされています:
|
VPC |
|
| DestinationChildInstanceTypes |
array |
任意 |
ルートが一致する必要のある宛先インスタンスタイプのリスト。以下のインスタンスタイプがサポートされています:
宛先インスタンスタイプリストは、ルーティングポリシーの方向が「リージョナルゲートウェイからのエクスポート」であり、かつ宛先インスタンスタイプがローカルリージョンのインスタンスタイプである場合にのみ効果が得られます。 |
VPC |
|
string |
任意 |
ルートが一致する必要のある宛先インスタンスタイプのリスト。以下のインスタンスタイプがサポートされています:
宛先インスタンスタイプリストは、ルーティングポリシーの方向が「リージョナルゲートウェイからのエクスポート」であり、かつ宛先インスタンスタイプがローカルリージョンのインスタンスタイプである場合にのみ効果が得られます。 |
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 |
|
string |
任意 |
ルートが一致する必要のあるルーティングタイプリスト。以下のルーティングタイプがサポートされています:
|
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 パスの設定要件は、ルーティングポリシーの方向によって異なります:
このパラメーターは、ルートが一致条件に合致した後にルートに対して実行する操作を指定します。 |
65501 |
|
integer |
任意 |
リージョナルゲートウェイがルートエントリを受信または公開する際に先頭に追加される AS パス。 先頭に追加する AS パスの設定要件は、ルーティングポリシーの方向によって異なります:
このパラメーターは、ルートが一致条件に合致した後にルートに対して実行する操作を指定します。 |
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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。