按用户查询空间使用情况 - GetSpaceUsageByUser

功能介绍

按用户查询用户空间详情

授权信息

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

URI

POST /koodrive/ose/v1/space/usage/user

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}
X-Traceid	否	String	消息日志跟踪标识（必须58位）
language	否	String	国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语
X-User-Id	是	String	用户id，用于app鉴权
X-Date	是	String	日期，用于app鉴权
Host	是	String	地址，用于app鉴权

表2 请求Body参数
参数	是否必选	参数类型	描述
userIds	否	Array of strings	用户数组
limit	否	Integer	查询数量
offset	否	Integer	偏移量

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
code	Integer	返回码
msg	String	说明
data	Array of UserSpaceQuota objects	查询结果
total	Integer	总分配数

表4 UserSpaceQuota
参数	参数类型	描述
quota	String	配额
userId	String	用户id
used	Double	已使用量
createTime	String	开通时间
effectiveTime	String	有效时间
expirationTime	String	失效时间

请求示例

按用户查询用户空间详情

/koodrive/ose/v1/space/usage/user

Authorization:Bearer+c69b0f40334782d560bb154032cf22ef43d671843c4ffbad

{
    "limit": 10,
    "offset": 0,
    "userIds": [
        "232323",
        "34343434"
    ]
}

响应示例

状态码：200

空间用量分析

{
  "data" : [ {
    "quota" : "1048576",
    "userId" : "1008600000509220652",
    "used" : 0,
    "effectiveTime" : "2025-11-12T08:37:14.613Z",
    "expirationTime" : "2025-12-12T08:37:14.613Z"
  } ],
  "total" : 1,
  "code" : 0,
  "msg" : "success"
}