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

  • 200 Successful: Request was successful.
  • 403 Forbidden: logged on user does not have the Cluster administrator role.
  • 404 Not Found: No user groups found.
  • 500 Internal Server Error: Exception occurred

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.

<userGroup name=”%s”>
<atom:link rel="self" href="%s"/>
 <admins>
  <user name=”%s”>
   ...
  </user>
  </admins>
 <users>
  <user name=”%s”>
   ...
 </users >
</userGroup>
Failure Message

If not successful, returns an error message.

<error>
  <message>
     %s
  </message>
</error>

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>