1. 接口描述
本接口(ModifyRouteTableAttribute)用于修改路由表属性。
接口请求域名:vpc.api.qcloud.com
修改路由表后会用新提交的内容全量替换原有的路由表内容。用户需要新增路由策略时请将原有内容一并提交。
2. 输入参数
参数名称 | 是否必选 | 类型 | 描述 |
vpcId | 是 | String | |
routeTableId | 是 | String | 系统分配的路由表 ID 值,可使用 routeTableId 或 unRouteTableId,建议使用unRouteTableId,例如:rtb-rqndayhs。可通过 DescribeRouteTable 接口查询。 |
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 | 错误信息。 |
4. 错误码表
错误码 | 描述 |
InvalidVpc.NotFound | |
InvalidRouteTableId.NotFound | |
InvalidRouteTableName | 路由表名称不合法。可任意命名,但不得超过60个字符。 |
RouteLimitExceeded | |
RouteAlreadyExists | 目标网段在路由表策略中已存在。同一个路由表里策略中,目标网段不能冲突。 |
InvalidRouteNextType | 无效的下一跳类型。可以支持的类型详见入参说明。 |
InvalidRouteNextHub.NotFound | 下一跳地址不存在。请核实您填写的下一跳地址资源 ID 是否正确。 |
InvalidRoute.NextHubLimitExceeded | 公网网关 ECMP 不能超过8个。 |
5. 示例
输入
https://vpc.api.qcloud.com/v2/index.php?Action=ModifyRouteTableAttribute&<公共请求参数>&vpcId=vpc-amhnnao5&routeTableId=rtb-8oidkjt2&routeSet.0.destinationCidrBlock=121.0.23.51/18&routeSet.0.nextType=1&routeSet.0.nextHub=vpngw-dystbrkv&routeTableName=tttt111
输出
{"code": 0,"message": ""}