查询挂载客户端列表
更新时间：2026-11-02
描述
用于查询指定 PFS L3 实例下所有已挂载的客户端信息，可用于排查哪些客户端正在挂载该文件系统、分别挂在哪个挂载点和可用区。结果按 clientIp 升序排列，支持 marker 分页。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Bash
1 POST /?action=ListL3Clients HTTP/1.1
2 Host: pfs.bj.baidubce.com
3 content-type: application/json
4 version: v2
5 Authorization: authorization string
6
7 {
8 "instanceId": "pfs-TVOxwG7Ymz",
9 "marker": "",
10 "maxKeys": 1000
11 }请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| action | String | 是 | URL Query | 本接口固定为 ListL3Clients |
| instanceId | String | 是 | Request Body | PFS 实例 ID |
| marker | String | 否 | Request Body | 按 clientIp 的字典序排列，从 marker 之后开始返回（不含 marker），默认空串 |
| maxKeys | Integer | 否 | Request Body | 本次最多返回的客户端数量，默认 1000；传 ≤ 0 会被纠正为 1，传 > 1000 会被纠正为 1000 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| requestId | String | 是 | Response Body | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
| result | list<L3ClientModel> | 否 | Response Body | 返回的客户端列表，元素见下表 |
| marker | String | 否 | Response Body | 本轮请求使用的 marker |
| maxKeys | Integer | 是 | Response Body | 本轮请求生效的分页大小上限 |
| isTruncated | Boolean | 是 | Response Body | 是否被截断，false 表示本轮已返回全部数据 |
| nextMarker | String | 是 | Response Body | 下一轮请求应传入的 marker，未截断时为 null |
请求示例
Bash
1 POST /?action=ListL3Clients HTTP/1.1
2 Host: pfs.su.baidubce.com
3 content-type: application/json
4 version: v2
5 Authorization: bce-auth-v1/ALTAKmfQK4ax0kCdJBWiEaHjEF/2026-07-14T15:09:36Z/1800/content-type;host;version;x-bce-date/4d3930ebc78fe1fb958329ee8ad5816b49fbba2286fa6d0caa015d82339e46f2
6
7 {
8 "instanceId": "pfs-TVOxwG7Ymz",
9 "marker": "",
10 "maxKeys": 2
11 }响应示例
Bash
1 HTTP/1.1 200 OK
2 x-bce-request-id: 239d8ab5-ce0d-4733-bbf0-58ad602d471f
3 Date: Tue, 14 Jul 2026 15:09:36 GMT
4 Transfer-Encoding: chunked
5 Content-Type: application/json;charset=UTF-8
6 Server: BWS
7
8 {
9 "requestId": "239d8ab5-ce0d-4733-bbf0-58ad602d471f",
10 "result": [
11 {
12 "clientIp": "192.168.0.11",
13 "clientId": 100231,
14 "mountId": "436c4358706b502f70787967434132766871756459673d3d",
15 "mountTargetName": "mt-test1",
16 "vpcId": "vpc-2xnrfqm3jhpp",
17 "zoneName": "zoneA",
18 "serverIp": "10.64.32.15",
19 "protocol": "nfs"
20 },
21 {
22 "clientIp": "192.168.0.12",
23 "clientId": 100232,
24 "mountId": "436c4358706b502f70787967434132766871756459673d3d",
25 "mountTargetName": "mt-test1",
26 "vpcId": "vpc-2xnrfqm3jhpp",
27 "zoneName": "zoneA",
28 "serverIp": "10.64.32.16",
29 "protocol": "nfs"
30 }
31 ],
32 "marker": "",
33 "nextMarker": "192.168.0.12",
34 "isTruncated": true,
35 "maxKeys": 2
36 }评价此篇文章