
# 权限批量更新接口 - 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，则是给资源赋权) |
   
 表3AmendModRole 
| 参数           | 是否必选 | 参数类型                                                                | 描述                                        |
|:---|:---|:---|:---|
| userId       | 是    | Long                                                                | 用户id                                      |
| template     | 是    | Long                                                                | 权限模板id，匿名模板传-1，（用户组批量添加成员或者用户组批量删除成员时非必填） |
| capabilities | 否    | [Capabilities] object | 权限值（自定义模板时传递）                             |
   
 表4Capabilities 
| 参数                        | 是否必选 | 参数类型    | 描述                             |
|:---|:---|:---|:---|
| 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 | 权限批量更新响应。 |
   
