设置回收站生命周期

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

我的收藏

功能描述

用于设置回收站生命周期。
说明:
要求权限:admin、space_admin。有关权限详情请参见 生成访问令牌接口
回收站生命周期是指文件被放入回收站后的保留时间。一旦超过这个时间,回收站中的文件将被自动删除,此后将无法恢复。
未对租户空间设置回收站生命周期时,系统将采用该租户空间所属的媒体库的回收站保留天数作为默认值。
对租户空间设置回收站生命周期时,规则如下:
如果新设定的保留天数比原保留天数长,回收站中已有文件的保留天数将更新为新设定的值。
如果新设定的保留天数比原保留天数短,则回收站中已有的文件仍将沿用旧的保留天数,只有之后删除的文件会使用新的保留天数。

请求

请求示例

POST /api/v1/recycled/`{LibraryId}`/`{SpaceId}`?lifecycle&access_token=`{AccessToken}`

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
AccessToken
访问令牌,对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数获取请参见 生成访问令牌
String

请求体

application/json
请求体示例:
{
"retentionDays":10
}
参数
描述
类型
是否必选
retentionDays
回收站保留天数,要求 0 < retentionDays <= 10000
Number

响应

响应码

修改成功,返回 HTTP 204 No Content

响应体

该响应无响应体。

错误码

可能存在的错误码 SetRecycleLifecycleFrequencyLimit 403设置太频繁,10分钟内只能设置1次,常见的错误信息请参见 错误码 文档。