查询Fileset详情

更新时间：2025-09-22

描述

查看单个fileset详情，只支持精确查询。

请求

请求结构

                Shell
                
            

                POST /?action=DescribeFileset
x-bce-date: 2023-06-09T10:08:22Z
host: pfs.xx.baidubce.com  ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
content-type: application/json
Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
version: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状态 ACTIVE = 0 CREATING = 1 DELETING = 2 UPDATING = 3 DELETED = 4 FAIL = 5
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 1，表示子目录中有fileset 0，表示子目录中没有filset

示例

请求：

                Shell
                
            

                POST /?action=DescribeFileset
x-bce-date: 2023-06-09T10:08:22Z
host: pfs.xx.baidubce.com  ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
content-type: application/json
Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
version:v2
{
    "instanceId": "pfs-Lnf5fM",
    "filesetId": "fset-xxxxyy",
}
            

响应：

                Shell
                
            

                HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
 {
     "requestId": "946002ee-cb4f-4aad-b686-5be55df27f09",
     "filesetName"﻿: "fset-xxx",
     "filesetId": "filesetXXX",
     "filesetPath"﻿: "/path",
     "status"﻿: 1,
     "enableSetQuota": true,
     "blockQuota": 1024,
     "blockUsage": 50,
     "filesQuota": 100000,
     "filesUsage": 1000,
     "inodeLimit": 10000000,
     "allocatedInode": 100000,
     "ctime": "XXX",
     "qpsLimit": 10000,
     "bandwidthLimitMb": 10000,
     "parentPath": true,
 }
            

获取Fileset列表

数据流动（极速型L2）相关接口

百度智能云

并行文件存储 PFS

并行文件存储 PFS

查询Fileset详情