更新时间:2024-11-28 GMT+08:00
分享

创建目标文件夹quota

功能介绍

创建目标文件夹quota。

接口约束

只支持对空目录设置目录quota。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir-quota

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id

share_id

String

文件系统id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

账号的token

Content-Type

String

MIME类型

表3 请求Body参数

参数

是否必选

参数类型

描述

path

String

合法的已存在的目录的全路径

capacity

Integer

目录的容量大小,单位:MB; 不填写则默认为0;设置为0会导致数据无法写入目录; capacity和quota至少二选一

inode

Integer

目录的inode数量限制; 不填写则默认为0;设置为0会导致数据无法写入目录; capacity和quota至少二选一

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

path

String

合法的已存在的目录的全路径

capacity

Integer

目录的容量大小,单位:MB

inode

Integer

目录的inode数量限制

used_capacity

Integer

目录已使用的容量大小,单位:MB。仅SFSTurbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB返回该字段

used_inode

Integer

目录的已使用的inode数量。仅SFSTurbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB返回该字段

状态码: 400

表5 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码: 409

表6 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码: 500

表7 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

创建目标文件夹配额,目录的全路径是“/data/test”,目录的容量大小是1024MB,目录的inode数量限制是100000。

{
  "path" : "/data/test",
  "capacity" : 1024,
  "inode" : 100000
}

响应示例

状态码: 200

创建配额成功

{
  "path" : "/data/test",
  "capacity" : 1024,
  "inode" : 100000
}

状态码: 400

错误响应

{
  "errCode" : "SFS.TURBO.0102",
  "errMsg" : "Path is not directory"
}

状态码: 409

错误响应

{
  "errCode" : "SFS.TURBO.0112",
  "errMsg" : "quota alreay exist"
}

状态码: 500

错误响应

{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}

状态码

状态码

描述

200

创建配额成功

400

错误响应

409

错误响应

500

错误响应

错误码

请参见错误码

相关文档