查询挂载服务挂载客户端列表
更新时间:2026-02-28
描述
查看挂载服务下的所有挂载客户端列表
请求
请求结构
Plain Text
1POST /?action=MountTargetListClients
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 "mountTargetId": "mt-xxxyy",
9 "manner": "marker",
10}
请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| action | string | 是 | URL Query | 本接口固定为 MountTargetListClients |
| version | string | 是 | Request Header | API版本号,固定为v2 |
| mountTargetId | string | 是 | Request Body | 挂载服务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=MountTargetListClients
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 "mountTargetId": "mt-R4V4Ql",
9 "manner": "marker",
10}
响应:
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 3df4e889-bc29-4581-ad5b-70b84b929dbd
3Date: Thu, 29 Jan 2026 03:09:09 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": "3df4e889-bc29-4581-ad5b-70b84b929dbd",
12 "result": [
13 {
14 "instanceIdList": [
15 "pfs-KlwkIR"
16 ],
17 "internalIp": "172.16.48.147",
18 "mountStatus": "Mounted",
19 "nodeId": "i-B8MyZptT",
20 "nodeName": "instance-kd4memw2",
21 "nodeStatus": "Running",
22 "nodeType": "BCC",
23 "passwd": null,
24 "vpcId": "vpc-jx648pkxw3tc",
25 "vpcName": "default",
26 "zoneName": "可用区F"
27 },
28 {
29 "instanceIdList": [
30 "pfs-KlwkIR"
31 ],
32 "internalIp": "172.16.48.146",
33 "mountStatus": "Mounted",
34 "nodeId": "i-vVz0mOpj",
35 "nodeName": "instance-yxu4d22w",
36 "nodeStatus": "Running",
37 "nodeType": "BCC",
38 "passwd": null,
39 "vpcId": "vpc-jx648pkxw3tc",
40 "vpcName": "default",
41 "zoneName": "可用区F"
42 }
43 ]
44}
