外观
获取当前租户的存储用量与配额
GET
/v1/tenants/me/storage
默认返回逻辑用量(各文档版本大小求和、用户感知值);传 dimension=physical 时 usageBytes 切到物理用量(去重后实际占用字节求和),其他任何取值(含拼写错误、空值)均按 logical 处理,不会报错。返回值带 5 分钟级缓存延迟,sampledAt 字段为采样时刻 epoch 毫秒;调用方不应将返回值视为实时强一致数据。
参数
请求头参数
Authorization*
访问令牌以 Bearer 方案在 HTTP Authorization 请求头携带。请在此填入完整值(含 Bearer 前缀),例如:Bearer <accessToken>。
类型
必填string
示例
"Bearer <accessToken>"X-Atk-User-Token
强通道(可选):以某已签发的 atkonbase 用户会话 token 调用,ACL 解析与操作归属走该用户。与弱通道 X-Atk-Act-As-Source(-Id) 互斥——同时携带返回业务码 101008。两个 SDK 均由 client 侧拦截器统一注入(actAsToken()),此处仅为门户演练暴露。
类型
string
X-Atk-Act-As-Source
弱通道(可选):外部身份来源标识,须与 X-Atk-Act-As-Source-Id 成对携带,缺一返回业务码 101009。仅当该 Client 的 act_as_user_allowed=true 时生效,否则静默降级为 APP_ONLY;与强通道互斥。两个 SDK 均由 client 侧拦截器统一注入(actAsSource()),此处仅为门户演练暴露。
类型
string
X-Atk-Act-As-Source-Id
弱通道(可选):外部身份在其来源系统内的 ID,须与 X-Atk-Act-As-Source 成对携带,缺一返回业务码 101009。
类型
string
查询参数
dimension
类型
string
响应
OK
*/*
JSON "code": 0, "data": { "tenantId": "string", "dimension": "string", "usageBytes": 0, "logicalUsageBytes": 0, "physicalUsageBytes": 0, "documentCount": 0, "versionCount": 0, "quotaBytes": 0, "softLimitRatio": 0, "enforced": true, "sampledAt": 0 }, "ts": 0, "rid": "string", "msg": "string", "success": true
{
}