tencent cloud

智能媒资托管

产品简介
产品概述
功能介绍
产品优势
应用场景
基本概念
购买指南
快速入门
创建媒体库
发起请求
服务级 API 文档
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
业务级 API 文档
简介
访问令牌操作接口
租户空间操作接口
文件操作接口
目录或相簿操作接口
回收站操作接口
配额操作接口
查询任务操作接口
搜索操作接口
历史版本操作接口
目录和文件批量操作接口
收藏操作接口
Error Codes
SDK 文档
Android SDK
iOS SDK
鸿蒙 SDK
常见问题
企业网盘
产品简介
购买指南
快速入门
常见问题
Service Level Agreement
词汇表

设置回收站生命周期

PDF
聚焦模式
字号
最后更新时间: 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次,常见的错误信息请参见 错误码 文档。

帮助和支持

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

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

文档反馈