文档首页/云空间服务 KooDrive/API参考/API/空间管理/查询空间信息 - GetSpace
更新时间：2026-02-03 GMT+08:00
查看PDF
分享

查询空间信息 - GetSpace

功能介绍

查询个人、部门或群组的空间信息。

授权信息

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

URI

GET /koodrive/ose/v1/space/{ownerId}

表1 路径参数

参数

是否必选

参数类型

描述

ownerId

是

String

拥有者标识

表2 Query参数

参数

是否必选

参数类型

描述

type

是

String

空间类型

  • 0：部门

  • 1：个人

  • 2：群组

containerId

否

String

type=1且存在多个个人空间时需指定containerId

请求参数

表3 请求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鉴权

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应消息

data

SpaceInfo object

空间信息

表5 SpaceInfo

参数

参数类型

描述

type

String

所有者类型 0：部门空间 1：个人空间 2：群组空间

status

String

状态

ownerId

String

云空间所有者

1、当为部门空间时，返回部门ID

2、当为个人空间时，返回用户ID

3、当为群组空间时，返回群组ID

containerId

String

云空间ID

bizRootFileId

String

业务根目录ID，存储未加密的普通文件

bizSboxFileId

String

业务保险箱目录ID，存储加密的文件

capacity

String

空间大小

spaceUsed

String

已用空间大小

tenantId

String

租户id

creator

String

创建者

createTime

String

创建时间

modifier

String

修改者id

updateTime

String

更新时间

rootFileId

String

云空间根目录id

请求示例

查询369528171409614001的个人空间信息。

GET /koodrive/ose/v1/space/369528171409614001?type=1

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

响应示例

状态码：200

空间信息。

{
  "data" : {
    "tenantId" : "40086000004871666",
    "creator" : "369528171409614001",
    "createTime" : "2023-11-07T20:36:35.000Z",
    "modifier" : "369528171409614001",
    "updateTime" : "2023-12-26T11:40:07.000Z",
    "ownerId" : "369528171409614001",
    "type" : 1,
    "status" : 0,
    "capacity" : 800,
    "spaceUsed" : 91966408,
    "containerId" : "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4",
    "rootFileId" : "HFFdIb642fU51JWKAUlP6mwUVc8oDNKbO",
    "bizRootFileId" : "DEUI7pa0C24ArootIAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4",
    "bizSboxFileId" : "DEUI7pa0C24AsboxIAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4"
  },
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

空间信息。

父主题：空间管理