创建路由规则
更新时间:2022-11-24
描述
创建路由表规则,有以下几点需要注意:
- 源网段选择自定义时,自定义网段需在已有子网范围内,0.0.0.0/0除外;
- 目标网段不能与当前所在VPC cidr重叠(目标网段或本VPC cidr为0.0.0.0/0时例外);
- 新增路由条目的源网段和目标网段,不能与路由表中已有条目源网段和目标网段完全一致。
请求结构
POST /v{version}/route/rule HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"routeTableId":{routeTableId},
"sourceAddress": {sourceAddress},
"destinationAddress": {destinationAddress},
"nexthopId": {nexthopId},
"nexthopType": {nexthopType},
"description": {description}
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号 |
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" |
nextHopList | List<NextHop> | 否 | Request Body 参数 | 多线路由下一跳信息,创建多线路由时该字段必填 |
description | String | 否 | Request Body 参数 | 描述 |
返回头域
除公共头域,无其它特殊头域。
返回参数
参数名称 | 类型 | 描述 |
---|---|---|
routeRuleId | String | 单线路由规则ID,创建单线路由时返回该参数 |
routeRuleIds | List<String> | 多线路由规则ID,创建多线路由(主备、负载均衡)时返回该参数 |
请求示例
POST /v1/route/rule HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"routeTableId":"rt-q1zg3i8mx8p6",
"sourceAddress": "192.168.0.0/20",
"destinationAddress": "0.0.0.0/0",
"nexthopId": "nat-bdidwhwfwc6p",
"nexthopType": "nat",
"description": ""
}
返回示例
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content Type: application/json;charset=UTF 8
Server: BWS
{"routeRuleId": "rr-dup3cxpebi5e"}