Query mount targets
Updated at：2025-11-11
Description
- Fetch all MountTarget details for the specified file system.
- The response result is the intersection of multiple query conditions.
- Results support marker-based pagination, with a default page size of 1000, which can be specified via the maxKeys parameter.
Request
Request structure
Plain Text
1GET /v{version}/cfs/{fId}?&mountId={mountId}&marker={marker}&maxKeys={maxKeys} HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: authorization stringRequest headers: No special headers beyond common headers
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number, current value is 1. |
| fsId | String | Yes | URL parameter | ID of FileSystem to be queried |
| mountId | String | No | Query | ID of MountTarget to be queried |
| marker | String | No | Query | The starting position of the batch list query is a system-generated string |
| maxKeys | int | No | Query | Maximum number of items per page is 1,000, with a default value of 1000. |
Response
Response status code: Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](CFS/API Reference/Error code.md#CFS error code)
Response headers: No special headers beyond common headers
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| mountTargetList | List<[MountTargetModel](CFS/API Reference/Data type.md#MountTargetModel)> | List containing query results |
| marker | String | Marker indicating the starting position of the query. If the result list is empty, this field does not exist. |
| isTruncated | boolean | true indicates there is more data later, false indicates it is the last page |
| nextMarker | String | The marker value needed to fetch the next page. This field is absent when isTruncated is false. |
| maxKeys | int | Maximum number of items included per page |
Example
Request:
Plain Text
1GET /v1/cfs/cfs-jVDkWrBBoj?maxKeys=100 HTTP/1.1
2Host: cfs.bj.baidubce.com
3Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02Response:
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "mountTargetList": [
10 {
11 "accessGroupName"; "DEFAULT_ACCESS_GROUP_NAME",
12 "domain": "cfs-nD0DXHw25b.lb-24cbde9e.cfs.gz.baidubce.com",
13 "mountId"; "362f315475536d46314c626e5a46724b7a7553432f413d3d",
14 "ovip": "172.16.0.53",
15 "subnetId": "sbn-d9uhhv2heg14"
16 "vpcId": "vpc-jx648pkxw3tc"
17 },
18 {
19 "accessGroupName"; "DEFAULT_ACCESS_GROUP_NAME",
20 "domain": "cfs-jVDkWrBBoj-kweicskdgsev.bce.qa.sandbox.baidu.com",
21 "mountId"; "36684e635250353569345454684e76364c36457057513d3d",
22 "ovip": "128.1.0.1",
23 "subnetId": "sbn-d9uhhv2heg14"
24 "vpcId": "vpc-jx648pkxw3tc"
25 }
26 ],
27 "marker": "kweicskdgsev",
28 "nextMarker": "kweicskdgsev",
29 "isTruncated": false,
30 "maxKeys": 2
31}