全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
专有网络 VPC

CreateRouteEntry

更新时间:2018-04-19 11:00:26

描述

在VPC路由器或边界路由器(VBR)上创建路由条目。

使用该API为专有网络中的路由器的路由表添加自定义路由条目时,请注意:

  • 同一个路由表中自定义路由条目不能超过48条。

  • 路由条目的DestinationCidrBlock不能和VPC内VSwitch的CIDRBlock相同,也不能包含VSwitch的CIDRBlock或者被VSwitch的CIDRBlock包含。

  • 路由条目的DestinationCidrBlock网段不能指向100.64.0.0/10,也不能被100.64.0.0/10包含。

  • 同一路由表下的路由条目的DestinationCidrBlock不允许相同。

  • 如果指定的DestinationCidrBlock是一个IP地址,会按照掩码为32位来处理。

  • 多条路由条目可以指向同一个NextHopId

  • 路由条目的下一跳NextHopId,必须属于所在的VPC。

  • 一个VPC内,指向HaVip的路由条目最多可以同时存在5条。

  • 支持通过NextHopList参数配置ECMP路由:

    • 添加普通(非 ECMP )自定义路由时,需指定 DestinationCidrBlockNextHopType(默认为Instance) 和 NextHopId,且不能指定 NextHopList
    • 添加 ECMP 路由时,需指定DestinationCidrBlockNextHopList,且不能指定NextHopTypeNextHopId

使用该API为边界路由器的路由表添加自定义路由条目时,请注意:

  • 同一个路由表中自定义路由条目不能超过48条。

  • 不支持NextHopList参数。

  • 路由条目的DestCidrBlock网段不能指向100.64.0.0/10,也不能被100.64.0.0/10包含。

  • 同一路由表下的路由条目的DestinationCidrBlock不允许相同。

  • 如果指定的DestinationCidrBlock是一个IP地址,会按照掩码为32位来处理。

  • 多条路由条目可以指向同一个InstanceId

  • 路由条目的下一跳InstanceId,必须属于所在的VBR。

  • 路由条目的下一跳类型仅支持RouterInterface

  • 只允许在VBR状态是Active,而且对应的物理专线状态是Enabled且没有被欠费锁定的情况下在VBR上新建路由条目。

  • 仅支持添加普通路由(非 ECMP),需指定DestinationCidrBlockNextHopType(默认为Instance)和NextHopId,且不能指定NextHopList

请求参数

名称 类型 是否必须 描述
Action String 接口名,系统规定参数。

取值:CreateRouteEntry

RouteTableId String 路由表的ID。
DestinationCidrBlock String 路由条的目标网段,需满足以下要求:

  • 目标网段不能指向100.64.0.0/10或被100.64.0.0/10包含。
  • 同一张路由表内的不同路由条目的目标网段不能相同。
  • 如果提供的目标网段是一个IP地址,掩码将按照32位处理。
NextHopType String 下一跳的类型,创建普通(非ECMP路由)路由条目时指定该参数。取值:

  • Instance:ECS实例(默认值)
  • Tunnel:隧道
  • HaVip:高可用虚拟IP
  • RouterInterface:路由器接口
  • VpnGateway:VPN网关
NextHopId String 路由条目的下一跳实例ID,创建普通(非ECMP路由)路由条目时指定该参数。

下一跳必须位于路由表所在的VPC或VBR中。

NextHopList NextHopListType 路由条目的下一跳列表,创建ECMP路由条目时指定该参数。需满足以下条件:

  • 只支持在VPC中的路由表创建ECMP路由条目。
  • NextHopList中的下一跳数量为2-4个。
  • NextHopList中的下一跳只能是VPC中指向VBR的路由器接口。
详情参见NextHopListType
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符。

详情参见如何保证幂等性

返回参数

名称 类型 描述
RequestId String 请求ID。

错误码

关于本接口的错误码的详细解释,请参见VPC API错误中心

示例

请求示例

  1. https://vpc.aliyuncs.com/?Action=CreateRouteEntry
  2. &VpcId=vpc-257gq642n
  3. &RouteTableId=vrt-5citwfp6a
  4. &DestinationCidrBlock=0.0.0.0/0
  5. &NextHopId=i-25skktcp4
  6. &NextHopType=Instance
  7. &<公共请求参数>

返回示例

XML格式

  1. <CreateRouteEntryResponse>
  2. <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId>
  3. </CreateRouteEntryResponse>

JSON格式

  1. {
  2. "RequestId": "12D086F6-8F31-4658-84C1-006DED011A85"
  3. }
本文导读目录