创建权限组规则
更新时间：2026-11-02
描述
用于为指定可用区下的某个权限组批量创建访问规则，可用于一次性下发多条 IP 读写/用户权限规则。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Bash
1 POST /?action=CreateL3AccessRule HTTP/1.1
2 Host: pfs.bj.baidubce.com
3 content-type: application/json
4 version: v2
5 Authorization: authorization string
6
7 {
8 "accessGroupName": "test1",
9 "zoneName": "zoneB",
10 "accessRules": [
11 {
12 "ip": "10.10.1.200",
13 "mask": 32,
14 "writeAccess": "read_write",
15 "userAccess": "all_squash",
16 "priority": 100
17 }
18 ]
19 }请求头域
除公共头域外，需额外携带 version: v2 头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| action | String | 是 | Query参数 | 本接口固定为 CreateL3AccessRule |
| accessGroupName | String | 是 | RequestBody参数 | 权限组名称 |
| zoneName | String | 是 | RequestBody参数 | 可用区名称 |
| accessRules | List<Object> | 是 | RequestBody参数 | 规则列表，不能为空数组 |
| accessRules[].ip | String | 是 | RequestBody参数 | 客户端 IP |
| accessRules[].mask | Integer | 否 | RequestBody参数 | 掩码位数，不传时 IPv4 默认 32、IPv6 默认 128 |
| accessRules[].writeAccess | String | 是 | RequestBody参数 | 读写权限，read_only（只读）/ read_write（读写） |
| accessRules[].userAccess | String | 是 | RequestBody参数 | 用户权限，no_squash（不限制 root）/ root_squash（限制 root）/ all_squash（限制所有用户） |
| accessRules[].priority | Integer | 是 | RequestBody参数 | 优先级 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 唯一请求 ID，每次请求都会返回 |
| accessRuleId | Integer | 单条创建成功时返回的规则 ID，批量创建时不返回 |
| responses | List<Object> | 批量创建时的逐条结果，元素见下表；单条创建时不返回 |
responses 数组元素：
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 该条是否创建成功 |
| accessRuleId | Integer | 成功时返回的规则 ID |
| errorMsg | String | 失败原因，成功时不返回 |
| ip | String | 该条规则对应的客户端 IP |
| mask | Integer | 该条规则对应的掩码位数 |
请求示例
Bash
1 POST /?action=CreateL3AccessRule HTTP/1.1
2 Host: pfs.bj.baidubce.com
3 content-type: application/json
4 version: v2
5 Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2026-10-22T08:26:52Z/1800/content-type;host;version;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
6
7 {
8 "accessGroupName": "test1",
9 "zoneName": "zoneB",
10 "accessRules": [
11 {
12 "ip": "10.10.1.200",
13 "mask": 32,
14 "writeAccess": "read_write",
15 "userAccess": "all_squash",
16 "priority": 100
17 },
18 {
19 "ip": "10.0.0.0",
20 "mask": 32,
21 "writeAccess": "read_only",
22 "userAccess": "all_squash",
23 "priority": 20
24 }
25 ]
26 }响应示例
Bash
1 HTTP/1.1 200 OK
2 x-bce-request-id: 3f2a1b8c-5e41-4838-9830-9be700de5a20
3 Date: Wed, 22 Oct 2026 08:26:52 GMT
4 Transfer-Encoding: chunked
5 Content-Type: application/json;charset=UTF-8
6 Server: BWS
7
8 {
9 "requestId": "3f2a1b8c-5e41-4838-9830-9be700de5a20",
10 "responses": [
11 {
12 "success": true,
13 "accessRuleId": 1001,
14 "ip": "10.10.1.200",
15 "mask": 32
16 },
17 {
18 "success": false,
19 "errorMsg": "access rule already exists",
20 "ip": "10.0.0.0",
21 "mask": 32
22 }
23 ]
24 }评价此篇文章