获取Fileset列表

更新时间：2025-09-22

描述

查看pfs实例的所有fileset详情，支持根据filesetId、filesetName进行模糊查询。

请求

请求结构

                Bash
                
            

                POST /?action=ListFileset
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	本接口中固定为 ListFileset
instanceId	string	是	Request Body	fileset所属PFS实例的短id
filesetId	string	否	Request Body	基于filesetId进行过滤
filesetName	string	否	Request Body	基于filesetName进行过滤
manner	string	是	Request Body	只支持page
order	string	否	Request Body	排序，desc倒序，asc正序
orderBy	string	否	Request Body	orderBy，默认createTime
pageNo	int	否	Request Body	默认1
pageSize	int	否	Request Body	默认10

响应

返回状态码，成功返回200，失败返回见错误码

返回头域

除公共头域外，无其他特殊头域

返回参数

参数名称	类型	是否必需	参数位置	描述
requestId	string	是	response body	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
result	List<FilesetModel>	是	response body	fileset列表
pageNo	int32	是	response body	页数
pageSize	int32	是	response body	页大小
totalCount	int32	是	response body	返回fileset list的总数量
maxFilesetNum	int32	是	response body	该用户可创建的fileset最大数量
maxFilesQuota	int64	是	response body	该用户可设置的fileset最大文件数配额
minFilesQuota	int64	是	response body	该用户可设置的fileset最小文件数配额

示例

请求：

                Bash
                
            

                POST /?action=ListFileset
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
{
    "manner": "page",
    "instanceId": "pfs-Lnf5fM", 
}
            

响应

                Bash
                
            

                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",
     "pageNo": 1,
     "pageSize": 10,
     "totalCount": 3,
     "maxFilesetNum": 100,
     "maxFilesQuota": 2000000000,
     "minFilesQuota": 1000000,
     "result": [
         {
             "filesetName": "fset-xxx",
             "filesetId": "filesetXXX",
             "filesetPath": "/path",
             "status": 1,
             "blockQuota": 1024,
             "blockUsage": 50,
             "filesQuota": 100000,
             "filesUsage": 1000,
             "allocatedInode": 100000,
             "ctime": "XXX",
             "qpsLimit": 10000,
             "bandwidthLimitMb": 10000,
             "parentPath": true,
         },
         {
             "filesetName"﻿: "fset-xxx",
             "filesetId": "filesetXXX",
             "filesetPath"﻿: "/path/subdir1",
             "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

查询Fileset详情

百度智能云

并行文件存储 PFS

并行文件存储 PFS

获取Fileset列表