调用SetDirQuota接口设置文件系统的目录配额。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String SetDirQuota

接口名称。固定取值:SetDirQuota。

FileSystemId String 1ca404****

文件系统ID。

Path String /data/sub1

目录在文件系统中的绝对路径。

QuotaType String Accounting

配额类型。

取值:

  • Accounting:统计型配额,只统计使用量。
  • Enforcement:限制型配额,当使用量超过限制后,会导致创建文件或目录、追加写入等操作失败。
UserType String Uid

用户类型。

取值:

  • Uid:用户ID
  • Gid:用户所属组ID
  • AllUsers:所有用户
UserId String 500

要限制的Uid或Gid。

当UserType=Uid或Gid时必填且有意义。

例如:

  • 要限制Uid=500的用户,则UserType填Uid,UserId填500。
  • 要限制Gid=100的用户组,则UserType填Gid,UserId填100。
SizeLimit Long 1024

限制目录下文件总容量。

单位:GiB

当QuotaType=Enforcement时,SizeLimit和FileCountLimit至少填写其中一项。

FileCountLimit Long 10000

限制目录下文件数目。

包括文件、目录和特殊文件。

当QuotaType=Enforcement时,SizeLimit和FileCountLimit至少填写其中一项。

返回数据

名称 类型 示例值 描述
RequestId String 5BC5CB97-9F28-42FE-84A4-0CD0DF42****

请求ID。

Success Boolean true

请求状态。

包括:

  • true:请求成功
  • false:请求失败

示例

请求示例

http(s)://[Endpoint]/?Action=SetDirQuota
&FileSystemId=1ca404****
&Path=/data/sub1
&QuotaType=Accounting
&UserType=Uid
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>94CA5264-2C30-4D83-865D-B1CF2BE2****</RequestId>
<Success>true</Success>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "94CA5264-2C30-4D83-865D-B1CF2BE2****",
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidParameter.DirPathNotExist The Dir Path does not exist 目录路径不存在

访问错误中心查看更多错误码。