Get Active Directory available organizational units by ID
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 |
|
Last Updated |
08 Oct 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 API key of the caller |
REQUIRED |
This header should have the following format: Bearer [ Example: Bearer Cp01BwnXAIOLZXxn7yogjKqIZnZpQD |
Request Error
400 |
Bad Request |
Invalid HTTP request |
403 |
Forbidden |
API key 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 |