创建租户空间

最近更新时间:2025-09-24 15:20:11

我的收藏

功能描述

用于创建租户空间。
说明:
需要 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

错误码

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