查询挂载点列表

更新时间：2026-08-14

描述

查询指定PFSL3实例下的所有MountTarget信息。
结果支持marker分页，分页大小默认为1000，可通过maxKeys参数指定。

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

请求结构

                Bash
                
            

                POST /?action=ListL3MountTarget
x-bce-date: 2026-07-14T15:08:22Z
host: pfs.xx.baidubce.com  ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
content-type: application/json
Authorization: authorization string
version:v2
{
  "instanceId": "pfs-TVOxwG7Ymz"
}
            

请求头域

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

请求参数

参数名称	类型	是否必需	参数位置	描述
action	string	是	Query参数	本接口中固定为 ListL3MountTarget
version	string	是	request header	API版本号，固定为v2
instanceId	string	是	RequestBody参数	PFS实例ID
maxKeys	int	否	RequestBody参数	返回挂载点列表长度，最大为1000，默认为1000个（超过1000或者小于等于0的都规整为1000）
marker	string	否	RequestBody参数	按照mountTargetId的字典序排列，从marker开始返回（包括marker）

响应

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

返回头域

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

返回参数

参数名称	类型	描述
requestId	string	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
isTruncated	string	是否被截断，false表示本轮请求已包含全部数据
marker	string	本轮list的marker
maxKeys	string	本轮返回的挂载点的数量
nextMarker	string	下一轮挂载点的marker
result	list<MountTargetInfo>	返回的挂载点具体列表

请求示例

                Bash
                
            

                POST /?action=ListL3MountTarget
x-bce-date: 2026-07-14T15:09:36Z
host: pfs.su.baidubce.com
content-type: application/json
Authorization: bce-auth-v1/ALTAKmfQK4ax0kCdJBWiEaHjEF/2026-07-14T15:09:36Z/1800/content-type;host;version;x-bce-date/4d3930ebc78fe1fb958329ee8ad5816b49fbba2286fa6d0caa015d82339e46f2
version:v2
{
  "instanceId": "pfs-TVOxwG7Ymz"
}
            

返回示例

                Bash
                
            

                HTTP/1.1 200 OK
x-bce-request-id: 5fbf3f35-ee1f-4123-a28c-d6075368fb56
Date: 14 Jul 2026 15:09:36 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
{
    "isTruncated": false, 
    "marker": "", 
    "maxKeys": 2, 
    "nextMarker": null, 
    "requestId": "5fbf3f35-ee1f-4123-a28c-d6075368fb56", 
    "result": [
        {
            "domain": "pfs-TVOxwG7Ymz.lb-45anz3dz.pfs.su.baidubce.com", 
            "mountTargetId": "4b33767a336b55676a59694666493967796932722b513d3d", 
            "ovip": "10.0.0.5", 
            "subnetId": "sbn-v9rh607ykn7z", 
            "vpcId": "vpc-zv9vg6xfs0ed"
        }, 
        {
            "domain": "pfs-TVOxwG7Ymz.lb-3lsjhsvn.pfs.su.baidubce.com", 
            "mountTargetId": "66476a34666d423463486b46433836476243353937513d3d", 
            "ovip": "172.16.0.34", 
            "subnetId": "sbn-d9uhhv2hcg14", 
            "vpcId": "vpc-jx648pkxw3tc"
        }
    ]
}
            

评价此篇文章

有帮助没帮助

删除挂载点

查询挂载点详情

百度智能云

并行文件存储 PFS

并行文件存储 PFS

查询挂载点列表