更新时间:2025-08-28 GMT+08:00

权限批量更新接口

功能介绍

权限批量更新接口

URI

PUT /koodrive/ose/v1/permission/batchupdate

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

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

X-Traceid

String

消息日志跟踪标识(必须58位)

language

String

国际化语言标识,符合i18n规范,如zh_cn表示简体中文,en_us表示美式英语

X-User-Id

String

用户id,用于app鉴权

X-Date

String

日期,用于app鉴权

Host

String

地址,用于app鉴权

表2 请求Body参数

参数

是否必选

参数类型

描述

amendModRoles

Array of AmendModRole objects

需要修改角色集合

type

Integer

类型,0为团队空间,1为群组空间

container

String

空间Id

fileId

String

文件Id(存在文件id,则是给资源赋权)

表3 AmendModRole

参数

是否必选

参数类型

描述

userId

Long

用户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

错误信息

请求示例

/koodrive/ose/v1/permission/batchupdate

{
  "amendModRoles" : [ {
    "userId" : "*****",
    "template" : "******",
    "capabilities" : {
      "addChildNodePermission" : true,
      "copyPermission" : false,
      "deletePermission" : false,
      "downloadPermission" : true,
      "editPermission" : false,
      "listChildNodePermission" : true,
      "removeChildNodePermission" : false,
      "renameFilePermission" : false,
      "shareFilePermission" : false,
      "uploadPermission" : true,
      "viewPermission" : true
    }
  } ],
  "type" : 0,
  "container" : "*****",
  "fileId" : "*****"
}

响应示例

状态码:200

权限批量更新响应。

{
  "code" : 0,
  "msg" : "success"
}

状态码

状态码

描述

200

权限批量更新响应。