查询权限组规则列表
更新时间：2026-11-02
描述
用于查询指定可用区下某个权限组的规则列表，支持按 IP 类型过滤、分页与排序。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Bash
1 POST /?action=ListL3AccessRule 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": "DEFAULT_ACCESS_GROUP_NAME",
9 "zoneName": "zoneB",
10 "pageNo": 1,
11 "pageSize": 10,
12 "orderBy": "priority",
13 "order": "desc",
14 "ipFilter": ""
15 }请求头域
除公共头域外，需额外携带 version: v2 头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| action | String | 是 | Query参数 | 本接口固定为 ListL3AccessRule |
| accessGroupName | String | 是 | RequestBody参数 | 权限组名称 |
| zoneName | String | 是 | RequestBody参数 | 可用区名称 |
| pageNo | Integer | 否 | RequestBody参数 | 页码，默认 1 |
| pageSize | Integer | 否 | RequestBody参数 | 每页条数，默认 10 |
| orderBy | String | 否 | RequestBody参数 | 排序字段，默认 priority |
| order | String | 否 | RequestBody参数 | 排序方向，asc / desc，默认 asc |
| ipFilter | String | 否 | RequestBody参数 | 按 IP 过滤，ipv4 / ipv6，为空时展示所有，默认空字符串 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 唯一请求 ID，每次请求都会返回 |
| result | Array | 规则列表，元素见下表 |
| totalCount | Integer | 总条数 |
| pageNo | Integer | 当前页码 |
| pageSize | Integer | 每页条数 |
result 数组元素：
| 字段 | 类型 | 说明 |
|---|---|---|
| accessRuleId | Integer | 规则 ID |
| ip | String | 客户端 IP |
| mask | Integer | 掩码位数 |
| priority | Integer | 优先级 |
| writeAccess | String | 读写权限 |
| userAccess | String | 用户权限 |
请求示例
Bash
1 POST /?action=ListL3AccessRule 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": "DEFAULT_ACCESS_GROUP_NAME",
9 "zoneName": "zoneB",
10 "pageNo": 1,
11 "pageSize": 10,
12 "orderBy": "priority",
13 "order": "desc",
14 "ipFilter": ""
15 }响应示例
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 "result": [
11 {
12 "accessRuleId": 1001,
13 "ip": "192.168.1.0",
14 "mask": 24,
15 "priority": 100,
16 "writeAccess": "read_write",
17 "userAccess": "no_squash"
18 }
19 ],
20 "totalCount": 1,
21 "pageNo": 1,
22 "pageSize": 10
23 }评价此篇文章