354
阿裏雲
新建自定義路由__路由表相關接口_API 參考_雲服務器 ECS-阿裏雲
描述
新建RouteEntry
支持在專有網絡中的路由器（VRouter）和高速通道中的邊界路由器（VBR）上的路由表（RouteTable）裏，新建RouteEntry
在專有網絡中的路由器上的RouteTable中創建RouteEntry：
- 同一個路由表中自定義路由條目不能超過48條
- RouteEntry的
DestinationCidrBlock不允許和VPC內VSwitch的CIDRBlock相同，也不允許包含VSwitch的CIDRBlock或者被VSwitch的CIDRBlock包含 - RouteEntry的
DestCidrBlock網段不允許指向100.64.0.0/10，也不允許被100.64.0.0/10包含 - 同一RouteTable下RouteEntry的
DestCidrBlock不允許相同 - 如果指定的
DestinationCidrBlock是一個IP地址，會按照掩碼為32位來處理 - 多條RouteEntry允許指向同一個
InstanceId - RouteEntry指定的下一跳
InstanceId，必須屬於所在的VPC - 一個VPC內，指向HaVip的路由條目最多可以同時存在5條；
- 支持通過NextHopList參數配置ECMP路由
在邊界路由器上的RouteTable中新建RouteEntry
- 同一個路由表中自定義路由條目不能超過48條
- 不支持NextHopList參數
- RouteEntry的
DestCidrBlock網段不允許指向100.64.0.0/10，也不允許被100.64.0.0/10包含 - 同一RouteTable下RouteEntry的
DestCidrBlock不允許相同 - 如果指定的
DestinationCidrBlock是一個IP地址，會按照掩碼為32位來處理 - 多條RouteEntry允許指向同一個
InstanceId - RouteEntry指定的下一跳
InstanceId，必須屬於所在的VBR - RouteEntry的下一跳類型僅支持RouterInterface
- 隻允許在VBR狀態是Active，而且對應的物理專線狀態是Enabled且沒有被欠費鎖定的情況下在VBR上新建RouteEntry
請求參數
| 名稱 | 類型 | 是否必須 | 描述 |
|---|---|---|---|
| Action | String | 是 | 係統規定參數，取值：CreateRouteEntry |
| RouteTableId | String | 是 | RouteTableId |
| DestinationCidrBlock | String | 是 | RouteEntry的目的網段 |
| NextHopType | String | 否 | 下一跳的類型，可選值為Instance|Tunnel|HaVip|RouterInterface，默認值為Instance |
| NextHopId | String | 否 | 路由條目的下一跳實例ID，非ECMP路由 |
| NextHopList | NextHopListType | 否 | 路由條目的下一跳列表如果指定了NextHopList，則該路由為ECMP類路由，NextHopList包含了ECMP方式的多個下一跳。此時NextHopType和NextHopId必須為空，NextHopList支持包含有2-4個下一跳。隻支持VRouter上的路由指定NextHopList，而且下一跳隻能是從VRouter連往VBR方向的RouterInterface 如果沒有指定NextHopList，則該路由為非ECMP類路由。由NextHopType和NextHopId指定下一跳。 |
| ClientToken | String | 否 | 用於保證請求的冪等性。由客戶端生成該參數值，要保證在不同請求間唯一，最大不值過64個ASCII字符。 具體參見附錄：如何保證冪等性。 |
返回參數
全是公共返回參數，詳見公共返回參數
錯誤碼
| 錯誤代碼 | 描述 | Http 狀態碼 | 語義 |
|---|---|---|---|
| MissingParameter | Miss mandatory parameter. | 400 | 缺少必要參數參數 |
| InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | 400 | 指定的網段不合法 |
| InvalidNextHopId.NotFound | Specified next hop does not exist. | 404 | 指定的NextHopId不存在 |
| InvalidInstanceId.NotFound | Specified instance does not exist. | 404 | 指定的ECS實例不存在（實例不在該vpc下） |
| InvalidRouteTableId.NotFound | Specified route table does not exist. | 404 | 指定的虛擬路由表不存在 |
| InvalidCIDRBlock.Duplicate | Specified CIDR block is already exists. | 400 | 指定的網段已經在該路由表中存在 |
| IncorrectVpcStatus | Current VPC status does not support this operation. | 400 | 所指定的VPC未創建完成 |
| QuotaExceeded | Route entry quota exceeded in this route table. | 400 | 同一個路由表中自定義路由條目不能超過48條 |
| IncorretRouteEntryStatus | Some route entry status blocked this operation. | 400 | 同一個vpc下麵的路由表中的任一個路由條目/VSwitch處在中間狀態（添加中，修改中，刪除中），不能創建路由條目 |
| InvalidCidrBlock | Specified CIDR block is not valid. | 400 | 1. 該用戶不在10.0.0.0/8的路由網段的白名單中，不能使用該網段。 2. 添加的自定義路由目標網段不能從屬於同一個vpc下麵所有vswitch的網段。 3. 網段不能是：100.64.0.0/10。 |
| InvalidNextHop.NotFound | Specified next hop does not exist. | 404 | 指定的next hop不存在 |
| InvalidNexthopTypeAndList.BothNull | both nexthopType and nextHopList are null. | 400 | NexthopType和NextHopList不能同時為空 |
| InvalidHaViNpId.NotFound | The specified HaVip does not exist in the specified VPC. | 404 | 指定的HaVip不存在，或者不屬於當前RouterTable所在的VPC。 |
| InvalidRouterInterface | invalid router interface. | 400 | 指定的RouterInterface不合法 |
| InvalidOppositeRouterType | nexthop list cannot only contain router interface whose opposite router interface is on vbr. | 400 | NextHopList隻能包含對端路由器接口在VBR上的路由器接口 |
| InvalidNexthopListSize | nexthop size is illegal. Must be between 2 and 4. | 400 | NextHopList中需要包含2-4個下一跳 |
| CountLimitExceed.HaVipRouteEntry | There can be 5 route entry to HaVip at most in one route table. | 400 | 一個VPC內，指向HaVip對象的路由最多同時隻能存在五條。 |
| IncorrectHaVipStatus | This operation is denied because satus of the specified HaVip is neither Available nor InUse. | 400 | 隻有當HaVip的狀態為Available或者InUse時，創建指向這個HaVip的路由。 |
| InvalidVBRStatus | invalid virtual border router status. | 400 | VBR狀態不合法 |
| InvalidPhysicalConnectionBusinessStatus | invalid physical connection business status. | 400 | 物理專線業務狀態被鎖定 |
| InvalidRouterType | Cannot specify nexthop list in vbr’s route table. | 400 | 不能在VBR的路由表中指定NextHopList |
| InvalidRouteEntry.Duplicate | The route entry already exist. | 400 | 該路由條目已經存在 |
| IncorrectInstanceStatus | The current status of the resource does not support this operation. | 403 | 指定實例的狀態不支持當前操作 |
示例
請求示例
https://ecs.aliyuncs.com/?Action=CreateRouteEntry&VpcId=vpc-257gq642n&DestinationCidrBlock=0.0.0.0/0&NextHopId=i-25skktcp4&NextHopType=Instance&<公共請求參數>
返回示例
XML格式
<CreateRouteEntryResponse><RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId></CreateRouteEntryResponse>
JSON格式
{"RequestId": "12D086F6-8F31-4658-84C1-006DED011A85"}
最後更新：2016-11-23 16:03:50
上一篇： 修改交換機屬性__交換機相關接口_API 參考_雲服務器 ECS-阿裏雲
下一篇： 刪除自定義路由__路由表相關接口_API 參考_雲服務器 ECS-阿裏雲
- 資源訪問控製__授權管理_用戶指南_訪問控製-阿裏雲
- 雲解析(企業版)服務條款__服務條款_產品簡介_雲解析-阿裏雲
- 3.1 創建數據庫與配置__第三章 DDL_使用手冊_分析型數據庫-阿裏雲
- 2015-12-09__Release-Notes_日誌服務-阿裏雲
- 繪製SQL結果集的圖表__應用場景_產品簡介_數據管理-阿裏雲
- 對比度__圖片效果_圖片處理指南_對象存儲 OSS-阿裏雲
- 阿裏雲棲大會今天開始，153億暗中瘋狂調倉，二次上攻成功將再上3400點，提示和熱點前瞻！
- 雲服務器 ECS Linux配置選型
- 排序sort子句__搜索子句介紹_API參考手冊_開放搜索-阿裏雲
- 阿裏雲的 IaaS 收入相當於中國另 7 個玩家的總和，占有 40.7％ 的市場份額
相關內容
- 常見錯誤說明__附錄_大數據計算服務-阿裏雲
- 發送短信接口__API使用手冊_短信服務-阿裏雲
- 接口文檔__Android_安全組件教程_移動安全-阿裏雲
- 運營商錯誤碼（聯通）__常見問題_短信服務-阿裏雲
- 設置短信模板__使用手冊_短信服務-阿裏雲
- OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
- 消息通知__操作指南_批量計算-阿裏雲
- 設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
- 查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
- 使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲