列出租户空间

最近更新时间:2024-06-12 16:06:44

我的收藏

功能描述

用于列出租户空间列表信息。要求权限如下:
非 acl 鉴权:如需列出所有租户空间,非 acl 需要 admin 或 space_admin 权限,否则仅列出当前访问令牌所代表的用户所创建的租户空间。
acl 鉴权:无权限。
说明
非 acl 鉴权是指当前用户对所有文件的操作权限,详情可参见 生成访问令牌接口
acl 鉴权是通过共享授权接口给指定用户,以文件夹为单位授予的权限,详情可参见 角色授权模块

请求

请求示例

GET /api/v1/space/{LibraryId}/list?access_token={AccessToken}&user_id={UserId}&marker={Marker}&limit={Limit}

请求参数

请求参数
描述
是否必选
LibraryId
媒体库 ID
AccessToken
访问令牌
对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数。
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参见 生成访问令牌接口
Marker
用于顺序列出分页的标识
Limit
用于顺序列出分页时本地列出的项目数限制

请求体

该请求无请求体。

响应

响应码

获取成功,返回 HTTP 200 OK。

响应体

响应体示例:
{
"list":[
{
"spaceId": "space04fzo07fdq61b",
"userId": "",
"creationTime": "2020-10-16T02:31:50.000Z"
},
{
"spaceId": "space3p5klbgcwndnt",
"userId": "",
"creationTime": "2020-10-16T02:31:50.000Z"
}
]
"marker":"xxx"
}
响应体字段说明:
节点名称(关键字)
描述
spaceId
租户空间 ID
userId
创建者用户 ID
creationTime
租户空间创建时间,ISO 8601格式的日期与时间字符串,例如 2020-10-14T10:17:57.953Z
marker
字符串,用于顺序列出分页的标识,如果没有更多则不存在该字段