tencent cloud

智能媒资托管

产品简介
产品概述
功能介绍
产品优势
应用场景
基本概念
购买指南
快速入门
创建媒体库
发起请求
服务级 API 文档
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
业务级 API 文档
简介
访问令牌操作接口
租户空间操作接口
文件操作接口
目录或相簿操作接口
回收站操作接口
配额操作接口
查询任务操作接口
搜索操作接口
历史版本操作接口
目录和文件批量操作接口
收藏操作接口
Error Codes
SDK 文档
Android SDK
iOS SDK
鸿蒙 SDK
常见问题
企业网盘
产品简介
购买指南
快速入门
常见问题
Service Level Agreement
词汇表
文档智能媒资托管业务级 API 文档租户空间操作接口批量查询列出租户空间容量信息

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

PDF
聚焦模式
字号
最后更新时间： 2026-01-07 14:15:02

功能描述

用于批量查询列出租户空间容量信息。
说明：
如需列出所有租户空间，需要 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

错误码

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

上一篇: 查询媒体库容量信息下一篇: 查询租户空间属性

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈