权限批量更新接口 - 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鉴权
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" : "*****"
}