功能描述
用于批量查询列出租户空间容量信息。要求权限如下:
非 acl 鉴权:如需列出所有租户空间,非 acl 需要 admin 或 space_admin 权限,否则仅列出当前访问令牌所代表的用户所创建的租户空间。
acl 鉴权:无权限。
请求
请求示例
GET /api/v1/usage/`{LibraryId}`/`{SpaceIds}`?access_token=`{AccessToken}`&user_id=`{UserId}`
请求参数
请求参数 | 描述 | 是否必选 |
LibraryId | 媒体库 ID | 是 |
AccessToken | 访问令牌 | 对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数。 |
UserId | 否 | |
SpaceIds | 空间列表,以逗号分隔,如 space1,space2 | 否 |
请求体
该请求无请求体。
响应
响应码
获取成功,返回 HTTP 200 OK。
响应体
[{"spaceId": "space04fzo07fdq61b","capacity": "10000","availableSpace": "5000","size": "1000"},{"spaceId": "space3p5klbgcwndnt","capacity": "10000","availableSpace": "5000","size": "1000"}]
响应体字段说明:
节点名称(关键字) | 描述 |
spaceId | 租户空间 ID |
capacity | 租户空间配额,如果为 null 则无配额。单位为字节(Byte) |
availableSpace | 租户空间配可用容量,如果为 null 则无配额。单位为字节(Byte) |
size | 租户空间已上传文件占用的存储额度。单位为字节(Byte) |