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 10:49:14

简介

本文档提供关于回收站相关接口介绍以及示例代码。

列出回收站项目

功能说明

用于列出回收站项目。

示例代码

try{
let result = await SMHRecycledApis.listRecycled({
libraryId:"libraryId",
spaceId:"spaceId"
})
}catch (e) {
// 异常处理
}

参数说明

请求参数
描述
类型
是否必选
libraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
spaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
marker
用于顺序列出分页的标识,不能与 page 和 page_size 参数同时使用
String
limit
用于顺序列出分页时本地列出的项目数限制,不能与 page 和 page_size 参数同时使用
String
page
分页码,默认第一页,可选参数,不能与 marker 和 limit 参数同时使用
Number
pageSize
分页大小,默认 20,可选参数,不能与 marker 和 limit 参数同时使用
Number
orderBy
排序字段,按名称排序为 name,按修改时间排序为 modificationTime,按文件大小排序为 size,按删除时间排序为 removalTime,按剩余时间排序为 remainingTime
SMHFileListOrderBy
orderByType
排序方式,升序为 asc,降序为 desc
SMHOrderByType

恢复指定回收站项目

功能说明

恢复指定回收站项目。

示例代码

try{
let result = await SMHRecycledApis.restoreRecycledObject({
libraryId:"libraryId",
spaceId:"spaceId",
recycledItemId:312
})
}catch(e){
// 异常处理
}


参数说明

请求参数
描述
类型
是否必选
libraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
spaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
recycledItemId
回收站项目 ID
Number
conflictResolutionStrategy
路径冲突时的处理方式,默认为 ask
ask: 冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码
rename: 冲突时自动重命名文件
overwrite: 如果冲突目标为目录时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码,否则覆盖已有文件
SMHConflictResolutionStrategy
restorePathStrategy
恢复项目源路径的处理方式,默认为 originalPath
originalPath:恢复到原始路径,原始路径不存在则报错
fallbackToRoot:恢复到原始路径,原始路径不存在则恢复到根目录
SMHRestorePathStrategy

批量恢复指定回收站项目

功能说明

用于批量恢复指定回收站项目。

示例代码

try{
let result = await SMHRecycledApis.batchRestoreRecycledObject({
libraryId:"libraryId",
spaceId:"spaceId",
restorePathStrategy:SMHRestorePathStrategy.fallbackToRoot,
recycledItemIds:[1,2,3,4]
})
}catch(e){
// 异常处理
}

参数说明

请求参数
描述
类型
是否必选
libraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
spaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
recycledItemIds
批量恢复的 recycledItemId 集合
Number数组
restorePathStrategy
恢复项目源路径的处理方式,默认为 originalPath
originalPath:恢复到原始路径,原始路径不存在则报错
fallbackToRoot:恢复到原始路径,原始路径不存在则恢复到根目录
SMHRestorePathStrategy

删除指定回收站项目

功能说明

用于删除指定回收站项目。

示例代码

try{
let result = await SMHRecycledApis.deleteRecycledObject({
libraryId:"libraryId",
spaceId:"spaceId",
recycledItemId:312
})
}catch(e){
// 异常处理
}

参数说明

请求参数
描述
类型
是否必选
libraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
spaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
recycledItemId
回收站项目 ID
Number

批量删除指定回收站项目

功能说明

用于批量删除指定回收站项目。

示例代码

try{
let result = await SMHRecycledApis.batchDeleteRecycledObject({
libraryId:"libraryId",
spaceId:"spaceId",
recycledItemIds:[1,2,3,4]
})
}catch(e){
// 异常处理
}

参数说明

请求参数
描述
类型
是否必选
libraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
spaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
recycledItemIds
批量删除的 recycledItemId 集合
Number数组

清空回收站

功能说明

用于清空回收站。

示例代码

try{
let result = await SMHRecycledApis.clearRecycled({
libraryId:"libraryId",
spaceId:"spaceId"
})
}catch(e){
// 异常处理
}

参数说明

请求参数
描述
类型
是否必选
libraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
spaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String

查看回收站文件详情

功能说明

用于查看回收站文件详情。

示例代码

try{
let reuslt = await SMHRecycledApis.fileDetail({
libraryId:"libraryId",
spaceId:"spaceId",
recycledItemId:312
})
}catch(e){
// 异常处理
}

参数说明

请求参数
描述
类型
是否必选
libraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
spaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
recycledItemId
回收站项目 ID
Number

预览回收站项目

功能说明

用于根据文件 ID 查询文件信息。

示例代码

try{
let reuslt = await SMHRecycledApis.preview({
libraryId:"libraryId",
spaceId:"spaceId",
recycledItemId:312
})
}catch(e){
// 异常处理
}

参数说明

请求参数
描述
类型
是否必选
libraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
spaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
recycledItemId
回收站项目 ID
Number
type
文档类型文件的预览方式,如果设置为"pic"则以JPG格式预览文档首页,否则以HTML格式预览文档
SMHPreviewType
size
图片或视频封面的缩放大小,相关说明参阅接口说明
String
scale
图片或视频封面的等比例缩放百分比,不传 Size 时生效
String
widthSize
图片或视频封面的缩放宽度,不传高度时,高度按等比例缩放,不传 Size 和 Scale 时生效
String
heightSize
图片或视频封面的缩放高度,不传宽度时,宽度按等比例缩放,不传 Size 和 Scale 时生效
String
frameNumber
GIF 文件的帧数,针对 GIF 的降帧处理,仅在预览 GIF 类型文件时生效
String

帮助和支持

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

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

文档反馈