创建路由规则
更新时间：2025-08-06
描述
创建路由表规则，有以下几点需要注意：
- 源网段选择自定义时，自定义网段需在已有子网范围内,0.0.0.0/0除外；
- 目标网段不能与当前所在VPC cidr重叠（目标网段或本VPC cidr为0.0.0.0/0时例外）；
- 新增路由条目的源网段和目标网段，不能与路由表中已有条目源网段和目标网段完全一致；
请求结构
Plain Text
1 POST /v{version}/route/rule?clientToken={clientToken} HTTP/1.1
2 Host: bcc.bj.baidubce.com
3 Authorization: authorization string
4 {
5 "routeTableId":{routeTableId},
6 "sourceAddress": {sourceAddress},
7 "destinationAddress": {destinationAddress},
8 "nexthopId": {nexthopId},
9 "nexthopType": {nexthopType},
10 "description": {description}
11 } 请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见ClientToken幂等性。 |
| routeTableId | String | 是 | Request Body 参数 | 路由表ID |
| sourceAddress | String | 是 | Request Body 参数 | 源网段，可填全部网段0.0.0.0/0、VPC内已有子网网段或子网范围内网段 |
| destinationAddress | String | 是 | Request Body 参数 | 目标网段 |
| nexthopId | String | 否 | Request Body 参数 | 下一跳ID，创建单线路由时该字段必填 |
| nexthopType | String | 否 | Request Body 参数 | 路由类型，创建单线路由时该字段必填；Bcc类型是"custom"；VPN类型是"vpn"；NAT类型是"nat"；专线网关类型是"dcGateway";对等连接类型是"peerConn"(注意：对等连接类型nexthopId传递本端接口id,非对等连接id,如：qpif-abuf50qxxxxx) |
| nextHopList | List<NextHop> | 否 | Request Body 参数 | 多线路由下一跳信息，创建多线路由时该字段必填 |
| description | String | 否 | Request Body 参数 | 路由表规则描述，不超过200字符 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| routeRuleId | String | 单线路由规则ID，创建单线路由时返回该参数 |
| routeRuleIds | List<String> | 多线路由规则ID，创建多线路由（主备、负载均衡）时返回该参数 |
请求示例
Plain Text
1 POST /v1/route/rule?clientToken=3fcf57c1-73c7-42c9-8075-6dda96c06f6b HTTP/1.1
2 Host: bcc.bj.baidubce.com
3 Content-Type: application/json;charset=UTF-8
4 Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5{
6 "routeTableId":"rt-q1zg3i8mx8p6",
7 "sourceAddress": "192.168.0.0/20",
8 "destinationAddress": "0.0.0.0/0",
9 "nexthopId": "nat-bdidwhwfwc6p",
10 "nexthopType": "nat",
11 "description": "this is a route rule"
12}返回示例
Plain Text
1 HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3 Date: Thu, 16 Mar 2017 06:29:48 GMT
4 Content-Type: application/json;charset=UTF-8
5 Server: BWS
6{
7 "routeRuleId": "rr-dup3cxpebi5e"
8}