更新时间:2026-02-03 GMT+08:00

查询空间信息 - GetSpace

功能介绍

查询个人空间信息。

授权信息

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

ownerId

String

参数解释:

空间的所有者

约束限制:

不涉及

取值范围:

KooDrive用户ID

默认值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

type

String

参数解释:

空间类型

约束限制:

不涉及

取值范围:

  • 1:个人

默认值:

不涉及

containerId

String

参数解释:

空间ID

约束限制:

空间类型为个人(type=1)且存在多个个人空间时需指定containerId

取值范围:

默认值:

不涉及

请求参数

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

表4 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应消息

data

SpaceInfo object

空间信息

表5 SpaceInfo

参数

参数类型

描述

type

String

所有者类型1:个人空间

status

String

状态

ownerId

String

云空间所有者;当为个人空间时,返回用户ID

containerId

String

云空间ID

bizRootFileId

String

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

bizSboxFileId

String

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

capacity

String

空间大小;单位是GB;当统计总的空间需要和capacityKb字段的值相加

spaceUsed

String

已用空间大小;单位是KB

tenantId

String

租户id

creator

String

创建者

createTime

String

创建时间

modifier

String

修改者id

updateTime

String

更新时间

rootFileId

String

云空间根目录id

capacityKb

String

扩容包空间大小;单位是KB;统计总的空间需要和capacity相加

请求示例

查询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

空间信息。