免费下载 此API可用于启用任何已禁用的用户账号。也可以用来设置用户账号的到期日期。
Request URL (JSON) format: http://<hostname>:<port>/RestAPI/EnableUser
Request parameters:
| 参数名 | 强制性 | 描述 |
| PRODUCT_NAME | 是 | 发送请求的产品名称/模块名称;用于审计。 |
| AuthToken | 是 | 使用生成AuthToken API获得的身份验证令牌。 |
| domainName | 是 | 用户账户的域名。 |
| inputFormat | 是 | 要启用的每个用户帐户的详细信息。此属性应为JSONArray字符串，并且必须如下的格式。 [<JSONObject>, <JSONObject>, <JSONObject>]; JSONObject - LDAP属性及其相 应值的键/值对 java示例代码: JSONArray userDetails = new JSONArray(); JSONObject json = new JSONObject(); json.put("sAMAccountName", "John"); userDetails.put(json); json = new JSONObject(); json.put("sAMAccountName", "Mat"); userDetails.put(json); 注意: 您可以指定以下任何属性作为搜索条件，以使用REST API请求查找用户对象:
|
| accountExpires | 否 | 如果不希望设置帐户到期日期，请将accountExpires参数的值指定为Never。否则使用EndOf设置用户的过期时间。 |
| expireTimes | 否 | 只有在为accountExpires参数为End Of时，此参数才是强制的。过期时间必须设置为MM-dd-yyyy格式。 |
响应:
响应将是一个包含JSONObjects列表的JSONArray字符串。列表中的每个JSONObject表示在请求的inputFormat参数中发送的一个用户帐户。每个对象将包含以下属性:
| 参数名 | 描述 |
| userPrincipalName | 用户账户的userPrincipalName。 |
| sAMAccountName | 用户账户的sAMAccountName。 |
| objectSID | 用户账户的objectSID。 |
| statusMessage | 如果在处理请求时发生问题/错误，则包含适当的消息。 |
示例输入/输出
示例请求1:
http://Byron:8080/RestAPI/EnableUser?AuthToken=a70d9e6c-4167-4de4-a6a1-3b3aff50c82&PRODUCT_NAME=MODULE_NAME&domainName=admanagerplus.com&inputFormat=[{" sAMAccountName":"colin.altonen"}]&accountExpires=Never
示例请求2:
http://Byron:8080/RestAPI/DisableUser?AuthToken=a70d9e6c-4167-4de4-a6a1-3b3aff50c82&PRODUCT_NAME=MODULE_NAME&domainName=admanagerplus.com&inputFormat=[{" sAMAccountName":"colin.altonen"}]&accountExpires=EndOf&expireTime=12-21-2018
示例响应:
[{"userPrincipalName":"colin.altonen@admanagerplus.com","sAMAccountName":"colin.altone n","objectSID":"S-1-5-21-2996321955-1937665885-1535019402-3881","statusMessage":"Successfully modified."}]
基于技术员的启用用户限制
使用此API在一天内可以启用用户总数取决于许可中帮助台技术员(HDTs)的数量。
HDT可以进行的API调用的最大数量为50次/天，与HDT执行的任务无关。如果您有两个 HDT许可，则您可以进行的API调用总数为100次/天（100个AD对象）即2*50。
由于每天的API调用限制不是针对特定任务的，您可以执行任何操作，但API调用总数不应超过100。也就是说，一个HDT可以执行多种操作，如用户创建、OU创建、密码重置等等，但所有任务的API调用次数放在一起不应超过100。
注意:
保留字符包括 ; / ? : @ = &
不安全的字符包括 < > # % { } | \ ^ ~ [ ] ` "'
