新建文件权限项

适用版本>=v7.0.2410as.20241017

接口说明：新建文件权限项

请求说明

请求地址	配置域名+/openapi+/v7/drives/{drive_id}/files/{file_id}/permissions/create
请求方法	POST
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	查询和管理文件权限（用户授权） kso.file_permission.readwrite

请求头（Header）

Header	参数类型	是否必填	说明
Content-Type	string	是	使用：application/json
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：Bearer {access_token}

路径参数（Path）

名称	参数类型	是否必填	说明
drive_id	string	是	驱动盘id，<= 1024 characters
file_id	string	是	文件id，<= 1024 characters

请求体（Body）

名称	类型	是否必填	说明
overwrite	bool	是	是否覆盖子文件
role_id	string	是	权限角色，<= 1024 characters。 支持仅查看view_only、可编辑editable、可评论commentable、可管理manageable、可分享shareable、禁止访问prohibited和自定义权限角色 (自定义权限角色请通过获取文档权限角色列表
subject_id	string	是	权限主体标识，<= 1024 characters subject_type为dept时，subject_id为部门id dept_id； subject_type为group时，subject_id为团队id group_id； subject_type为user时，subject_id为用户id user_id；
subject_type	string	是	权限主体类型，可选值： 部门 dept；团队 group；用户 user

请求体示例

{
  "overwrite": true,
  "role_id": "string",
  "subject_id": "string",
  "subject_type": "dept"
}

响应体（Response）

名称	类型	说明
code	int	错误码
detail	string	详细信息
msg	string	状态信息
data	object	null

响应体示例

{
  "data": null,
  "code": 0,
  "detail": "string",
  "msg": "string"
}