权限批量更新接口 - PermissionBatchUpdate
功能介绍
权限批量更新接口
授权信息
当前API调用无需身份策略权限。
URI
PUT /koodrive/ose/v1/permission/batchupdate
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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鉴权 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
amendModRoles |
是 |
Array of AmendModRole objects |
需要修改角色集合 |
|
type |
是 |
Integer |
类型，0为团队空间，1为群组空间 |
|
container |
是 |
String |
空间Id |
|
fileId |
否 |
String |
文件Id(存在文件id，则是给资源赋权) |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
userId |
是 |
Long |
用户id |
|
template |
是 |
Long |
权限模板id，匿名模板传-1，（用户组批量添加成员或者用户组批量删除成员时非必填） |
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
权限批量更新响应。 |
