有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

功能描述

用于修改配额。

接口说明

要求权限:
非 acl 鉴权:admin
说明
非 acl 鉴权是指当前用户对所有文件的操作权限,详情可参考 生成访问令牌接口
acl 鉴权是通过共享授权接口给指定用户,以文件夹为单位授予的权限,详情可参考 角色授权模块

请求

请求示例

PUT /api/v1/quota/{LibraryId}/{SpaceId}?access_token={AccessToken}&user_id={UserId}
请求参数:
LibraryId:媒体库 ID,必选参数。
SpaceId:空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(-);如果媒体库为多租户模式,则必须指定该参数。
AccessToken:访问令牌,必选参数。
UserId:用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参阅 生成访问令牌接口,可选参数。

请求体

application/json,指定配额值。
请求体示例:
{
"capacity": "1099511627776",
"removeWhenExceed": true,
"removeAfterDays": 30,
"removeNewest": false
}
请求体字段说明:
capacity:配额的具体值,单位为字节(Byte),可以指定为数字形式或字符串形式,为了避免大数产生的精度损失,建议该字段指定为字符串形式。
removeWhenExceed:当指定为 false 时,配额仅用于上传时判断是否有足够空间,对于已经超限的空间不执行任何删除清理操作;当指定为 true 时,修改配额将检查当前存储量,如果存储量已经超限,那么将在 removeAfterDays 天数到达后开始删除文件已保证存储量在配额之下,默认删除最早的文件,如果 removeNewest 指定为 true 则删除最新的文件。
removeAfterDays:存储量超限后在进行文件删除前等待的天数。
removeNewest:是否从最新的文件开始删除,默认为 false,即从最旧的文件开始删除。

响应

响应码

修改成功,返回 HTTP 204 No Content。

响应体

该响应无响应体。