有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

功能描述

用于批量查询列出租户空间容量信息。要求权限如下:
非 acl 鉴权:如需列出所有租户空间,非 acl 需要 admin 或 space_admin 权限,否则仅列出当前访问令牌所代表的用户所创建的租户空间。
acl 鉴权:无权限。
说明
非 acl 鉴权是指当前用户对所有文件的操作权限,详情可参见 生成访问令牌接口
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": "3333",
"availableSpace": "12345",
"fileSize": "2222"
},
{
"spaceId": "space3p5klbgcwndnt",
"capacity": "100000",
"availableSpace": "4566",
"fileSize": "2222"
}
]
响应体字段说明:
节点名称(关键字)
描述
spaceId
租户空间 ID
capacity
租户空间配额,如果为 null 则无配额
availableSpace
租户空间配可用容量,如果为 null 则无配额
fileSize
租户空间已上传文件占用的存储额度