CreateFileset_文件存储(NAS/CPFS)_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • CPFS 使用说明

    • 仅支持 CPFS 2.2.0 及以上版本创建 Fileset。您可以在控制台文件系统详情页面查看版本信息。
    • 单个 CPFS 文件系统最多支持创建 10 个 Fileset。
    • 父目录必须是已存在的目录。
    • Fileset 路径支持的最大深度为 8 层,根目录/为 0 层。例如,Fileset 路径为/test/aaa/ccc/,则表示路径深度为 3 层。
    • 不支持 Fileset 中嵌套 Fileset。即当父目录已指定为 Fileset,其子目录不支持指定为 Fileset。
    • Fileset 最多支持 100 万个文件,如果文件数量超过此上限,添加新文件会返回no space错误信息。
  • CPFS 智算版使用说明

    • 仅支持 CPFS 智算版 2.7.0 及以上版本创建 Fileset。您可以在控制台文件系统详情页面查看版本信息。
    • 单个 CPFS 文件系统最多支持创建 500 个 Fileset。
    • Fileset 路径必须为新路径,不能为已存在路径,Fileset 路径不支持重命名,不支持路径为软链接。
    • Fileset 路径支持的最大深度为 8 层,根目录/为 0 层。例如,Fileset 路径为/test/aaa/ccc/,则表示路径深度为 3 层。
    • Fileset 路径为多层目录时,父目录必须是已存在的目录。
    • 不支持在 Fileset 中嵌套 Fileset,即当父目录已指定为 Fileset,其子目录不支持指定为 Fileset。一个 Fileset 路径只支持一个配额。
    • Fileset 容量配额,最小起步 10 GiB,扩容单位为 1 GiB。
    • Fileset 最多支持 100 亿个文件或目录,最小起步 10000,扩容单位为 1。
    • 修改目录配额时,设置的配额容量或文件数必须高于已使用容量或文件数。
    • 配额的统计有 15 分钟的延迟,当前的实际使用量 15 分钟之后才会生效。

流控信息

请求速率为120/60(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
nas:CreateFileset
Create
Fileset
acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

请求参数

字段名称字段详情
FileSystemIdstring

文件系统 ID。展开详情

示例值:bmcpfs-290w65p03ok64ya****参考取值来源:
    CreateFileSystem
    DescribeFileSystems
    SetFilesetQuota
FileSystemPathstring

待创建的 Fileset 的绝对路径。展开详情

示例值:/test/参考取值来源:
    DescribeFilesets
DryRunboolean

是否对此次创建请求执行预检。展开详情

示例值:false
DeletionProtectionboolean

实例释放保护属性,指定是否支持通过控制台或 API( DeleteFileset )释放实例。展开详情

示例值:false
Descriptionstring

Fileset 的描述信息。展开详情

示例值:内部事务目录
ClientTokenstring

保证请求幂等性,从您的客户端生成一个参数值,确保不同的请求间该参数值唯一。展开详情

示例值:123e4567-e89b-12d3-a456-42665544****字符长度 <= 64字符长度 >= 1
Quotaobject

配额信息。展开详情

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:98696EF0-1607-4E9D-B01D-F20930B6****
FsetIdstring

Fileset ID。

示例值:fset-1902718ea0ae****

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
IllegalCharacters
The parameter contains illegal characters.诊断
400
MissingFileSystemId
FileSystemId is mandatory for this action.诊断
400
MissingFileSystemPath
FileSystemPath is mandatory for this action.诊断
400
InvalidFilesystemType.NotSupport
This Api does not support this fileSystem type.诊断
400
InvalidFilesystemVersion.NotSupport
This Api does not support this fileSystem version.诊断
400
InvalidRequest
The request is invalid.诊断
400
Quota.Invalid.Limit
Quota limit is invalid.诊断
400
Resource.Exceed.Limit
Resource exceed limit.诊断
400
Resource.Check.Fail
Resource check failed.诊断
400
Fileset.Path.Duplicate
Fileset path is duplicate.诊断
400
Fileset.Path.Nested
Fileset path is nested.诊断
400
Fileset.Path.NotExist
Fileset.Path.Not.Exist.诊断
400
Fileset.Path.Exist
Fileset already exist.诊断
403
OperationDenied.AlreadyExists
The operation is denied due to IdirName already exists in parent path.诊断
403
OperationDenied.TooManyFilesets
The operation is denied due to too many fileset in filesystem.诊断
403
OperationDenied.TooManyDepths
The operation is denied due to Fileset path too deep.诊断
403
OperationDenied.NestedDir
The operation is denied due to nested directory.诊断
403
OperationDenied.DependencyViolation
The operation is denied due to dependancy violation.诊断
403
OperationDenied.FilesetNotSupported
The operation is not supported.诊断
404
InvalidFileSystem.NotFound
The specified file system does not exist.诊断
404
InvalidFileSystemPath.ParentNotFound
The specified parent path does not exist.诊断
404
InvalidFileSystemPath.NotDirectory
The specified idir parent path is not directory.诊断
404
InvalidFileSystemPath.InvalidCharacters
The specified fileset path contains invalid characters.诊断
404
InvalidFilesetPath.InvalidParameter
Fileset path is invalid.诊断

变更历史

变更时间变更内容概要操作
2024-10-24
变更错误码400
变更请求参数FileSystemPath
新增请求参数Quota
2024-05-31
新增请求参数DeletionProtection
删除返回参数
2023-04-24
变更错误码404
2021-10-28
新增OpenAPI,创建文件集

相关示例