更新Fileset

更新时间：2025-09-22

描述

更新已创建的fileset，支持更新fileset名称、容量限制、文件数限制、iops限制和带宽限制。

请求

请求结构

                Bash
                
            

                POST /?action=UpdateFileset
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-xxxxyyy",
     "filesetName": xxx,
     "blockQuota":     100,
     "filesQuota":     10000,
     "qpsLimit":       10000,
     "bandwidthLimitMb": 10000,
}
            

请求头域

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

请求参数

参数名称	类型	是否必需	参数位置	描述
version	string	是	Request Header	此接口为v2版本，固定为v2
action	string	是	URL Query	本接口中固定为 UpdateFileset
instanceId	string	是	Request Body	fileset所属的pfs实例短id
filesetId	string	是	Request Body	更新fileset的 Id
filesetName	string	否	Request Body	需要更新的fileset名称不传该值表示不修改
blockQuota	int32	否	Request Body	容量限制，单位GB 设置为0时表示不限制不传该值表示不修改如果设置该值，需满足以下条件：小于等于PFS实例容量
filesQuota	int64	否	Request Body	文件数限制设置为0时表示不限制不传该值表示不修改如果设置该值，需满足以下条件（若设置文件数配额不在此范围，请提交工单）：1.大于等于 max{100万，文件数预分配配额}；2.小于等于30亿
qpsLimit	int32	否	Request Body	iops限制 IOPS QoS为Fileset的最大IOPS（不包含DIO）性能，当Fileset的IOPS使用性能达到QoS设置阈值后，会触发流控。
bandwidthLimitMb	int32	否	Request Body	带宽限制，单位MB 吞吐QoS为Fileset的最大吞吐性能（不包含DIO），当Fileset的吞吐使用性能达到QoS设置阈值后，会触发流控。

响应

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

返回头域

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

返回参数

参数名称	类型	是否必需	参数位置	描述
requestId	string	是	response body	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

示例

请求：

                Bash
                
            

                POST /?action=UpdateFileset
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-xxxyyy",
    "filesetName": test,
    "blockQuota": 1024,
    "filesQuota": 1000000,
}
            

响应

                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",
}
            

删除Fileset

获取Fileset列表

百度智能云

并行文件存储 PFS

并行文件存储 PFS

更新Fileset