设置文件集配额。
接口说明
- 仅 CPFS 智算版 2.7.0 及以上版本支持为文件集设置配额。
- Fileset 容量配额,最小起步 10 GiB,扩容单位为 1 GiB,上限为 1,000 TiB,容量配额不能超过文件系统的总容量。
- Fileset 最多支持 100 亿个文件或目录,最小起步 10000,扩容单位为 1。
- 修改目录配额时,设置的配额容量或文件数必须高于已使用容量或文件数。
- 配额的统计有 5 分钟的延迟,当前的实际使用量 5 分钟之后才会生效。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
FileSystemId | string | 是 | CPFS 智算版文件系统 ID。必须以 | bmcpfs-290w65p03ok64ya**** |
FsetId | string | 是 | Fileset ID。 | fset-1902718ea0ae**** |
DryRun | boolean | 否 | 是否对此次删除请求执行预检。 预检操作会帮助您检查参数有效性、依赖条件等,并不会实际删除实例,也不会产生费用。 取值:
| false |
ClientToken | string | 否 | 保证请求幂等性,从您的客户端生成一个参数值,确保不同请求间该参数值唯一。 ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多信息,请参见如何保证幂等性。 说明
若用户未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。
| 123e4567-e89b-12d3-a456-42665544**** |
FileCountLimit | long | 否 | Quota 文件数量限制。取值范围:
| 10000 |
SizeLimit | long | 否 | Quota 总容量限制。单位:Byte。 取值范围:
| 10737418240 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IllegalCharacters | The parameter contains illegal characters. | 参数非法。 |
400 | MissingFileSystemId | FileSystemId is mandatory for this action. | 未指定FileSystemId参数。 |
400 | MissingFsetId | FsetId is mandatory for this action. | 未指定Fileset ID参数。 |
400 | Quota.Invalid.Limit | Quota limit is invalid. | 无效的配额。 |
400 | Quota.Exceed.Limit | Quota exceed limit. | 配额低于Fileset限制。 |
400 | InvalidFilesetId.NotFound | Invalid FilesetId. | Fileset不存在。 |
403 | OperationDenied.DependencyViolation | The operation is denied due to dependancy violation. | 进行该操作的条件不满足。 |
403 | OperationDenied.FilesetNotSupported | The operation is not supported. | 该文件系统不支持Fileset。 |
404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定的文件系统不存在。 |
404 | InvalidFsetId.NotFound | The specified Fileset ID does not exist. | 指定的Fileset不存在。 |
429 | Throttling.Api | Request was denied due to api flow control. | 请求被限流。 |
访问错误中心查看更多错误码。