批量查询列出租户空间容量信息

最近更新时间:2025-09-24 15:20:12

我的收藏

功能描述

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

请求

请求示例

GET /api/v1/usage/`{LibraryId}`/`{SpaceIds}`?access_token=`{AccessToken}`&user_id=`{UserId}`

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
AccessToken
访问令牌,获取请参见 生成访问令牌
String
对于公有读媒体库或租户空间,可不指定该参数,否则必须指定该参数。
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参见 生成访问令牌
String
SpaceIds
空间列表,以逗号分隔,如 space1,space2
String

请求体

该请求无请求体。

响应

响应码

获取成功,返回 HTTP 200 OK。

响应体

[
{
"spaceId": "space04fzo07fdq61b",
"capacity": "10000",
"availableSpace": "5000",
"size": "1000"
},
{
"spaceId": "space3p5klbgcwndnt",
"capacity": "10000",
"availableSpace": "5000",
"size": "1000"
}
]
响应体字段说明:
节点名称(关键字)
描述
类型
spaceId
租户空间 ID
String
capacity
租户空间配额,如果为 null 则无配额。单位为字节(Byte)
String
availableSpace
租户空间配可用容量,如果为 null 则无配额。单位为字节(Byte)
String
size
租户空间已上传文件占用的存储额度。单位为字节(Byte)
String

错误码

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