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:15:01

功能描述

用于创建租户空间。
说明:
需要 admin 或 create_space 权限,有关权限详情请参见 生成访问令牌接口
仅限在开启多租户模式的媒体库中使用该接口。
媒体托管暂不提供租户空间名属性,如业务有相关需要,可自行保存空间 ID 与空间名的映射。
创建租户空间时可在请求体中以 JSON 格式指定扩展属性。

请求

请求示例

POST /api/v1/space/`{LibraryId}`?access_token=`{AccessToken}`&user_id=`{UserId}`

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
AccessToken
访问令牌,获取请参见 生成访问令牌
String
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参见 生成访问令牌
String

请求体

空或 application/json,可指定租户空间的扩展属性。
{
"isPublicRead": false,
"isMultiAlbum": true,
"allowPhoto": true,
"allowVideo": true,
"allowPhotoExtname": [ ".jpg", ".png", ".heic" ],
"allowVideoExtname": [ ".mp4", ".mov" ],
"recognizeSensitiveContent": true,
"spaceTag": "team"
}
请求体字段说明:
请求参数
描述
类型
是否必选
isPublicRead
是否为公有读,不指定默认为 false,当租户空间设置为公有读时,部分读接口无需指定访问令牌,请参阅具体的 API 说明,该参数可随时修改
Boolean
isMultiAlbum
是否为多相簿空间,不指定默认为 false,此时租户空间不允许创建目录或相簿,该参数仅允许在创建租户空间时指定,后续无法修改
Boolean
allowPhoto
是否允许上传照片,不指定默认为 false,该参数可随时修改
Boolean
allowVideo
是否允许上传视频,不指定默认为 false,该参数可随时修改
Boolean
allowPhotoExtname
默认为空数组,当该参数不为空数组时,仅当上传的文件扩展名存在于该列表中才允许上传且认定为照片,当该参数为空数组时则根据上传的文件扩展名动态判断是否为照片类型,该参数可随时修改
Array
allowVideoExtname
默认为空数组,当该参数不为空数组时,仅当上传的文件扩展名存在于该列表中才允许上传且认定为视频,当该参数为空数组时则根据上传的文件扩展名动态判断是否为视频类型,该参数可随时修改
Array
recognizeSensitiveContent
是否检测敏感内容,不指定默认为 false
Boolean
spaceTag
空间标识,用于区分个人空间和团队空间
String

响应

响应码

获取成功,返回 HTTP 201 Created。

响应体

{ "spaceId": "spacexxx" }
响应体字段说明:
节点名称(关键字)
描述
类型
spaceId
新创建的租户空间的空间 ID
String

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。

帮助和支持

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

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

文档反馈