調用ModifyRouteEntry修改自定義路由條目的名稱、描述和路由下一跳。
接口說明
- ModifyRouteEntry 接口不支持并發修改同一個自定義路由條目的名稱和描述。
- ModifyRouteEntry 接口在并發情況下可能返回 TaskConflict 錯誤碼,請酌情重試。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
vpc:ModifyRouteEntry | update | *RouteTable acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 路由條目所在的地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
RouteEntryName | string | 否 | 路由條目的名稱。 名稱長度為 1~128 個字符,不能以 | EntryName |
RouteEntryId | string | 否 | 自定義路由條目 ID。 | rte-acfvgfsghfdd**** |
Description | string | 否 | 路由條目的描述。 描述長度為 1~256 個字符,不能以 | EntryDescription |
NewNextHopType | string | 否 | 新路由條目下一跳類型。取值如下:
| NetworkInterface |
NewNextHopId | string | 否 | 新路由條目下一跳實例 ID。 | eni-bp17y37ytsenqyim**** |
RouteTableId | string | 否 | 路由表 ID。 | vtb-bp1nk7zk65du3pni8z9td |
DestinationCidrBlock | string | 否 | 路由條目的目標網段,支持 IPv4 網段、IPv6 網段、前綴列表網段和前綴列表的實例 ID。 說明
當 RouteEntryId 參數未輸入時,DestinationCidrBlock 和 RouteTableId 參數必填。
| 192.168.0.0/24 |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "861E6630-AEC0-4B2D-B214-6CB5E44B7F04"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidRouteEntryId.NotFound | Specified RouteEntryId does not exist. | 指定的路由條目未找到 |
400 | InvalidRouteEntryName.Malformed | Specified RouteEntry name is not valid. | 無法修改,因為指定的路由條目名稱無效 |
400 | InvalidRouteEntryId.NotFound | The specified routeEntry does not exist. | 指定的路由條目不存在。 |
400 | OperationDenied.ModifyManagedRouteEntry | The operation is not allowed because of route entry is managed. | 無法修改被托管的路由。 |
400 | OperationDenied.RouteTableTypeNotPermitted | The operation is not allowed because the type of route table is not permitted. | 指定路由表類型不允許創建路由條目 |
400 | MissingParam.NewNextHopId | The parameter NewNextHopId is mandatory. | 修改路由條目下一跳缺失待修改路由條目下一跳實例ID信息。 |
400 | IllegealParam.NextHopType | The parameter NewNextHopType is illegal. | 路由條目下一跳類型非法。 |
400 | UnsupportedFeature.NormalTypeNatGateway | Normal nat gateways do not support modifying the next hop of the route. | 指向普通類型NAT網關的路由條目不支持修改下一跳。 |
400 | UnsupportedFeature.NextHopType | The route type does not support modifying the next hop of the route. | 當前路由條目不支持修改下一跳信息。 |
400 | InvalidRouteTable.NotFound | The specified routetable does not exist. | 路由表實例不存在。 |
400 | InvalidNetworkInterface.NotFound | The specified network interface does not exist. | 指定的網卡類型下一跳實例ID不存在。 |
400 | OperationDenied.NextHopExist | The operation is not allowed because the nexthop already exists. | 需要修改的目標路由條目下一跳已存在。 |
400 | MissingParam.NewNextHopType | The parameter NewNextHopType is mandatory. | 修改路由條目下一跳缺失待修改路由條目下一跳實例類型信息。 |
400 | UnsupportedFeature.ModifyRouteEntryNextHop | The current region does not support the function of modifying the route next hop. | 當前地域不支持修改路由下一跳功能。 |
400 | IncorrectRouteEntryStatus | Some route entry status blocked this operation. | 無法執行該操作,當前路由表中有路由條目的狀態為pending或modifying。 |
400 | ResourceNotFound.VSwitch | The vSwitch where the specified networkinterface is located does not exist. | 彈性網卡所在的交換機不存在 |
400 | MissingParam.RouteEntryId | The param of %s is missing. | 缺少必須參數 |
400 | IllegalParam.RouteEntryName | The param of %s is illegal. | 指定路由名稱不合法 |
400 | OperationDenied.LocalRouteEntryModified | The next hop of a local route is modified. | 存在local類型的路由下一跳被修改了。 |
400 | OperationDenied.IllegalNewNextHopType | When modifying the next hop of a route of the local type, a new next hop type that is not supported is passed in. | 修改local類型的路由下一跳時,傳入了不支持的新的下一跳類型。 |
400 | OperationDenied.LocalRouteEntryModified | When you modify the next hop of a Local route in a custom routing table, the destination CIDR block of the Local route is exactly the same as the Cidr of a VSwitch bound to the routing table. | 修改自定義路由表Local路由的下一跳時,該Local路由的目的網段恰好和路由表綁定的某個交換機的Cidr相等。 |
400 | UnsupportedFeature.VpcAdvancedFeature | The VPC does not support some advanced features. | 該VPC不支持某些高級功能,請提交工單處理。 |
400 | UnsupportedRegion | The feature is not supported in current region. | 當前地域不支持該功能。 |
400 | OperationFailed.NotSupportIPV6 | The specified next hop does not support IPv6. | 指定的下一跳不支持IPv6功能。 |
400 | UnsupportedFeature.ModifyIpv6RouteEntryNextHop | The current region does not support the feature of modifying the IPv6 route next hop. | 操作失敗,因為當前地域不支持修改IPv6路由下一跳。 |
400 | OperationDenied.NewNextHopNotSupportPublish | New nexthop is not supported for published route entry. | 該路由條目已經發布到其他組件,指定的下一跳類型不支持路由發布。 |
400 | IllegalParam.DestCidrBlock | The destCidrBlock is invalid. | 傳入的目標地址不合法 |
403 | Forbbiden | User not authorized to operate on the specified resource. | 用戶沒有權限操作指定的資源。 |
404 | ResourceNotFound.NatGateway | The specific NAT gateway is not found. | 指定的 NAT 網關不存在。 |
404 | ResourceNotFound.GatewayLoadBalancerEndpoint | GatewayLoadBalancerEndpoint instance not found. | 未找到GatewayLoadBalancerEndpoint實例。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-11-19 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-11-06 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-10-28 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-09-29 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-09-13 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-09-06 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-09-03 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-08-29 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2024-06-05 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-05-23 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-03-25 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-12-25 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-09-15 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-09-15 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2023-05-08 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |