设置租户空间限速

最近更新时间:2025-09-24 15:20:11

我的收藏

功能描述

用于设置租户空间限速。
说明:
需要 admin、space_admin 权限,有关权限详情请参见 生成访问令牌接口
设置限速之后,将会对该空间后续所有的下载请求设置单链接限速。
如果下载请求自身也设置了单链接限速,则最终的限速为两者的最小值。
正常的预览行为不限速,但使用预览接口获取不可预览的文件类型的下载链接时,将会进行限速。

请求

请求示例

POST /api/v1/space/`{LibraryId}`/`{SpaceId}`/traffic-limit?access_token=`{AccessToken}`

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,获取请参见 创建租户空间
String
必须指定该参数且不支持单租户模式
AccessToken
访问令牌,获取请参见 生成访问令牌
String

请求体

application/json
{
"downloadTrafficLimit": 1000000
}
请求参数
描述
类型
是否必选
downloadTrafficLimit
空间下载限速,范围 100KB/s - 100MB/s ,单位Byte,当输入-1时表示取消限速
Int

响应

响应码

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

响应体

空,无响应体。

错误码

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