文档首页/ 云空间服务 KooDrive/ API参考/ API/ 空间管理/ 获取空间信息 - GetSpaceV2
更新时间：2025-10-22 GMT+08:00
查看PDF
分享

获取空间信息 - GetSpaceV2

功能介绍

获取空间信息（一个用户可能多个空间，此接口获取空间信息列表）

授权信息

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

URI

GET /koodrive/ose/v2/space/{owner_id}

表1 路径参数

参数

是否必选

参数类型

描述

owner_id

是

String

用户id
表2 Query参数

参数

是否必选

参数类型

描述

type

否

String

空间类型

0 部门空间

1 个人空间

2 群组空间

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

Host

是

String

地址，用于app鉴权

Authorization

是

String

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

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

code

Integer

信息码

msg

String

信息

data

Array of SpaceInfoV2 objects

空间信息列表
表5 SpaceInfoV2

参数

参数类型

描述

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

创建者

modifier

String

修改者id

rootFileId

String

云空间根目录id

请求示例

获取空间信息（一个用户可能多个空间，此接口获取空间信息列表）

GET /koodrive/ose/v2/space/12156464

Authorization: HMAC-SHA256 AppId=a378331eca141163119eb602adb67b7802cc79cd33ba44c7d2fe61d1586c96a1,SignedHeaders=host;x-date;x-user-id,Signature=bd355f202be40f95bf9510fd7bd48ad711a7d144c01df07d515ee0fbf3a47416
X-User-Id: 1505084218764547200
Host: 10.32.45.165
X-Date: 20240909T033325Z

响应示例

状态码：200

获取空间信息响应

{
  "data" : {
    "tenantId" : "0929b397a3424384b32cf8f96d9f35e4",
    "creator" : "1465814559892958208",
    "modifier" : "1465814559892958208",
    "ownerId" : 1517293342025685000,
    "type" : 1,
    "status" : 0,
    "capacity" : 1,
    "spaceUsed" : 0,
    "containerId" : "IAACk0hRXpq9DAWkA1537830432752646913",
    "rootFileId" : "HFNKeRWAxXJU4ittbTKM7OQCFOOojMDWV",
    "bizRootFileId" : "DFFemr0MBaQArootIAACk0hRXpq9DAWkA1537830432752646913",
    "bizSboxFileId" : "DFFemr0MBaQAsboxIAACk0hRXpq9DAWkA1537830432752646913",
    "operatorId" : 1465814559892958200,
    "name" : "121-2"
  },
  "code" : 0,
  "msg" : "操作成功。"
}

状态码

状态码

描述

200

获取空间信息响应
父主题： 空间管理

相关文档