全部产品
Search
文档中心

专有网络 VPC:CreateRouteTable - 创建自定义路由表

更新时间:Aug 28, 2026

创建自定义路由表。

接口说明

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

    • 当自定义路由表处于 Available 状态时,表示自定义路由表创建完成。

  • CreateRouteTable 接口不支持在同一个 VPC 中并发创建自定义路由表。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

RegionId

string

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

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

cn-zhangjiakou

VpcId

string

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

vpc-bp1qpo0kug3a20qqe****

RouteTableName

string

路由表的名称。

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

myRouteTable

Description

string

路由表的描述信息。

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

abc

AssociateType

string

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

  • VSwitch(默认值):交换机路由表。

  • Gateway:网关路由表。

VSwitch

RegionId

string

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

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

cn-zhangjiakou

ClientToken

string

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

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

说明

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

02fb3da4-130e-11e9-8e44-0016e04

Tag

array<object>

资源的标签。

object

标签。

Key

string

资源的标签键。最多支持输入 20 个标签键。如需传入该值,则不能输入空字符串。

一个标签键最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

FinanceDept

Value

string

资源的标签值。最多支持输入 20 个标签值。如需传入该值,可以输入空字符串。

最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

FinanceJoshua

返回参数

名称

类型

描述

示例值

object

路由表的详细信息。

RequestId

string

请求 ID。

62172DD5-6BAC-45DF-8D44-E11ED28DCAC0

RouteTableId

string

路由表 ID。

vtb-bp145q7glnuzdvzu2****

示例

正常返回示例

JSON格式

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

错误码

HTTP status code

错误码

错误信息

描述

400 UnsupportedRegion The feature of ipv4Gateway is not supported in the region. 该地域不支持ipv4网关
400 InvalidParameter.RouteTableName.Malformed The specified route table name is not valid.
400 InvalidParameter.Description.Malformed The specified Description is not valid.
400 QuotaExceeded.RouteTable VPC RouteTable quota exceeded. 超过VPC RouteTable配额。
400 IncorrectStatus.cbnStatus Current CBN status does not support this operation. CBN当前状态不正确
400 InvalidVpcId.NotSupport The vpc is not support.
400 OperationUnsupported.AdvancedFeature Advanced features of the vpc is unsupported. 不支持该高级特性。
400 QuotaExceeded.GatewayRouteTable The quota of Gateway Route Table is exceeded. 单VPC创建网关路由表Quota已达上限。
400 MissingParam.vpcId The parameter vpcId is mandatory. 参数缺失,vpcId是必选参数
400 InvalidRegionId.NotFound Specified value of RegionId is not supported.
400 InvalidParameter.Action This vpc feature is not supported in this region
404 InvalidVpcId.NotFound Specified VPC does not exist.

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

变更历史

更多信息,参考变更详情