宛先ベースルートの重みを変更します。
操作説明
-
VPN ゲートウェイにアクティブな宛先ベースルートとスタンバイの宛先ベースルートが存在するシナリオにおいて、アクティブな宛先ベースルートの重みを変更する場合は、まずスタンバイの宛先ベースルートを削除する必要があります。アクティブな宛先ベースルートの重みを変更した後、再度スタンバイの宛先ベースルートを設定してください。一方、スタンバイの宛先ベースルートの重みを変更する場合も、同様にアクティブな宛先ベースルートを最初に削除する必要があります。スタンバイの宛先ベースルートの重みを変更した後、アクティブな宛先ベースルートを再設定してください。宛先ベースルートの削除方法の詳細については、「DeleteVpnRouteEntry」をご参照ください。
-
ModifyVpnRouteEntryWeight は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返し、タスクをバックグラウンドで実行します。タスクのステータスは、DescribeVpnGateway を呼び出して確認できます。
VPN ゲートウェイのステータスが updating の場合、宛先ベースルートの重みが変更中です。
VPN ゲートウェイのステータスが active の場合、宛先ベースルートの重みが変更済みです。
-
指定された時間内に、同一の VPN ゲートウェイに対して ModifyVpnRouteEntryWeight 操作を繰り返し呼び出して宛先ベースルートの重みを変更することはできません。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
VPN ゲートウェイが作成されているリージョンの ID です。DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。 |
cn-hangzhou |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であることを保証する必要があります。クライアントトークンには ASCII 文字のみを使用できます。 説明
このパラメーターを指定しない場合、システムは自動的に リクエスト ID を クライアントトークン として使用します。リクエスト ID は各リクエストごとに異なる可能性があります。 |
d7d24a21-f4ba-4454-9173-b3828dae492b |
| VpnGatewayId |
string |
必須 |
VPN ゲートウェイの ID です。 |
vpn-bp1a3kqjiiq9legfx**** |
| RouteDest |
string |
必須 |
宛先ベースルートの宛先 CIDR ブロックです。 |
10.0.0.0/24 |
| NextHop |
string |
必須 |
宛先ベースルートのネクストホップです。 |
vco-bp15oes1py4i66rmd**** |
| Weight |
integer |
必須 |
宛先ベースルートの元の重みです。有効値：
|
0 |
| NewWeight |
integer |
必須 |
宛先ベースルートの新しい重みです。有効値：
|
100 |
| OverlayMode |
string |
任意 |
トンネリングプロトコルです。値を Ipsec に設定してください。 |
Ipsec |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID です。 |
5BE01CD7-5A50-472D-AC14-CA181C5C03BE |
例
成功レスポンス
JSONJSON
{
"RequestId": "5BE01CD7-5A50-472D-AC14-CA181C5C03BE\t"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | Resource.QuotaFull | The quota of resource is full | |
| 400 | VpnGateway.Configuring | The specified service is configuring. | |
| 400 | VpnGateway.FinancialLocked | The specified service is financial locked. | |
| 400 | VpnRouteEntry.AlreadyExists | The specified route entry is already exist. | |
| 400 | VpnRouteEntry.Conflict | The specified route entry has conflict. | |
| 400 | VpnRouteEntry.BackupRoute | Validate backup route entry failed. | |
| 403 | Forbbiden.SubUser | User not authorized to operate on the specified resource as your account is created by another user. | |
| 403 | Forbidden | User not authorized to operate on the specified resource. | |
| 404 | InvalidVpnGatewayInstanceId.NotFound | The specified vpn gateway instance id does not exist. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。