Get detailed user group information by user group name
Description
URL |
scheme://domain:port/platform/ws/usergroups/{userGroupName} |
Description |
The logged on user must have view_configure permission on the setting resource to use this API. Gets detailed information about user groups with the specified name. To specify multiple user groups, separate with a comma(,). For example: group1,group2. Use the keyword all to get detailed information for all user groups in the cluster. Use the API /platform/ws/usergroups/ to get a list of user groups. |
HTTP-Method |
GET |
Parameters |
None |
Request
Request-Method |
GET |
|
Request-URI |
/platform/ws/usergroups/{userGroupName} |
|
Request-Header |
Name |
Value |
Accept |
application/xml or application/json |
|
Message-body |
empty |
|
Response
Response-Code |
|
|
Response-Header |
Name |
Value |
Content-Type |
application/xml or application/json |
|
Message-body |
Success Message | If successful, returns detailed information about user groups. For additional information, refer to the schema file GUID-e22cbcbf-f95d-43f4-a363-13cde34e1f15.xsd. |
| Failure Message | If not successful, returns an error message. |
|
Example: Get detailed information about user group group0
# Request
GET /platform/ws/usergroups/group0 HTTP/1.1
Host: www.example.org
# Response
200 Successful
Content-Type: application/xml;
<userGroup name=”group0”>
<atom:link rel="self" href="http://www.example.org/ws/usergroups/group0"/>
<admins>
<user name=”user1”>
….
</admins>
<users>
<user name=”user2”>
…
</users >
</userGroup>