文档首页/ 云空间服务 KooDrive/ API参考(运营商)/ API/ 空间管理/ 按配额查询空间使用情况 - GetSpaceUsageByQuota
更新时间:2026-02-03 GMT+08:00

按配额查询空间使用情况 - GetSpaceUsageByQuota

功能介绍

按分配配额查询总分配数,总空间,总已使用空间

授权信息

当前API调用无需身份策略权限。

URI

GET /koodrive/ose/v1/space/usage/quota

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

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

表2 响应Body参数

参数

参数类型

描述

code

Integer

返回码

msg

String

说明

data

Array of SpaceQuotaUsage objects

查询结果

total

Integer

总数

表3 SpaceQuotaUsage

参数

参数类型

描述

totalAllocation

Long

分配总量;单位KB

totalCapacity

Long

配额总量;单位KB

totalUsed

Long

已用总量;单位KB

quota

String

配额;单位GB

请求示例

按分配配额查询总分配数,总空间,总已使用空间

/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

空间用量分析