功能描述
用于列出租户空间列表信息。要求权限如下:
非 acl 鉴权:如需列出所有租户空间,非 acl 需要 admin 或 space_admin 权限,否则仅列出当前访问令牌所代表的用户所创建的租户空间。
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 | 字符串,用于顺序列出分页的标识,如果没有更多则不存在该字段 |