Title	Get Active Directory available organizational units by id
Group	admin
URL Path	vault_rest/settings/ ad/ available_organizational_units / {id}
Method	GET
Access	Internal

Http return	200, 400, 401, 403, 500
Table of Contents	Summary Use Cases (used by) HTTP header parameters Method: POST Descriptions of request: Request Error Response Example of successful request: Example of failed request: Descriptions of response:
Last Updated	06 Aug 2019

Summary

Returns MetaDefender Vault Active Directory available organizational units by id.

Use Cases (used by)

Used by Web Client to display Active Directory available organizational units.

HTTP header parameters

Authorization	The authentication token of the caller	REQUIRED	This header should have the following format: Bearer [ token obtained from authenticate API] Example: Bearer Cp01BwnXAIOLZXxn7yogjKqIZnZpQD

Request Error

400	Bad Request	Invalid HTTP request
403	Forbidden	Authentication token is incorrect
500	Internal Server Error	Server is temporarily unavailable

Response

Example of a successful request:

{  
   "organizational_units":[  
      {  
         "distinguished_name":"OU=Domain Controllers,DC=opswat,DC=local",
         "full_name":"Domain Controllers",
         "guid":"419ce3dcab1f44b1996f2ae726c0e99c",
         "last_ad_change":"2016-08-31T16:53:59.0000000+03:00",
         "name":"Domain Controllers"
      },
      {  
         "distinguished_name":"OU=Microsoft Exchange Security Groups,DC=opswat,DC=local",
         "full_name":"Microsoft Exchange Security Groups",
         "guid":"7ee7e67f08974311b8bfa2924a8bfbb7",
         "last_ad_change":"2016-08-31T17:30:55.0000000+03:00",
         "name":"Microsoft Exchange Security Groups"
      },
      {  
         "distinguished_name":"OU=OU1,DC=opswat,DC=local",
         "full_name":"OU1",
         "guid":"84c380bbf18e4ccea5ffc76645600688",
         "last_ad_change":"2018-03-09T15:19:24.0000000+02:00",
         "name":"OU1"
      },
      {  
         "distinguished_name":"OU=ou48,OU=ou47,OU=ou46,OU=ou45,OU=ou44,OU=ou43,OU=ou42,OU=ou41,OU=ou40,OU=ou39,OU=ou38,OU=ou37,OU=ou36,OU=ou35,OU=ou34,OU=ou33,OU=ou32,OU=ou31,OU=ou30,OU=ou29,OU=ou28,OU=ou27,OU=ou26,OU=ou25,OU=ou24,DC=opswat,DC=local",
         "full_name":"ou24\/ou25\/ou26\/ou27\/ou28\/ou29\/ou30\/ou31\/ou32\/ou33\/ou34\/ou35\/ou36\/ou37\/ou38\/ou39\/ou40\/ou41\/ou42\/ou43\/ou44\/ou45\/ou46\/ou47\/ou48",
         "guid":"0d0549bddc83429c9d62d176d002de1a",
         "last_ad_change":"2018-06-08T08:49:55.0000000+03:00",
         "name":"ou48"
      }
   ],
   "pagination_cookie":"AQAAADQCAAD\/\/\/\/\/FqsIokG728FkQuyeiSPXfUoBv0fkM2D\/pSac3\/l+z"
}   

Descriptions of request:

distinguished_name	Specifies the distinguished name	string
guid	Globally unique identifier of the group	string
last_ad_change	Specifies the last time related change in AD	integer
full_name	Number of group	string