更新时间：2026-02-03 GMT+08:00
创建一个用户群组 - CreateUserGroup
功能介绍
创建一个用户群组。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/usergroups
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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鉴权 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
groupName | 是 | String | 用户组名，不能包括'<>|:"*?/'和emoji，不能等于'..','.','' |
sourceType | 是 | Integer | 用户组类型 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 群组id |
code | Integer | 信息码 |
msg | String | 信息 |
请求示例
用户创建1个群组。
POST /koodrive/ose/v1/usergroups
Authorization:Bearer+c69b0f40334782d560bb154032cf22ef43d671843c4ffbad
{
"capacity": 1,
"type": 0
} 响应示例
状态码：200
基础响应。正确时，返回创建用户群组的ID，错误时只返回错误码和错误信息。
{
"code" : 0,
"msg" : "成功",
"id" : "xxx"
} 状态码
状态码 | 描述 |
|---|---|
200 | 基础响应。正确时，返回创建用户群组的ID，错误时只返回错误码和错误信息。 |
父主题：群组管理
