Get Active Directory available groups by ID
|
Title |
Get Active Directory available groups by id |
|
Group |
admin |
|
URL Path |
vault_rest/settings/ ad/available_groups/ {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 groups by id.
Use Cases (used by)
Used by Web Client to display Active Directory available groups.
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:
{ "groups":[ { "dn":"CN=WinRMRemoteWMIUsers__,CN=Users,DC=opswat,DC=local", "guid":"f426dcba4aaf4b979ec59f77fca13792", "last_ad_change":"2016-08-31T16:54:00.0000000+03:00", "name":"WinRMRemoteWMIUsers__" }, { "dn":"CN=Administrators,CN=Builtin,DC=opswat,DC=local", "guid":"bc5f7352410e4ad4b9dbf6aab9cfb1c4", "last_ad_change":"2016-08-31T17:39:22.0000000+03:00", "name":"Administrators" }, { "dn":"CN=Users,CN=Builtin,DC=opswat,DC=local", "guid":"31bd0d22eb454163acb7ac145e6a9524", "last_ad_change":"2016-08-31T16:54:38.0000000+03:00", "name":"Users" }, { "dn":"CN=Guests,CN=Builtin,DC=opswat,DC=local", "guid":"5fe26e4acdae4b20b16de04f75c00209", "last_ad_change":"2016-08-31T16:54:38.0000000+03:00", "name":"Guests" } ], "pagination_cookie":"AQAAADQCAAD\/\/\/\/\/gJQ0qbhCSVIfwZkAoBPFgK+opJ10xPqGbfRFQSOh12+t\/bMQVUs3SbmPQdyVZG3UAAAAAAE"}Descriptions of request:
|
dn |
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 |
|
name |
Name of group |
string |