更新权限组规则
更新时间：2026-11-02
描述
用于更新指定可用区下某个权限组内的一条访问规则。accessGroupName、accessRuleId、zoneName 为定位键；ip、mask、writeAccess、userAccess、priority 为可选的部分更新字段，只对传入的非空字段做覆盖。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Bash
1 POST /?action=UpdateL3AccessRule 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 "accessRuleId": 3,
11 "priority": 99
12 }请求头域
除公共头域外，需额外携带 version: v2 头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| action | String | 是 | Query参数 | 本接口固定为 UpdateL3AccessRule |
| accessGroupName | String | 是 | RequestBody参数 | 权限组名称（定位键） |
| zoneName | String | 是 | RequestBody参数 | 可用区名称（定位键） |
| accessRuleId | Integer | 是 | RequestBody参数 | 要修改的访问规则 ID（定位键） |
| ip | String | 否 | RequestBody参数 | IP 地址，例如 192.168.1.0 |
| mask | Integer | 否 | RequestBody参数 | 子网掩码长度，例如 24 |
| writeAccess | String | 否 | RequestBody参数 | 读写权限，read_only（只读）/ read_write（读写） |
| userAccess | String | 否 | RequestBody参数 | 用户权限，no_squash / root_squash / all_squash |
| priority | Integer | 否 | RequestBody参数 | 规则优先级 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 唯一请求 ID，每次请求都会返回 |
请求示例
Bash
1 ## 只改优先级：
2 POST /?action=UpdateL3AccessRule HTTP/1.1
3 Host: pfs.bj.baidubce.com
4 content-type: application/json
5 version: v2
6 Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2026-10-22T08:26:52Z/1800/content-type;host;version;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
7
8 {
9 "accessGroupName": "test1",
10 "zoneName": "zoneB",
11 "accessRuleId": 3,
12 "priority": 99
13 }
14
15 ## 改 IP 和掩码：
16 POST /?action=UpdateL3AccessRule HTTP/1.1
17 Host: pfs.bj.baidubce.com
18 content-type: application/json
19 version: v2
20 Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2026-10-22T08:26:52Z/1800/content-type;host;version;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
21
22 {
23 "accessGroupName": "test1",
24 "zoneName": "zoneB",
25 "accessRuleId": 3,
26 "ip": "10.10.1.199",
27 "mask": 24
28 }响应示例
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 }评价此篇文章