创建路由表

最近更新时间:2019-08-28 16:11:20

我的收藏

1. 接口描述

本接口(CreateRouteTable)用于创建路由表。 接口请求域名:vpc.api.qcloud.com
创建了 VPC 后,系统会创建一个默认路由表,所有新建的子网都会关联到默认路由表。默认情况下您可以直接使用默认路由表来管理您的路由策略。当您的路由策略较多时,您可以调用创建路由表接口创建更多路由表管理您的路由策略。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 CreateRouteTable。
参数名称
是否必选
类型
描述
vpcId
String
子网所属的私有网络 ID 值,可使用 vpcId 或 unVpcId,建议使用 unVpcId,例如:vpc-rqndayhs。可通过 DescribeVpcEx 接口查询。
routeTableName
String
路由表名称,可任意命名,但不得超过60个字符。
routeSet.n
array
路由表内容,可选项。
routeSet.n.destinationCidrBlock
String
目的网段,取值不能在私有网络网段内,例如:112.20.51.0/24。
routeSet.n.nextType
String
下一跳类型,目前我们支持的类型有:0:公网网关;1:VPN 网关; 3:专线网关;4:对等连接;7:sslvpn网关;8:NAT 网关;9:普通云服务器。
routeSet.n.nextHub
String
下一跳地址,这里只需要指定不同下一跳类型的网关 ID(推荐使用新 ID),系统会自动匹配到下一跳地址。
routeSet.n.description
String
路由描述,支持60内个字符。

3. 输出参数

参数名称
类型
描述
code
Int
错误码,0: 成功,其他值: 失败。
message
String
错误信息。
routeTableId
String
路由表 ID,例如:gz_rtb_4545。
unRouteTableId
String
路由表统一 ID,建议使用统一 ID 标识路由表,例如:rtb-rqndayhs。
routeTableSet.n
Array
路由表内容。
routeTableSet.n.destinationCidrBlock
String
目的网段,取值不能在私有网络网段内,例如:112.20.51.0/24。
routeTableSet.n.nextType
String
下一跳类型,目前我们支持的类型有:0:公网网关;1:VPN 网关; 3:专线网关;4:对等连接;7:sslvpn;8:NAT 网关。
routeTableSet.n.nextHub
String
下一跳地址,这里只需要指定不同下一跳类型的网关 ID(推荐使用新 ID),系统会自动匹配到下一跳地址。
routeTableSet.n.description
String
路由描述。

4. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 VPC 错误码
错误码
描述
InvalidVpc.NotFound
无效的 VPC。VPC 资源不存在,请再次核实您输入的资源信息是否正确,可通过 DescribeVpcEx 接口查询 VPC。
InvalidRouteTableName
路由表名称不合法。可任意命名,但不得超过60个字符。
InvalidDestinationCidr
目标网段不合法。
RouteTableLimitExceeded
创建的路由表数量超过上限。如果需要更多资源,请联系客服申请。更多 VPC 资源限制信息详见 VPC 使用限制
RouteLimitExceeded
路由表策略数超过上限。如果需要更多资源,请联系客服申请。更多 VPC 资源限制信息详见 VPC 使用限制
RouteAlreadyExists
目标网段在路由表策略中已存在。同一个路由表里策略中,目标网段不能冲突。
InvalidRouteNextType
无效的下一跳类型。可以支持的类型详见入参说明。
InvalidRouteNextHub.NotFound
下一跳地址不存在。请核实您填写的下一跳地址资源 ID 是否正确。

5. 示例

输入
https://vpc.api.qcloud.com/v2/index.php?Action=CreateRouteTable
&<公共请求参数>
&vpcId=vpc-amhnnao5
&routeTableName=tttt111
&routeSet.0.destinationCidrBlock=121.0.23.51/16
&routeSet.0.nextType=1
&routeSet.0.nextHub=vpngw-dystbrkv
输出

{
"code": 0,
"message": "",
"routeTableId": "gz_rtb_8755",
"unRouteTableId": "rtb-rqndayhs",
"routeTableSet": [
{
"destinationCidrBlock": "121.0.23.51\/16",
"nextType": 1,
"nextHub": "vpngw-dystbrkv"
}
]
}