此API有助于从应用程序创建Active Directory OU。
请求URL(JSON)格式: http://
请求参数
参数名 | 强制性 | 描述 |
domainName | 是 | 在其中创建OU的域的名称。 |
inputFormat | 是 | 要创建的OU的属性详细信息。此属性应为JSONArray字符串,并且应采用如下的格式。 [>, |
AuthToken | 是 | 使用生成authToken接口获取的身份验证令牌。 |
PRODUCT_NAME | 是 | 发送请求的产品名称/模块名称;用于审计。 |
响应:
响应将是一个包含JSONObjects列表的JSON数组字符串。列表中的每个JSONObject表示在请求的inputFormat属性中发送的一个对象。每个对象将包含有关状态的以下属性。
参数名 | 描述 |
status | OU创建操作的状态。成功时为'SUCCESS',失败时为'SEVERE'。 |
statusMessage | 包含有关执行指定操作时发生的问题或错误的消息。 |
USER_NAME | 创建的OU的名称。仅当OU创建成功时才会显示。 |
示例请求格式:
http://admanager:8080/RestAPI/CreateOU?AuthToken=ac2d6090-11d0-4028-a2d5-f38a7930912e&domainName=mse1.com&inputFormat=[{"name":"testBOU5", "OUName":"OU=test,DC=mse1,DC=com"}]&PRODUCT_NAME=RESTAPI
示例响应格式:
响应:
[{"USER_NAME":"testBOU5","LOG_ON_NAME":"","statusMessage":"Successfully created the OUs.","status":"SUCCESS"}]
基于技术员的OU创建限制
使用CreateOU API可以在一天内创建的OU总数取决于许可的帮助台技术人员(HDTs)的数量。
HDT可以进行的API调用的最大数量为50次/天,与HDT执行的任务无关。如果您有两个 HDT许可,则您可以进行的API调用总数为100次/天(100个AD对象)即2*50。
由于每天的API调用限制不是针对特定任务的,您可以执行任何操作,但API调用总数不应超过100。也就是说,一个HDT可以执行多种操作,如用户创建、OU创建、密码重置等等,但所有任务的API调用次数放在一起不应超过100。
下面的公式解释了许可技术员一天内可以创建的OU总数:
一天内创建的OU总数 =HDT总数 * 技术员所在范围对应的API数。
也就是说,如果ADManager Plus中有4个技术员许可,那么每天可以创建的OU总数是20个(4 技术员 * 5 API 数 = 20 OU/天)。 如果需要,任何一个技术员都可以创建所有的20个OU。
注意:
保留字符包括 ; / ? : @ = &
不安全的字符包括 < > # % { } | \ ^ ~ [ ] ` "'