创建网关限速规则
更新时间：2024-05-24
描述
创建网关限速规则。
请求结构
POST /v{version}/gateway/limitrule?clientToken={clientToken} HTTP/1.1
Host: bcc.bj.baidubce.com
Content-Type: application/json
Authorization: authorization string
{
"ipVersion":"4",
"name":"create-fromapi-test-pc",
"description":"test-createfrom-api-description",
"serviceType":"peerconn",
"resourceId":"qpif-1p7qybe3hd1i",
"direction":"egress",
"cidr": "192.168.0.7/32",
"bandwidth":1
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| clientToken | String | 否 | Query参数 | 幂等性Token，长度不超过64位 |
| ipVersion | String | 是 | RequestBody参数 | IP协议版本,当前取值4 |
| name | String | 是 | RequestBody参数 | 规则名称,需满足名称规则。支持大小写字母、数字以及-_ /.特殊字符，必须以字母开头，长度1-65 |
| description | String | 否 | RequestBody参数 | 描述信息。长度0-200 |
| serviceType | String | 是 | RequestBody参数 | 服务类型(peerconn,et,csn) peerconn-对等连接 et-专线网关 csn-云智能网 |
| subServiceType | String | 否 | RequestBody参数 | 子服务类型，当serviceType="csn"时,必传。 LOCAL-网络实例带宽类型。 PEER_CLOUD-夸地域带宽云间互通 PEER_EDGE-云边互通 |
| peerRegion | String | 否 | RequestBody参数 | 当subServiceType是PEER_CLOUD或PEER_EDGE时必传。表示对端地域。例如华北-北京传递"bj",华北保定传递"bd" |
| resourceId | String | 是 | RequestBody参数 | 资源ID，对等连接ID或网关ID。当subServiceType="LOCAL"时候，该resourceId="csnId:vpcId"。当subServiceType="PEER_CLOUD"时为csnId |
| direction | String | 是 | RequestBody参数 | 限速方向: egress |
| cidr | String | 是 | RequestBody参数 | 源网段CIDR,当前限流规则对当前设置的CIDR源网段生效。 |
| bandwidth | Integer | 是 | RequestBody参数 | 带宽,Mbps,上限取决于具体网关的最大带宽。 |
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| glrId | String | 网关限速规则ID |
请求示例
POST /v1/gateway/limitrule?clientToken=be31b98a-5e41-4838-9830-9be700de5a20 HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"ipVersion":"4",
"name":"create-fromapi-test-pc",
"description":"test-createfrom-api-description",
"serviceType":"peerconn",
"resourceId":"qpif-1p7qybe3hd1i",
"direction":"egress",
"cidr": "192.168.0.7/32",
"bandwidth":1
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"glrId": "glr-pw7dwtfupegj"
}