创建部门或个人空间 - CreateSpace
功能介绍
创建一个部门或个人空间。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/space/{ownerId}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| ownerId | 是 | String | 拥有者标识 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} |
| X-User-Id | 是 | String | 用户id,用于app鉴权 |
| X-Date | 是 | String | 日期,用于app鉴权 |
| Host | 是 | String | 地址,用于app鉴权 |
| X-Traceid | 否 | String | 消息日志跟踪标识(必须58位) |
| language | 否 | String | 国际化语言标识,符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语,不传默认美式英语 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| capacity | 是 | String | 申请空间大小 |
| type | 是 | Integer | 空间类型 |
| capabilities | 否 | Capabilities object | 用户权限 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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
| 参数 | 参数类型 | 描述 |
|---|---|---|
| data | createSpaceRspInfo object | 空间信息 |
| code | Integer | 信息码 |
| msg | String | 信息 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| type | Integer | 所有者类型 0:部门空间 1:个人空间 2:群组空间 |
| status | Integer | 状态 |
| ownerId | String | 云空间所有者 1、当为部门空间时,返回部门ID 2、当为个人空间时,返回用户ID 3、当为群组空间时,返回群组ID |
| containerId | String | 云空间ID |
| bizRootFileId | String | 业务根目录ID,存储未加密的普通文件 |
| bizSboxFileId | String | 业务保险箱目录ID,存储加密的文件 |
| capacity | Integer | 空间大小 |
| spaceUsed | Integer | 已用空间大小 |
| tenantId | String | 租户id |
| creator | String | 创建者 |
| modifier | String | 修改者id |
| rootFileId | String | 云空间根目录id |
| operatorId | Integer | 操作者id |
请求示例
为部门1289173650183882753创建1G的空间。
POST /koodrive/ose/v1/space/1289173650183882753
Authorization:Bearer+10f88**********4791e9ff
{
"capacity": 1,
"type": 0
} 响应示例
状态码:200
基础响应,只返回错误码和错误信息。
{
"code" : 0,
"msg" : "成功"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 基础响应,只返回错误码和错误信息。 |