修改配额空间

最近更新时间:2025-10-24 15:25:22

我的收藏

功能描述

用于根据配额 ID 修改配额。
说明:
要求权限:admin。有关权限详情请参见 生成访问令牌接口

请求

请求示例

PUT /api/v1/quota/{LibraryId}/{QuotaId}?access_token={AccessToken}&user_id={UserId}

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
QuotaId
配额 ID
String
AccessToken
访问令牌,对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数获取请参见 生成访问令牌
String
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参阅 生成访问令牌接口
String

请求体

application/json,指定配额值
请求体示例:
{
"spaces": [ "space111", "space222" ],
"capacity": "1099511627776",
"removeWhenExceed": true,
"removeAfterDays": 30,
"removeNewest": false
}
请求体字段说明:
响应参数
描述
类型
是否可选
spaces
对于多租户空间媒体库,修改配额所涵盖的租户空间(暂不支持独立的增加或移除),以便同时控制多个租户空间的配额,不支持传空数组,如不指定该字段则不修改配额所涵盖的租户空间;对于单租户空间,不能指定该字段
Array
capacity
可选字段,配额的具体值,单位为字节(Byte),可以指定为数字形式或字符串形式,为了避免大数产生的精度损失,建议该字段指定为字符串形式,如不指定则不修改配额的具体值
String
removeWhenExceed
当指定为 false 时,配额仅用于上传时判断是否有足够空间,对于已经超限的空间不执行任何删除清理操作;
当指定为 true 时,创建配额将检查当前存储量,如果存储量已经超限,那么将在 removeAfterDays 天数到达后开始删除文件已保证存储量在配额之下,默认删除最早的文件,如果 removeNewest 指定为 true 则删除最新的文件,必选参数
Boolean
removeAfterDays
存储量超限后在进行文件删除前等待的天数
Int
removeNewest
是否从最新的文件开始删除,默认为 false,即从最旧的文件开始删除
Boolean

响应码

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

响应体

该请求无响应体。

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。