阿里云如何使用新建自定义路由接口

新建自定义路由

描述

新建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

&<公共请求参数>

返回示例

所属专题:

如果您觉得本文或图片不错，请把它分享给您的朋友吧！