調用ModifyVpnRouteEntryWeight介面修改目的路由的權重值。
介面說明
本介面僅適用於支援單隧道模式 IPsec-VPN 串連的 VPN 閘道執行個體。對於支援雙隧道模式 IPsec-VPN 串連的 VPN 閘道執行個體，調用本介面成功修改權重值後，權重值也不會生效。
在 VPN 閘道執行個體下存在主備目的路由情境下，如果您需要修改主目的路由的權重值，需先將備目的路由刪除，待主目的路由修改完成後，再重新設定備目的路由。如果您需要修改備目的路由的權重值，也需先刪除主目的路由，待備目的路由修改完成後再重新設定主目的路由。刪除目的路由，請參見 DeleteVpnRouteEntry 。
- ModifyVpnRouteEntryWeight 介面屬於非同步介面，即系統先返回一個請求 ID，但該 VPN 目的路由的權重值尚未修改成功，系統背景修改任務仍在進行。您可以調用 DescribeVpnGateway 查詢 VPN 目的路由的權重值的修改狀態：
當 VPN 目的路由處於 updating 狀態時，表示 VPN 目的路由的權重值正在修改中。
當 VPN 目的路由處於 active 狀態時，表示 VPN 目的路由的權重值修改成功。
ModifyVpnRouteEntryWeight 介面不支援在同一 VPN 閘道下並發修改目的路由的權重值。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
VPN 閘道執行個體所屬地區 ID。您可以通過調用 DescribeRegions 介面擷取地區 ID。 |
cn-hangzhou |
| ClientToken |
string |
否 |
用戶端 Token，用於保證請求的等冪性。 從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。 |
d7d24a21-f4ba-4454-9173-b3828dae492b |
| VpnGatewayId |
string |
是 |
VPN 閘道的 ID。 |
vpn-bp1a3kqjiiq9legfx**** |
| RouteDest |
string |
是 |
目的路由的目標網段。 |
10.0.0.0/24 |
| NextHop |
string |
是 |
目的路由的下一跳。 |
vco-bp15oes1py4i66rmd**** |
| Weight |
integer |
是 |
目的路由在修改之前設定的權重值，取值：
|
0 |
| NewWeight |
integer |
是 |
目的路由新的權重值，取值：
|
100 |
| OverlayMode |
string |
否 |
隧道協議，取值：Ipsec（IPsec 隧道協議）。 |
Ipsec |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
5BE01CD7-5A50-472D-AC14-CA181C5C03BE |
樣本
正常返回樣本
JSON格式
{
"RequestId": "5BE01CD7-5A50-472D-AC14-CA181C5C03BE\t"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。