查询Fileset详情
更新时间:2025-09-22
描述
查看单个fileset详情,只支持精确查询。
请求
请求结构
Shell
1POST /?action=DescribeFileset
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
请求头域
除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | string | 是 | Request Header | 此接口为v2版本,固定为v2 |
action | string | 是 | URL Query | 本接口固定为DescribeFileset |
instanceId | string | 是 | Request Body | fileset所属PFS实例Id |
filesetId | string | 是 | Request Boby | fileset Id |
响应
返回状态码,成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
requestId | string | 是 | response body | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
filesetName | string | 是 | response body | fileset名称 |
filesetId | string | 是 | response body | fileset id |
filesetPath | string | 是 | response body | fileset path |
status | int | 是 | response body | fileset状态 |
blockQuota | int | 是 | response body | 容量限制(单位GB) |
blockUsage | int | 是 | response body | 容量使用量(单位KB) |
filesQuota | int | 是 | response body | 文件数量限制 |
filesUsage | int | 是 | response body | 文件使用量 |
allocatedInode | int64 | 是 | response body | 文件数预分配配额 |
ctime | string | 是 | response body | 创建时间 |
qpsLimit | int64 | 是 | response body | iops限制 |
bandwidthLimitMb | int64 | 是 | response body | 带宽限制 |
parentPath | bool | 是 | response body | 是否为父fileset |
示例
请求:
Shell
1POST /?action=DescribeFileset
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-Lnf5fM",
9 "filesetId": "fset-xxxxyy",
10}
响应:
Shell
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
6 {
7 "requestId": "946002ee-cb4f-4aad-b686-5be55df27f09",
8 "filesetName": "fset-xxx",
9 "filesetId": "filesetXXX",
10 "filesetPath": "/path",
11 "status": 1,
12 "enableSetQuota": true,
13 "blockQuota": 1024,
14 "blockUsage": 50,
15 "filesQuota": 100000,
16 "filesUsage": 1000,
17 "inodeLimit": 10000000,
18 "allocatedInode": 100000,
19 "ctime": "XXX",
20 "qpsLimit": 10000,
21 "bandwidthLimitMb": 10000,
22 "parentPath": true,
23 }