文档首页/ 云空间服务 KooDrive/ API参考/ API/ 空间管理/ 获取用户空间列表
更新时间：2024-07-30 GMT+08:00
查看PDF
分享

获取用户空间列表

功能介绍

查询部门下用户空间列表信息。当未传入department_id时，查询当前登录用户所在组织的用户空间列表。

URI

GET /koodrive/ose/v1/space/userList

表1 Query参数

参数

是否必选

参数类型

描述

deptId

否

String

部门标识。当未传值时，系统管理员用户查询当前组织下的用户空间列表，部门管理员用户查询所在部门的用户空间列表

isDirect

否

Boolean

是否为直属用户，默认为false

offset

是

String

偏移量，最小值为0

limit

是

String

最大返回个数。最小值为1，最大值为100

keyWord

否

String

搜索的关键字，可用name和mobile作为关键字搜索条件。

spaceStatus

否

String

空间状态

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

  1. 格式“Bearer {app_access_token}”，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取 2. 此处应用为KooDrive服务端

X-Traceid

否

String

消息日志跟踪标识（必须58位）

language

否

String

国际化语言标识，符合i18n规范，如zh_cn表示简体中文，en_us表示美式英语

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

code

String

响应码

msg

String

响应消息

users

Array of userSpaceInfo objects

用户空间信息

total

String

总数
表4 userSpaceInfo

参数

参数类型

描述

name

String

用户名称

deptId

String

部门标识

deptName

String

部门名称

mobile

String

手机号

role

Integer

用户角色

status

Integer

用户账号状态

containerId

String

空间标识

capacity

Long

个人空间大小

spaceUsed

Long

已用空间大小

tenantId

String

租户id

id

String

用户空间id

userId

String

用户id

spaceStatus

String

空间状态

请求示例

获取本部门的用户空间列表信息。

GET /koodrive/ose/v1/space/userList?deptId=&isDirect=&offset=0&limit=100&keyWord

Authorization:Bearer+10f88**********4791e9ff

响应示例

状态码： 200

用户空间列表信息

{
  "total" : 1,
  "users" : [ {
    "tenantId" : "cad444830661464d9da88784a96d960c",
    "status" : 0,
    "capacity" : 10,
    "spaceUsed" : 189,
    "containerId" : "IAAE49hOR8LulgAAA1410765425310141185",
    "id" : "1410765364786334592",
    "role" : 1,
    "name" : "xx",
    "deptName" : "xxx",
    "userId" : "1008600000445114904",
    "deptId" : 1410183811475666000,
    "mobile" : "0086147****6900",
    "spaceStatus" : "0"
  } ],
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

用户空间列表信息
父主题： 空间管理