创建OU API

此API有助于从应用程序创建Active Directory OU。

请求URL(JSON)格式: http://: /RestAPI/CreateOU

请求参数

参数名 强制性 描述
domainName 在其中创建OU的域的名称。
inputFormat 要创建的OU的属性详细信息。此属性应为JSONArray字符串,并且应采用如下的格式。
[>, , ]; JSONObject - LDAP属性及其相应值的键/值对
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。

注意:

  • 默认的管理帐户将不会被视为帮助台技术员。
  • 确保URL对REST API请求中使用的所有特殊和保留字符进行编码。由于发送请求的客户端(浏览器、postman或TP工具)不属于ADManager Plus,因此为特殊、保留和不安全字符编码URL完全由用户负责。

    保留字符包括 ; / ? : @ = &
    不安全的字符包括 < > # % { } | \ ^ ~ [ ] ` "'

他们正在使用ADManager Plus简化Windows AD域管理