此API可帮助您使用应用程序提出添加文件夹权限的工作流请求。
请求URL (JSON)格式: http:// <hostname> : <port> /RestAPI/CreateWorkFlowRequest
请求参数:
参数 | 强制性 | 描述 |
AuthToken | 是 | 使用生成AuthToken API获得的身份验证令牌。 |
domainName | 是 | 所需的域名。 |
inputData | 有关要提出的工作流请求的详细信息。 | |
是 | 在主题下指定请求的标题。 | |
是 | 将操作指定为RequestAction下的ADD_Folder_PERMISSION。 | |
是 | 指定要设置其权限的文件夹。 | |
可选 | 指定要应用的权限。 | |
可选 | 指定您希望在多长时间后应用权限。为此,请使用durationType和Duration属性。durationType属性可以具有分钟、小时、天和日期等值。Duration属性用于指定分钟数、小时数、天数或确切日期。使用yyyy/MM/dd hh:mm:ss格式指定所需的日期。仅当durationType属性的值为空时,Duration属性才是可选的。 | |
是 | 指定要为其设置权限的用户帐户。 | |
可选 | 指定任务的优先级。 | |
可选 | 提供适当的描述。 | |
PRODUCT_NAME | 是 | 发送请求的产品名称/模块名称;用于审计。 |
以下是可指定用于指示duration和durationType的值的组合:
durationType | duration |
- | 0 (立即) |
minutes | 30 |
hours | 1 |
hours | 2 |
days | 1 |
date | 2019/07/31 15:09:00 日期时间格式为: yyyy/MM/dd HH:mm:ss.. 例如: 2019/07/31 15:09:00 |
以下是用于应用关联权限的访问掩码:
访问掩码 | 权限 |
2032127 | 完全控制 |
1245631 | 修改 |
1179817 | 读取和执行 |
1179785 | 读取 |
1048854 | 写入 |
131241 | 列出文件夹内容 |
32 | 遍历文件夹/执行文件 |
1 | 列出文件夹/读取数据 |
128 | 读取属性 |
8 | 读取扩展属性 |
2 | 创建文件/写入数据 |
256 | 写入属性 |
16 | 写入扩展属性 |
64 | 删除子文件夹和文件 |
65536 | 删除 |
131072 | 读取权限 |
262144 | 写入权限 |
524288 | 取得所有权 |
响应参数:
参数 | 描述 |
Subject | 请求的主题 |
requestId | 提出的请求的RequestId。如果操作失败,这不会显示在响应中。 |
status | 操作状态,其中1代表成功,0代表失败。 |
statusMessage | 成功或失败时要显示的响应消息。 |
示例请求:
http://admanager:8080/RestAPI/CreateWorkFlowRequest?AuthToken=244f8f17-041d-4c85-9924-02f7351a6fbb&domainName=admp.local&PRODUCT_NAME=RESTAPI&inputData=[{"RequestAction":"ADD_FOLDER_PERMISSION", "Subject":"Set Folder Permissions", "Priority":"3", Description:"Rest Desc", "accounts":{"user":[{"sAMAccountName":"John"}]}, "folders":{"\\\\admp-dc1\\share":"share"}, "permissions":["1179785", "1048854"], "durationType":"date", "duration":"2020/12/30 23:59:00"}]
示例响应:
[{"Subject":"Set Folder Permissions","requestId":10204,"statusMessage":"Successfully created the request.","status":"1"}]