专有网络 VPC：CreateRouteEntry

使用说明

• CreateRouteEntry接口属于异步接口，即系统会返回一个实例ID，但该路由的创建尚未完成，系统后台的启动任务仍在进行。您可以调用DescribeRouteEntryList查询路由的创建状态：
  • 当路由处于Creating状态时，表示路由创建中。
  • 当路由处于Created状态时，表示路由创建完成。
• CreateRouteEntry接口不支持在同一个VPC或者同一个VBR中并发创建自定义路由条目。

• 同一个路由表中自定义路由条目不能超过200条。
• 自定义路由条目的目标网段（DestinationCidrBlock）不能和VPC内的交换机的网段相同，也不能包含交换机的网段或者被交换机的网段包含。
• 自定义路由条目的目标网段（DestinationCidrBlock）不能指向100.64.0.0/10，也不能被100.64.0.0/10包含。
• 同一路由表下的路由条目的目标网段（DestinationCidrBlock）不允许相同。
• 如果指定的目标网段（DestinationCidrBlock）是一个IP地址，会按照32位掩码来处理。
• 多条自定义路由条目可以指向同一个下一跳（NextHopId）。
• 自定义路由条目的下一跳（NextHopId）必须和路由表在同一个VPC。
• 支持通过NextHopList参数配置ECMP路由：
  • 添加普通（非ECMP）自定义路由时，需指定DestinationCidrBlock、NextHopType和NextHopId参数，且不能指定NextHopList参数。
  • 添加ECMP路由时，需指定DestinationCidrBlock和NextHopList参数，且不能指定NextHopType和NextHopId参数。

• 同一个路由表中自定义路由条目不能超过200条。
• 不支持NextHopList参数。
• 自定义路由条目的目标网段（DestinationCidrBlock）不能指向100.64.0.0/10，也不能被100.64.0.0/10包含。
• 同一路由表下的路由条目的目标网段（DestinationCidrBlock）不允许相同。
• 如果指定的目标网段（DestinationCidrBlock）是一个IP地址，会按照32位掩码来处理。
• 多条自定义路由条目可以指向同一个下一跳（NextHopId）。
• 自定义路由条目的下一跳（NextHopId）必须是该VBR关联的路由器接口。
• 只允许在VBR状态是Active，而且对应的物理专线状态是Enabled且没有被欠费锁定的情况下在VBR上新建路由条目。
• 仅支持添加普通路由（非ECMP），需指定DestinationCidrBlock、NextHopType和NextHopId参数，且不能指定NextHopList参数。

请求参数

返回数据

示例

请求示例

http(s)://[Endpoint]/?Action=CreateRouteEntry
&RegionId=cn-hangzhou
&RouteTableId=vtb-bp145q7glnuzd****
&DestinationCidrBlock=192.168.0.0/24
&NextHopId=i-j6c2fp57q8rr4jlu****
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&RouteEntryName=test
&Description=test
&NextHopType=RouterInterface
&NextHopList=[{"NextHopId":"ri-2zeo3xzyf3cd8r4****","Weight":10,"NextHopType":"RouterInterface"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateRouteEntryResponse>
    <RouteEntryId>rte-sn6vjkioxte1gz83z****</RouteEntryId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</CreateRouteEntryResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RouteEntryId" : "rte-sn6vjkioxte1gz83z****",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

错误码

访问错误中心查看更多错误码。