tencent cloud

智能媒资托管

文档智能媒资托管业务级 API 文档回收站操作接口设置回收站生命周期

设置回收站生命周期

Download
聚焦模式
字号
最后更新时间： 2026-01-07 14:27:58

功能描述

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

请求

请求示例

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

请求参数

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

请求体

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

响应

响应码

修改成功，返回 HTTP 204 No Content

响应体

该响应无响应体。

错误码

可能存在的错误码 SetRecycleLifecycleFrequencyLimit 403设置太频繁，10分钟内只能设置1次，常见的错误信息请参见 错误码 文档。
上一篇: 查看回收站文件详情下一篇: 预览回收站项目

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈