并行文件更新FILESET
更新时间 2025-11-13 15:30:14
最近更新时间: 2025-11-13 15:30:14
接口功能介绍
修改FILESET配额限制与描述
接口约束
1.配额可以改大或改小，但是设置的配额容量或文件数必须大于等于已使用容量或文件数
URI
POST /v4/hpfs/update-fileset
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池 ID，例：100054c0416811e9a6690242ac110002 | 81f7728662dd11ec810800155d307d5b | |
| filesetID | 是 | String | FILESET唯一ID | fset-nkh6qmv3iaf | |
| capacityQuota | 否 | Integer | FILESET的容量限制，单位：GiB，起步 10GiB 且最小不低于FILESET已使用容量，步长为1GiB，最大不超过文件系统可用容量 + 此FILESET已分配容量 | 10 | |
| fileCountQuota | 否 | Long | FILESET的文件数限制，单位：个，起步 1 万个且最小不低于FILESET已使用文件数量，步长为1千个，最大不超过文件系统可用文件数量 + 此FILESET已分配文件数量 | 100000 | |
| filesetDescription | 否 | String | FILESET的描述，长度为0~128个字符 | nfs |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为处理中/失败，详见errorCode) | 800 | |
| message | String | 响应描述 | SUCCESS | |
| description | String | 响应描述 | 成功 | |
| returnObj | Object | 返回对象 | returnObj | |
| errorCode | String | 业务细分码，为 product.module.code 三段式码 | sfs.fileset.notExists | |
| error | String | 业务细分码，为product.module.code三段式大驼峰码 | Sfs.Fileset.NotExists |
表 returnObj | 参数 | 参数类型 | 说明 | 示例 | 下级对象 | | --------- | ------- | ------- | ------- | ------- | | regionID | String | 资源所属资源池 ID | 81f7728662dd11ec810800155d307d5b | | | resources | Array of Objects | 资源明细 | | resources |
表 resources | 参数 | 参数类型 | 说明 | 示例 | 下级对象 | | --------- | ------- | ------- | ------- | ------- | | sfsUID | String | 并行文件内部唯一 ID | a2d4b927-9511-5a9b-b1de-cfe55779c1ea | | | filesetID | String | FILESET唯一ID | fset-nkh6qmv3iaf | |
枚举参数
无
请求示例
请求url
https://hpfs-global.ctapi.ctyun.cn/v4/hpfs/update-fileset
请求头header
无
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"filesetID": "fset-nkh6qmv3iaf",
"capacityQuota": 50
}
响应示例
{
"returnObj": {
"regionID": "81f7728662dd11ec810800155d307d5b",
"resources": [
{
"filesetID": "fset-nkh6qmv3iaf",
"sfsUID": "a2d4b927-9511-5a9b-b1de-cfe55779c1ea"
}
]
},
"message": "SUCCSS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码
