并行文件创建FILESET
更新时间 2025-11-13 15:29:58
最近更新时间: 2025-11-13 15:29:58
接口功能介绍
并行文件创建FILESET
接口约束
- 单个HPFS文件系统最多支持创建 10个FILESET
- FILESET的路径限制如下：
- 不支持根目录/创建FILESET
- FILESET的路径以正斜线（/）开头和结尾
- 必须为新路径，不能为已存在的路径
- 不支持在 FILESET中嵌套 FILESET，即当父目录已指定为 FILESET，其子目录不支持指定为 FILESET
- 不支持路径为软链接 + FILESET路径支持的最大深度为3层，根目录/为 0 层。例如，FILESET路径最深为/test/aaa/ccc/
- 目录名仅允许数字、字母、下划线、连接符、中文组成，每级目录最大长度为255字节
- 创建FILESET相当于在HPFS的文件系统中，划分出独立的存储空间和文件个数，会使此文件系统中非FILESET的目录的可使用容量和文件数量减少。
URI
POST /v4/hpfs/new-fileset
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池 ID，例：100054c0416811e9a6690242ac110002 | 81f7728662dd11ec810800155d307d5b | |
| sfsUID | 是 | String | 并行文件唯一ID | a2d4b927-9511-5a9b-b1de-cfe55779c1ea | |
| filesetPath | 是 | String | 指定FILESET在文件系统中的绝对路径，路径限制见接口约束 | /test/aaa/ | |
| capacityQuota | 是 | Integer | FILESET的容量限制，单位：GiB，起步 10 GiB，步长为 1 GiB，最大不超过文件系统可用容量（文件系统可用容量 = 文件系统总容量 - 非FILESET已用容量 - FILESET分配出去的容量） | 10 | |
| fileCountQuota | 是 | Long | FILESET的文件数限制，单位：个，起步 1 万个，步长为 1千个，最大不超过文件系统可用文件数量 （文件系统可用文件数量 = 文件系统总文件数量 - 非FILESET已用文件数量 - FILESET分配出去的文件数量） | 100000 | |
| filesetDescription | 否 | String | FILESET的描述，长度为0~128个字符 | this is a fileset |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为处理中/失败，详见errorCode) | 800 | |
| message | String | 响应描述 | SUCCESS | |
| description | String | 响应描述 | 成功 | |
| returnObj | Object | 返回对象 | returnObj | |
| errorCode | String | 业务细分码，为 product.module.code 三段式码 | sfs.fileset.countQuotaLimited | |
| error | String | 业务细分码，为product.module.code三段式大驼峰码 | Sfs.Fileset.CountQuotaLimited |
表 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/new-fileset
请求头header
无
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"sfsUID": "a2d4b927-9511-5a9b-b1de-cfe55779c1ea",
"filesetPath": "/dir1/",
"filesetDescription": "",
"capacityQuota": 50,
"fileCountQuota": 100000
}
响应示例
{
"returnObj": {
"regionID": "81f7728662dd11ec810800155d307d5b",
"resources": [
{
"filesetID": "fset-nkh6qmv3iaf",
"sfsUID": "a2d4b927-9511-5a9b-b1de-cfe55779c1ea"
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码
