新建自定義路由
描述
新建RouteEntry
支持在專有網(wǎng)絡(luò)中的路由器(VRouter)和高速通道中的邊界路由器(VBR)上的路由表(RouteTable)里，新建RouteEntry
在專有網(wǎng)絡(luò)中的路由器上的RouteTable中創(chuàng)建RouteEntry：
同一個(gè)路由表中自定義路由條目不能超過48條
RouteEntry的DestinationCidrBlock不允許和VPC內(nèi)VSwitch的CIDRBlock相同，也不允許包含VSwitch的CIDRBlock或者被VSwitch的CIDRBlock包含
RouteEntry的DestCidrBlock網(wǎng)段不允許指向100.64.0.0/10，也不允許被100.64.0.0/10包含
同一RouteTable下RouteEntry的DestCidrBlock不允許相同
如果指定的DestinationCidrBlock是一個(gè)IP地址，會按照掩碼為32位來處理
多條RouteEntry允許指向同一個(gè)InstanceId
RouteEntry指定的下一跳InstanceId，必須屬于所在的VPC
一個(gè)VPC內(nèi)，指向HaVip的路由條目最多可以同時(shí)存在5條;
支持通過NextHopList參數(shù)配置ECMP路由
在邊界路由器上的RouteTable中新建RouteEntry
同一個(gè)路由表中自定義路由條目不能超過48條
不支持NextHopList參數(shù)
RouteEntry的DestCidrBlock網(wǎng)段不允許指向100.64.0.0/10，也不允許被100.64.0.0/10包含
同一RouteTable下RouteEntry的DestCidrBlock不允許相同
如果指定的DestinationCidrBlock是一個(gè)IP地址，會按照掩碼為32位來處理
多條RouteEntry允許指向同一個(gè)InstanceId
RouteEntry指定的下一跳InstanceId，必須屬于所在的VBR
RouteEntry的下一跳類型僅支持RouterInterface
只允許在VBR狀態(tài)是Active，而且對應(yīng)的物理專線狀態(tài)是Enabled且沒有被欠費(fèi)鎖定的情況下在VBR上新建RouteEntry
請求參數(shù)
名稱
類型
是否必須
描述
Action
String
是
系統(tǒng)規(guī)定參數(shù)，取值：CreateRouteEntry
RouteTableId
String
是
RouteTableId
DestinationCidrBlock
String
是
RouteEntry的目的網(wǎng)段
NextHopType
String
否
下一跳的類型，可選值為Instance|Tunnel|HaVip，默認(rèn)值為Instance
NextHopId
String
否
路由條目的下一跳實(shí)例ID，非ECMP路由
NextHopList
NextHopListType
否
路由條目的下一跳列表如果指定了NextHopList，則該路由為ECMP類路由，NextHopList包含了ECMP方式的多個(gè)下一跳。此時(shí)NextHopType和NextHopId必須為空，NextHopList支持包含有2-4個(gè)下一跳。
如果沒有指定NextHopList，則該路由為非ECMP類路由。由NextHopType和NextHopId指定下一跳。
ClientToken
String
否
用于保證請求的冪等性。由客戶端生成該參數(shù)值，要保證在不同請求間唯一，最大不值過64個(gè)ASCII字符。
具體參見附錄：如何保證冪等性。
返回參數(shù)
全是公共返回參數(shù)，詳見公共返回參數(shù)
錯(cuò)誤碼
錯(cuò)誤代碼
描述
Http 狀態(tài)碼
語義
MissingParameter
Miss mandatory parameter.
400
缺少必要參數(shù)參數(shù)
InvalidCidrBlock.Malformed
Specified CIDR block is not valid.
400
指定的網(wǎng)段不合法
InvalidNextHopId.NotFound
Specified next hop does not exist.
404
指定的NextHopId不存在
InvalidInstanceId.NotFound
Specified instance does not exist.
404
指定的ECS實(shí)例不存在（實(shí)例不在該vpc下）
InvalidRouteTableId.NotFound
Specified route table does not exist.
404
指定的虛擬路由表不存在
InvalidCIDRBlock.Duplicate
Specified CIDR block is already exists.
400
指定的網(wǎng)段已經(jīng)在該路由表中存在
IncorrectVpcStatus
Current VPC status does not support this operation.
400
所指定的VPC未創(chuàng)建完成
QuotaExceeded
Route entry quota exceeded in this route table.
400
同一個(gè)路由表中自定義路由條目不能超過48條
IncorretRouteEntryStatus
Some route entry status blocked this operation.
400
同一個(gè)vpc下面的路由表中的任一個(gè)路由條目/VSwitch處在中間狀態(tài)（添加中，修改中，刪除中），不能創(chuàng)建路由條目
InvalidCidrBlock
Specified CIDR block is not valid.
400
1. 該用戶不在10.0.0.0/8的路由網(wǎng)段的白名單中，不能使用該網(wǎng)段。
2. 添加的自定義路由目標(biāo)網(wǎng)段不能從屬于同一個(gè)vpc下面所有vswitch的網(wǎng)段。
3. 網(wǎng)段不能是：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不能同時(shí)為空
InvalidHaViNpId.NotFound
The specified HaVip does not exist in the specified VPC.
404
指定的HaVip不存在，或者不屬于當(dāng)前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個(gè)下一跳
CountLimitExceed.HaVipRouteEntry
There can be 5 route entry to HaVip at most in one route table.
400
一個(gè)VPC內(nèi)，指向HaVip對象的路由最多同時(shí)只能存在五條。
IncorrectHaVipStatus
This operation is denied because satus of the specified HaVip is neither Available nor InUse.
400
只有當(dāng)HaVip的狀態(tài)為Available或者InUse時(shí)，創(chuàng)建指向這個(gè)HaVip的路由。
InvalidVBRStatus
invalid virtual border router status.
400
VBR狀態(tài)不合法
InvalidPhysicalConnectionBusinessStatus
invalid physical connection business status.
400
物理專線業(yè)務(wù)狀態(tài)被鎖定
InvalidRouterType
Cannot specify nexthop list in vbr's route table.
400
不能在VBR的路由表中指定NextHopList
InvalidRouteEntry.Duplicate
The route entry already exist.
400
該路由條目已經(jīng)存在
IncorrectInstanceStatus
The current status of the resource does not support this operation.
403
指定實(shí)例的狀態(tài)不支持當(dāng)前操作
示例
請求示例
https://ecs.aliyuncs.com/?Action=CreateRouteEntry
&VpcId=vpc-257gq642n
&DestinationCidrBlock=0.0.0.0/0
&NextHopId=i-25skktcp4
&NextHopType=Instance
&<公共請求參數(shù)>
返回示例
