功能描述
用于设置回收站生命周期。
说明:
要求权限: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 | 回收站保留天数,要求 0 < retentionDays <= 10000 | Number | 是 |
响应
响应码
修改成功,返回 HTTP 204 No Content
响应体
该响应无响应体。
错误码
可能存在的错误码 SetRecycleLifecycleFrequencyLimit 403设置太频繁,10分钟内只能设置1次,常见的错误信息请参见 错误码 文档。