新建自定义路由
描述
新建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，默认值为Instance |
| NextHopId | String | 否 | 路由条目的下一跳实例ID，非ECMP路由 |
| NextHopList | NextHopListType | 否 | 路由条目的下一跳列表如果指定了NextHopList，则该路由为ECMP类路由，NextHopList包含了ECMP方式的多个下一跳。此时NextHopType和NextHopId必须为空，NextHopList支持包含有2-4个下一跳。 如果没有指定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
&<公共请求参数>
返回示例
