列出租户空间

最近更新时间:2025-11-07 17:13:52

我的收藏

功能描述

用于列出租户空间列表信息。
说明:
如需列出所有租户空间,需要 admin 或 space_admin 权限,否则仅列出当前访问令牌所代表的用户所创建的租户空间。有关权限请参见 生成访问令牌接口

请求

请求示例

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

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
AccessToken
访问令牌,获取请参见 生成访问令牌
String
Marker
用于顺序列出分页的标识,即上一次请求返回的 nextMarker 字段
String
Limit
用于顺序列出分页时租户空间数量限制,默认为1000,范围为[1,1000]
String

请求体

该请求无请求体。

响应

响应码

获取成功,返回 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": "eyJmb3JtYXQiOjIsInRhYmх1X21kIjoхLCJzсGFjZV9pZCI6IiJ9",
"nextMarker":"eyJmb3JtYXQiOjIsInRhYmх1X21kIjoхLCJzсGFjZV9pZCI6IiJ9"
}
响应体字段说明:
响应
描述
类型
List
记录租户空间信息
List
marker
用于列出分页的标识
String
nextMarker
用于顺序列出分页的标识,如果没有更多则不存在该字段
String
List 中包含以下参数:
节点名称(关键字)
描述
类型
spaceId
租户空间 ID
String
userId
创建者用户 ID
String
creationTime
租户空间创建时间,ISO 8601格式的日期与时间字符串,例如2020-10-14T10:17:57.953Z
String
说明:
响应体中 nextMarker 为空时才会展示 List 列表。

错误码

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