 |
|||||||||||||
云南西双版纳特产小花糯玉米真空包装阿里云如何使用修改交换机属性接口
多米音乐盒可以在港澳台及国外地区使用多米音乐吗
win7电脑中怎么查询电源情况
阿里云如何使用查询交换机列表接口
搜狗手写输入法桌面快捷方式怎么设置？
阿里云如何使用删除交换机接口
阿里云如何使用新建交换机接口
MathType公式编号格式的方法
阿里云如何使用修改路由器属性接口
阿里云如何使用查询路由器列表接口
新建自定义路由
描述
新建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
&<公共请求参数>
返回示例
