此API可帮助您提出工作流请求,以便从应用程序将用户添加到特定AD组。
请求URL (JSON)格式: http:// <hostname> : <port> /RestAPI/CreateWorkFlowRequest
请求参数:
参数 | 强制性 | 描述 |
AuthToken | 是 | 使用生成AuthToken API获得的身份验证令牌。 |
domainName | 是 | 在其中执行此操作的域。 |
inputData | 有关要提出的工作流请求的详细信息。它还必须包含有关必须将其添加到的用户和组的详细信息。您还可以指定可以从该组中删除用户的持续时间。 | |
是 | 在主题下指定请求的标题。 | |
是 | 在RequestAction下将操作指定为Add_Users_to_GROUP。 | |
是 | 指定要添加到组的用户帐户。 | |
可选 | 指定任务的优先级。 | |
可选 | 提供适当的描述。 | |
是 | 输入用户添加到的组的sAMAccountName。 | |
可选 | 指定您希望在多长时间后将这些用户从组中删除。为此,请使用durationType和Duration属性。durationType属性可以具有分钟、小时、天和日期等值。Duration属性用于指定分钟数、小时数、天数或确切日期。使用yyyy/MM/dd hh:mm:ss格式指定所需的日期。仅当durationType属性的值为空时,Duration属性才是可选的。 | |
PRODUCT_NAME | 是 | 发送请求的产品名称/模块名称;用于审计。 |
以下是可指定用于指示持续时间和持续时间类型的值的组合:
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 |
响应参数:
参数 | 描述 |
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_USERS_TO_GROUP", "Subject":"Add to Group", "accounts":[{"sAMAccountName":"john"}], "groups"=[{"sAMAccountName":"manager"}], "durationType":"date", "duration":"2020/07/31 15:09:00"}]
示例响应:
[{"Subject":"Add to Group","requestId":6305,"statusMessage":"Successfully created the request.","status":"1"}]