按配额查询空间使用情况 - GetSpaceUsageByQuota
功能介绍
按分配配额查询总分配数,总空间,总已使用空间
授权信息
当前API调用无需身份策略权限。
URI
GET /koodrive/ose/v1/space/usage/quota
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 参数解释: 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| X-Traceid | 否 | String | 参数解释: 业务跟踪id(必须58位) 约束限制: 不涉及 取值范围: 长度为58位 默认值: 不涉及 |
| language | 否 | String | 参数解释: 国际化语言标识 约束限制: 符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语 取值范围: 符合i18n规范 默认取值: en-US |
| X-User-Id | 是 | String | 参数解释: KooDrive侧用户id,用于app鉴权 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| X-Date | 是 | String | 参数解释: 日期,用于app鉴权 约束限制: 日期格式:yyyyMMDD'T'HHmmss'Z' ; 例如20251103T070140Z 取值范围: 距当前时间15分钟以内,不能晚于当前时间 默认值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | Integer | 返回码 |
| msg | String | 说明 |
| data | Array of SpaceQuotaUsage objects | 查询结果 |
| total | Integer | 总数 |
请求示例
按分配配额查询总分配数,总空间,总已使用空间
/koodrive/ose/v1/space/usage/quota Authorization:Bearer+c69b0f40334782d560bb154032cf22ef43d671843c4ffbad
响应示例
状态码:200
空间用量分析
{
"data" : [ {
"quota" : "1",
"totalAllocation" : 1,
"totalCapacity" : 1,
"totalUsed" : 0
}, {
"quota" : "5",
"totalAllocation" : 24,
"totalCapacity" : 120,
"totalUsed" : 3654281
}, {
"quota" : "10",
"totalAllocation" : 6,
"totalCapacity" : 60,
"totalUsed" : 5494113
}, {
"quota" : "15",
"totalAllocation" : 2,
"totalCapacity" : 30,
"totalUsed" : 37
}, {
"quota" : "50",
"totalAllocation" : 4,
"totalCapacity" : 200,
"totalUsed" : 23937175
}, {
"quota" : "200",
"totalAllocation" : 1,
"totalCapacity" : 200,
"totalUsed" : 0
}, {
"quota" : "500",
"totalAllocation" : 4,
"totalCapacity" : 2000,
"totalUsed" : 0
}, {
"quota" : "1048576",
"totalAllocation" : 1,
"totalCapacity" : 1048576,
"totalUsed" : 0
} ],
"total" : 8,
"code" : 0,
"msg" : "success"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 空间用量分析 |