文档首页/ 云空间服务 KooDrive/ API参考/ API/ 精细化授权/ 权限批量更新接口 - PermissionBatchUpdate
更新时间:2026-05-15 GMT+08:00

权限批量更新接口 - PermissionBatchUpdate

功能介绍

权限批量更新接口

授权信息

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

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

表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

权限批量更新响应。