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:35:41
想要充分利用 SMH,您需要了解一些相关的基本概念和术语。

存储桶

存储桶(Bucket),指对象存储 COS 中用于存储对象的存储空间。
在智能媒资托管中,一个存储桶中可以存储多个对象。存储桶名由用户自定义的字符串和系统自动生成的数字串用中划线连接而成,以保证该存储桶全球唯一。
在数据万象中,数据万象是基于对象存储 COS 的数据处理平台,您需要绑定或新建 COS 存储桶才可使用数据万象相关功能。一个存储桶中可以存储多个对象。存储桶名称由用户自定义的字符串和系统自动生成的数字串用中划线连接而成,以保证该存储桶全球唯一。更多详细信息,请参见 存储桶概述

访问令牌

通过在服务端调用生成访问令牌 API 生成,在生成时需指定媒体库 ID 和媒体库密钥,由于媒体库密钥需要保密,不能在客户端保存和使用,故不允许在客户端调用生成访问令牌 API。
除了操作媒体库和调用与访问令牌本身相关的 API,或媒体库、租户空间设置为公有读时调用读接口,其他情况必须传入访问令牌用来验证访问的合法性。
在生成访问令牌时需要指定所授予的权限,同时也可以指定其他参数,有关生成访问令牌的详细说明,请参阅 生成访问令牌 API 文档

客户端识别

如果您的产品和服务允许用户多端同时登录,那么用户可能有管理其他端登录状态的需求,以便其他设备遗失时避免身份被冒用,此时您的产品和服务后端需要记录用户所有登录的客户端的设备名(或其他设备标识),以方便用户识别具体的设备并删除遗失设备的登录状态。智能媒资托管也允许您在生成访问令牌时指定客户端识别,在用户需要删除指定客户端的登录状态时,可以据此删除对应的访问令牌,保护用户的身份和数据。

媒体库 ID

即 LibraryId,用来唯一标识一个媒体库,在创建媒体库时自动生成,调用所有 API 时均需要指定媒体库 ID。

媒体库

媒体库是智能媒资托管中最大的一级单元划分,每一个媒体库完全独立。媒体库底层需要绑定同一主账号下的对象存储存储桶,媒体库中的所有文件内容均保存在所绑定的存储桶的特定前缀(目录)中。您需要在智能媒资托管控制台中创建媒体库并同时绑定存储桶,绑定存储桶时还需要指定可访问该存储的腾讯云密钥(SecretId 和 SecretKey)。不同的媒体库可以绑定同一个存储桶,彼此之间不会产生文件覆盖或干扰。
仅在创建、删除和修改媒体库的部分设置时需要使用腾讯云账户登录控制台操作,其他操作均使用智能媒资托管的认证与鉴权,通过调用 API 来实现,不再要求拥有和使用腾讯云账户登录。

媒体库密钥

即 LibrarySecret,在调用与访问令牌有关的接口时需要指定该参数,用来验证调用者的合法性,在创建媒体库时自动生成。该参数需保密,不能在客户端保存和使用,只能在服务端保存和使用。

SecretKey

SecretId 和 SecretKey 合称为云 API 密钥,是用户访问腾讯云 API 进行身份验证时需要用到的安全凭证。SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。一个 APPID 可以创建多个云 API 密钥。

SecretId

SecretId 和 SecretKey 合称为云 API 密钥,是用户访问腾讯云 API 进行身份验证时需要用到的安全凭证。SecretId 用于标识 API 调用者身份。一个 APPID 可以创建多个云 API 密钥。

相簿

在创建媒体库(单租户)或通过 API 创建租户空间(多租户)时,可以指定是否开启多相簿模式,如果开启多相簿,则需要先创建相簿,照片和视频等媒体资源只能上传到相簿中而不允许直接上传到租户空间中,且相簿不支持多级,即相簿中不能再创建子相簿。如果不开启多相簿,则不允许创建相簿,媒体资源只能直接上传到租户空间中。
是否启用多相簿仅能在创建媒体库或租户空间时设置,创建完成后无法修改。同一租户空间中的相簿名称不能重复。

用户身份识别

智能媒资托管没有用户的概念,也不托管您产品和服务的用户信息,但是在使用访问令牌调用相关 API 时,您可能希望能够记录和识别相关操作的操作者是谁,例如相簿的创建者和媒体资源的上传者等,因此您可以在生成访问令牌时传入用户身份识别,该用户身份识别可以是您产品和服务中已有用户体系的 ID 或用户名,也可以是微信小程序等的 openid,在您需要时您可以自行据此进行进一步的操作。
如果生成访问令牌时申请管理员权限且未指定用户身份识别,在使用访问令牌调用其他 API 时可临时指定一个用户身份识别,以便您在服务端以特定用户身份调用 API 而无需重复生成访问令牌。

租户空间

您的产品和服务可能需要动态创建一些隔离的存储空间,例如独立的栏目或文章,或为产品的每个最终用户,此时可以通过创建“多租户模式”的媒体库来满足需要。在多租户媒体库中,可以通过 API 动态的创建、删除和修改这些隔离的租户空间,在对这些租户空间进行文件管理时,既可以使用与租户空间对应的访问令牌,也可以使用不限制租户空间的高权限访问令牌,满足不同的管理需要。
在创建媒体库时可选择是否启用多租户模式,媒体库创建完成后无法修改该属性。如果未开启则为单租户模式,此时可以理解整个媒体库即为一个租户空间。

帮助和支持

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

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

文档反馈