选择应用类型
企业内部应用开发
学习地图
动态与公告
应用开发平台简介(新版)
应用开发平台简介
开发应用(新版)
开发应用
服务端API
开发指南
API总览
身份验证(免登)
获取访问凭证
通讯录管理
上下游组织(原合作空间)
上下级组织(原关联组织)
考勤
日志
日程
签到
公告
音视频
钉工牌
工作台
服务窗
OA审批
即时通信IM
智能人事
智能填表
智能交互
组织大脑
待办任务
文档/文件
权限申请
知识库
钉盘
群文件
媒体文件
文档
搜索
存储管理
概述
企业管理
应用管理
空间管理
文件管理
文件传输
权限管理
添加权限
删除权限
修改权限
获取权限列表
设置权限继承模式
获取权限继承模式
回收站管理
任务管理
事件订阅
钉钉客联
互动卡片
应用管理
企业文化
专属开放
生态开放
智能硬件
行业开放
HCM 主数据
宜搭应用开发
客户管理(官方CRM)
Teambition 项目管理
钉钉快办
Agoal
炼丹炉(模型服务)
AI 助理
365会员
附录
客户端API
事件订阅
参考
常见问题
历史文档

设置权限继承模式新版SDK

更新于 2023-06-06

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月,当前接口会消耗调用次数。若该调用量无法满足需求,你可升级钉钉专业版(Open API调用量50万次/月)钉钉专属版(Open API调用量500万次/月)扩容调用次数。
设置权限继承模式。

接口功能介绍

调用本接口,根据文件uuid、操作者unonId和权限继承模式inheritance,设置权限的继承模式。

权限

要调用此API,需要以下权限之一。

应用类型

是否支持

权限

API Explorer调试

企业内部应用支持企业存储授权信息写权限API Explorer

请求方法

Loading...

Header参数

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

Path参数

名称

类型

是否必填

描述

dentryUuid

String

文件uuid:

  • 企业内部应用,可调用搜索文件接口,获取返回参数dentryUuid字段。

Query参数

名称

类型

是否必填

描述

unionId

String

用户unionId。

Body参数

名称

类型

是否必填

描述

inheritance

String

权限继承模式,枚举值:

  • PASS_ON: 传递

当前文件(夹)会继承所有父节点的权限, 然后结合当前文件(夹)上的权限, 相同成员权限取最大。

  • BREAK: 打断

权限的传递在当前节点做一个打断。

说明

  • 不支持OWNER和MANAGER的打断
  • 默认权限继承模式

返回参数

名称

类型

描述

success

Boolean

本次操作是否成功。

示例

请求示例

Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

返回示例

Loading...

错误码

HttpCode

错误码

错误信息

说明

400

paramError

%s

参数错误

400

paramError.dentryUuid

%s

参数错误-dentryUuid

400

paramError.permissionInheritance

%s

参数错误-permissionInheritance

400

inheritanceUnsupportedForOwnerAndManager

%s

OWNER和MANAGER不支持设置权限继承模式

400

inheritanceUnsupportedForCurrentDentry

%s

当前文件不支持设置权限继承模式

404

spaceNotExist

%s

空间不存在

404

dentryNotExist

%s

文件不存在

500

systemError

%s

系统错误

500

unknownError

Unknown Error

未知错误

503

operationTimeout

%s

请求超时

点击纠错