Web Services Developer's Guide → Web Services API Reference → SBM Administrative Web Services → Administrative Calls → GetGroupRoles
This services returns a list of roles for a specified group.
Argument | Type | Description |
---|---|---|
auth (optional) | Auth | The Auth type supplies credentials and optionally, a host name for licensing. The userId and password can be specified with HTTP BASIC or WS-SECURITY instead. |
group | GroupIdentifier | Indicates the group for which roles should be returned. |
project | ProjectIdentifier | Indicates the project. |
One or more RoleHolder responses are returned. The roles are returned in the context of the specified group. The role name, type, and assignment information are returned. For more information, see RoleHolder.
The <urn:group> parameter uniquely identifies the group. Providing the <urn:projectId> value in the GroupIdentifier improves performance of the call, especially for the systems with several projects.
If an invalid role or no role is specified at all, the call will succeed, but no role information will be returned.
The following XML is a snippet of the payload that is sent with GetGroupRoles.
<urn:GetGroupRoles> <urn:auth> <urn:userId>bill</urn:userId> <urn:password></urn:password> <urn:hostname></urn:hostname> </urn:auth> <urn:group> <urn:displayName>IDM View Only</urn:displayName> </urn:group> <urn:project> <urn:displayName>IDM Project</urn:displayName> </urn:project> </urn:GetGroupRoles>
Copyright © 2007–2016 Serena Software, Inc. All rights reserved.