调用CreateRouteTable接口创建自定义路由表。

使用说明

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

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 是 cn-zhangjiakou

路由表所属的VPC的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

VpcId String 是 vpc-bp1qpo0kug3a20qqe****

自定义路由表所属的VPC ID。

如果VPC中含有以下实例规格族中的任一实例，则不支持为该VPC创建自定义路由表。

ecs.c1、ecs.c2、ecs.c4、ecs.ce4、ecs.cm4、ecs.d1、ecs.e3、ecs.e4、ecs.ga1、ecs.gn4、ecs.gn5、ecs.i1、ecs.m1、ecs.m2、ecs.mn4、ecs.n1、ecs.n2、ecs.n4、ecs.s1、ecs.s2、ecs.s3、ecs.se1、ecs.sn1、ecs.sn2、ecs.t1、ecs.xn4。

如需创建自定义路由表，请先升级实例规格或释放实例。

说明 如果您的VPC中含有实例规格族限制中的任一实例，且您已经创建了自定义路由表，为了保证正常使用自定义路由表功能，请升级实例规格或释放实例。
RouteTableName String 否 myRouteTable

路由表的名称。

名称长度为1～128个字符，不能以http://或https://开头。

Description String 否 abc

路由表的描述信息。

描述长度为1～256个字符，不能以http://或https://开头。

AssociateType String 否 VSwitch

创建的路由表的类型。取值：

  • VSwitch（默认值）：交换机路由表。
  • Gateway：网关路由表。
Action String 是 CreateRouteTable

系统规定参数。取值：CreateRouteTable。

ClientToken String 否 02fb3da4-130e-11e9-8e44-0016e04

客户端Token，用于保证请求的幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。

返回数据

名称 类型 示例值 描述
RequestId String 62172DD5-6BAC-45DF-8D44-E11ED28DCAC0

请求ID。
RouteTableId String vtb-bp145q7glnuzdvzu2****

路由表ID。
AssociateType String VSwitch

创建的路由表的类型。取值：

  • VSwitch：交换机路由表。
  • Gateway：网关路由表。

示例

请求示例

http(s)://[Endpoint]/?RegionId=cn-zhangjiakou
&VpcId=vpc-bp1qpo0kug3a20qqe****
&RouteTableName=myRouteTable
&Description=abc
&AssociateType=VSwitch
&Action=CreateRouteTable
&ClientToken=02fb3da4-130e-11e9-8e44-0016e04
&公共请求参数

正常返回示例

XML格式 

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

<CreateRouteTableResponse>
    <RequestId>62172DD5-6BAC-45DF-8D44-E11ED28DCAC0</RequestId>
    <RouteTableId>vtb-bp145q7glnuzdvzu2****</RouteTableId>
    <AssociateType>VSwitch</AssociateType>
</CreateRouteTableResponse>

JSON格式 

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

{
  "RequestId" : "62172DD5-6BAC-45DF-8D44-E11ED28DCAC0",
  "RouteTableId" : "vtb-bp145q7glnuzdvzu2****",
  "AssociateType" : "VSwitch"
}

错误码

HttpCode 错误码 错误信息 描述
400 UnsupportedRegion The feature of ipv4Gateway is not supported in the region. 该地域不支持ipv4网关
400 InvalidParameter.Description.Malformed The specified Description is not valid. 该描述不合法。
400 IncorrectStatus.cbnStatus Current CBN status does not support this operation. CBN当前状态不正确
404 InvalidVpcId.NotFound Specified VPC does not exist. 该VPC不存在。

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