查询PFS实例挂载客户端列表
更新时间：2026-02-28
描述
查看pfs实例的所有挂载客户端列表
请求
请求结构
Plain Text
1POST /?action=InstanceListClients
2x-bce-date: 2023-06-09T10:08:22Z
3host: pfs.xx.baidubce.com ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
4content-type: application/json
5Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
6version:v2
7{
8 "instanceId": "pfs-xxxyy",
9 "manner": "marker",
10}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| action | string | 是 | URL Query | 本接口固定为 InstanceListClients |
| version | string | 是 | Request Header | API版本号，固定为v2 |
| instanceId | string | 是 | Request Body | PFS实例ID |
| maxKeys | int | 否 | Request Body | 返回客户端挂载列表长度，默认为100个，取值范围为【1, 500】，超过范围的规整为1或500 |
| manner | string | 是 | Request Body | 请求的分段类型，必须指定marker |
| marker | string | 否 | Request Body | 按照internalIp的字典序排列，从marker之后的第一个开始返回（不包括marker） |
响应
返回状态码，成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 参数位置 | 参数类型 | 是否必需 | 备注 |
|---|---|---|---|---|
| requestId | response body | string | 是 | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
| isTruncated | response body | string | 是 | 是否被截断，false表示本轮请求已包含全部数据 |
| marker | response body | string | 否 | 本轮list的marker |
| maxKeys | response body | string | 是 | 本轮返回的node的数量 |
| nextMarker | response body | int | 是 | 下一轮node的marker |
| result | response body | list<NodeInfo> | 否 | 返回的node具体列表 |
示例
请求：
Plain Text
1POST /?action=InstanceListClients
2x-bce-date: 2023-06-09T10:08:22Z
3host: pfs.xx.baidubce.com ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
4content-type: application/json
5Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
6version:v2
7{
8 "instanceId": "pfs-KlwkIR",
9 "manner": "marker",
10}响应：
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: a90a3a0e-2284-403e-a1ba-e49022cb0d62
3Date: Thu, 29 Jan 2026 03:09:00 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6{
7 "isTruncated": false,
8 "marker": "",
9 "maxKeys": 10,
10 "nextMarker": null,
11 "requestId": "a90a3a0e-2284-403e-a1ba-e49022cb0d62",
12 "result": [
13 {
14 "internalIp": "172.16.48.148",
15 "mtId": "mt-Aa1fhQ",
16 "mtName": "test",
17 "mtPath": "",
18 "nodeId": "i-AhMIy21J",
19 "nodeName": "pfs-mt-XYNmpy-000003",
20 "nodeType": "BCC",
21 "vpcId": "vpc-jx648pkxw3tc",
22 "vpcName": "default",
23 "zoneName": "可用区F"
24 },
25 {
26 "internalIp": "172.16.48.147",
27 "mtId": "mt-R4V4Ql",
28 "mtName": "yujiyun_client",
29 "mtPath": "",
30 "nodeId": "i-B8MyZptT",
31 "nodeName": "instance-kd4memw2",
32 "nodeType": "BCC",
33 "vpcId": "vpc-jx648pkxw3tc",
34 "vpcName": "default",
35 "zoneName": "可用区F"
36 },
37 {
38 "internalIp": "172.16.32.200",
39 "mtId": "mt-XYNmpy",
40 "mtName": "yq_51912",
41 "mtPath": "",
42 "nodeId": "i-BO29R1FP",
43 "nodeName": "instance-vzha03ra",
44 "nodeType": "BCC",
45 "vpcId": "vpc-jx648pkxw3tc",
46 "vpcName": "default",
47 "zoneName": "可用区C"
48 },
49 {
50 "internalIp": "172.16.48.146",
51 "mtId": "mt-R4V4Ql",
52 "mtName": "yujiyun_client",
53 "mtPath": "",
54 "nodeId": "i-vVz0mOpj",
55 "nodeName": "instance-yxu4d22w",
56 "nodeType": "BCC",
57 "vpcId": "vpc-jx648pkxw3tc",
58 "vpcName": "default",
59 "zoneName": "可用区F"
60 }
61 ]
62}