查询权限组列表

更新时间：2026-11-02

描述

用于查询当前账号下的 L3 权限组列表，可用于按可用区过滤、按权限组名模糊搜索，并支持分页与排序。

您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。

请求结构

                Bash
                
            

                    POST /?action=ListL3AccessGroup HTTP/1.1
    Host: pfs.bj.baidubce.com
    content-type: application/json
    version: v2
    Authorization: authorization string

    {
        "zoneName": "zoneB",
        "keyword": "test",
        "keywordType": "name",
        "order": "desc",
        "orderBy": "createTime",
        "pageNo": 1,
        "pageSize": 10
    }
            

请求头域

除公共头域外，需额外携带 version: v2 头域

请求参数

参数名称	类型	是否必需	参数位置	描述
action	String	是	Query参数	本接口固定为 ListL3AccessGroup
keyword	String	否	RequestBody参数	搜索关键字，需与 keywordType 同时传才生效
keywordType	String	否	RequestBody参数	搜索字段，当前仅支持 name（按权限组名模糊匹配）
zoneName	String	否	RequestBody参数	可用区；不传则返回所有可用区
order	String	否	RequestBody参数	排序方向，asc / desc，默认 desc
orderBy	String	否	RequestBody参数	排序字段，默认 createTime
pageNo	Integer	否	RequestBody参数	页码，从 1 开始；传 ≤ 0 会被纠正为 1，默认 1
pageSize	Integer	否	RequestBody参数	每页条数；传 ≤ 0 会被纠正为 10，默认 10

返回状态码

成功返回200，失败返回见错误码

返回头域

除公共头域外，无其他特殊头域

返回参数

参数名称	类型	描述
requestId	String	唯一请求 ID，每次请求都会返回
result	Array	当前页的权限组列表，元素见下表
pageNo	Integer	当前页码
pageSize	Integer	每页条数
totalCount	Integer	过滤后的总条数，用于计算总页数
realTotalCount	Integer	过滤前的全量总条数，用于配额展示
order	String	排序方向
orderBy	String	排序字段

result 数组元素：

字段	类型	说明
`accessGroupName`	String	权限组名称
`description`	String	描述，未设置时该 key 不返回
`ruleCount`	Integer	规则数量
`instanceCount`	Integer	关联实例数量
`mountCount`	Integer	关联挂载点数量
`createTime`	String	创建时间，ISO-8601 UTC 秒精度，如 `2026-09-01T03:12:45Z`
`zoneName`	String	逻辑机房

请求示例

                Bash
                
            

                    POST /?action=ListL3AccessGroup HTTP/1.1
    Host: pfs.bj.baidubce.com
    content-type: application/json
    version: v2
    Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2026-10-22T08:26:52Z/1800/content-type;host;version;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02

    {
        "zoneName": "zoneB",
        "keyword": "test",
        "keywordType": "name",
        "order": "desc",
        "orderBy": "createTime",
        "pageNo": 1,
        "pageSize": 10
    }
            

响应示例

                Bash
                
            

                    HTTP/1.1 200 OK
    x-bce-request-id: 3f9a1c2e-5b7d-4e88-9a10-2c4f6b8d0e11
    Date: Wed, 22 Oct 2026 08:26:52 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS

    {
        "requestId": "3f9a1c2e-5b7d-4e88-9a10-2c4f6b8d0e11",
        "result": [
            {
                "accessGroupName": "test-ag-01",
                "description": "for benchmark",
                "ruleCount": 3,
                "instanceCount": 1,
                "mountCount": 2,
                "createTime": "2026-09-01T03:12:45Z",
                "zoneName": "cn-gz-a"
            }
        ],
        "pageNo": 1,
        "pageSize": 10,
        "totalCount": 1,
        "realTotalCount": 27,
        "order": "desc",
        "orderBy": "createTime"
    }
            

评价此篇文章

有帮助没帮助

删除权限组

查询权限组详情

百度智能云

并行文件存储 PFS

并行文件存储 PFS

查询权限组列表