创建权限模板 - createPermissionTemplate
功能介绍
创建权限模板
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/permission/template/create
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Authorization |
是 |
String |
格式“Bearer {app_access_token}”，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取 |
|
X-User-Id |
是 |
String |
用户id，用于app鉴权 |
|
X-Date |
是 |
String |
日期，用于app鉴权 |
|
Host |
否 |
String |
地址，用于app鉴权 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
权限模板的名称。长度大于0，小于等于8个中文或24个英文/数字。 |
|
description |
否 |
String |
权限模板的描述信息。长度大于0，小于等于50。 |
|
type |
是 |
Integer |
权限模板的类型；0是预置模板，1是自定义模板。 |
|
company |
是 |
String |
权限模板归属的企业。可以是orgid，也可以是appid。 |
|
capabilities |
是 |
Capabilities object |
各种权限值；ControlService需要转换成最终权限的十进制入库 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
响应消息 |
|
data |
PermissionTemplate object |
权限模板信息 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
权限模板的唯一id。 |
|
name |
String |
权限模板的名称。 |
|
description |
String |
权限模板的描述信息。 |
|
templateType |
Integer |
权限模板的类型；0是预置模板，1是自定义模板。 |
|
status |
Integer |
权限模板的状态；0是禁用，1是启用。 |
|
company |
String |
权限模板归属的企业。可以是orgid，也可以是appid。 |
|
createTime |
String |
权限模板的创建时间。 |
|
updateTime |
String |
权限模板的更新时间。 |
|
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无权限。 |
请求示例
/koodrive/ose/v1/permission/template/create
{
"company" : "*****",
"name" : "****",
"templateType" : 1,
"description" : "",
"capabilities" : {
"listChildNodePermission" : true,
"viewPermission" : false,
"editPermission" : false,
"uploadPermission" : false,
"downloadPermission" : false,
"shareFilePermission" : false,
"removeChildNodePermission" : false,
"copyPermission" : false,
"renameFilePermission" : false,
"deletePermission" : false,
"addChildNodePermission" : false
}
}
响应示例
状态码：200
创建模板响应体
{
"data" : {
"id" : "1590******52215169",
"name" : "*****",
"description" : "",
"templateType" : 1,
"status" : 0,
"company" : "*****",
"createTime" : "2025-01-03T07:56:29.450Z",
"updateTime" : "2025-01-03T07:56:29.450Z",
"capabilities" : {
"addChildNodePermission" : false,
"copyPermission" : false,
"deletePermission" : false,
"downloadPermission" : false,
"editPermission" : false,
"listChildNodePermission" : true,
"removeChildNodePermission" : false,
"renameFilePermission" : false,
"shareFilePermission" : false,
"uploadPermission" : false,
"viewPermission" : false
}
},
"code" : 0,
"msg" : "成功"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
创建模板响应体 |
