文档首页/ 云空间服务 KooDrive/ API参考/ API/ 空间管理/ 创建一个群组空间 - CreateGroupSpace
更新时间:2026-05-15 GMT+08:00

创建一个群组空间 - CreateGroupSpace

功能介绍

创建一个群组空间。

授权信息

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

URI

POST /koodrive/ose/v1/space/group

请求参数

表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鉴权

表2 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

空间名称

iconUrl

否

String

空间头像

capacity

否

Integer

空间大小

addGroupUsers

是

Array of AddGroupUsers objects

添加群组用户列表

表3 AddGroupUsers

参数

是否必选

参数类型

描述

userId

是

String

用户id

template

是

Long

权限模板id,自定义模板传-1

capabilities

否

Capabilities object

权限值(自定义模板时传递)

表4 Capabilities

参数

是否必选

参数类型

描述

addChildNodePermission

是

Boolean

新建文件/文件夹权限;true有权限,false无权限。

copyPermission

是

Boolean

复制权限;true有权限,false无权限。

deletePermission

是

Boolean

删除权限;true有权限,false无权限。

downloadPermission

是

Boolean

下载权限;true有权限,false无权限。

editPermission

是

Boolean

编辑权限;true有权限,false无权限(暂不支持编辑)。

listChildNodePermission

是

Boolean

可见列表权限;true有权限,false无权限。

removeChildNodePermission

是

Boolean

移动权限;true有权限,false无权限。

renameFilePermission

是

Boolean

重命名权限;true有权限,false无权限。

shareFilePermission

是

Boolean

分享权限;true有权限,false无权限。

uploadPermission

是

Boolean

上传权限;true有权限,false无权限。

viewPermission

是

Boolean

预览权限;true有权限,false无权限。

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

code

Integer

错误码

msg

String

错误描述

failedList

Array of strings

失败列表

id

String

空间id

请求示例

创建一个群组空间为20G的群组空间。

POST /koodrive/ose/v1/space/

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

{
    "name": "api参考",
    "capacity": 20,
    "iconUrl": "1",
    "userIds": []
}

响应示例

状态码:200

基础响应,只返回错误码和错误信息。

{
  "id" : "xxx",
  "failedList" : [ ],
  "code" : 0,
  "msg" : "成功"
}

状态码

状态码

描述

200

基础响应,只返回错误码和错误信息。