查询权限组详情

更新时间：2026-11-02

描述

用于查询单个 L3 权限组的详情，返回该权限组的基本信息及其已关联的挂载点列表（attachedMountTargets）。

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

请求结构

                Bash
                
            

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

    {
        "accessGroupName": "test-ag-01",
        "zoneName": "zoneB"
    }
            

请求头域

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

请求参数

参数名称	类型	是否必需	参数位置	描述
action	String	是	Query参数	本接口固定为 DescribeL3AccessGroup
accessGroupName	String	是	RequestBody参数	权限组名称
zoneName	String	是	RequestBody参数	权限组所属的可用区

返回状态码

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

返回头域

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

返回参数

参数名称	类型	描述
requestId	String	唯一请求 ID，每次请求都会返回
accessGroupName	String	权限组名称
description	String	描述，未设置时该字段返回空串
instanceCount	Integer	关联实例数量
mountCount	Integer	关联挂载点数量
createTime	String	创建时间，ISO-8601 UTC 秒精度，如 2026-09-01T03:12:45Z
zoneName	String	逻辑机房（可用区）
attachedMountTargets	Array	已关联的挂载点列表，元素见下表

attachedMountTargets 元素：

字段	类型	说明
`mountTargetId`	String	挂载点 ID
`mountTargetName`	String	挂载点名称
`instanceId`	String	所属实例 ID
`instanceName`	String	所属实例名称

请求示例

                Bash
                
            

                    POST /?action=DescribeL3AccessGroup 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

    {
        "accessGroupName": "test-ag-01",
        "zoneName": "zoneB"
    }
            

响应示例

                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",
        "accessGroupName": "test-ag-01",
        "description": "for benchmark",
        "instanceCount": 1,
        "mountCount": 1,
        "createTime": "2026-09-01T03:12:45Z",
        "zoneName": "cn-gz-a",
        "attachedMountTargets": [
            {
                "mountTargetId": "mt-xxxxxx",
                "mountTargetName": "mt-01",
                "instanceId": "pfs-xxxxxx",
                "instanceName": "my-pfs"
            }
        ]
    }
            

评价此篇文章

有帮助没帮助

查询权限组列表

创建权限组规则

百度智能云

并行文件存储 PFS

并行文件存储 PFS

查询权限组详情