GetUserRoles

Description

This services returns a list of roles for a specified user.

Arguments

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.
user UserIdentifier Indicates the user for which roles should be returned.
project ProjectIdentifier Indicates the project.

Response

One or more RoleHolder responses are returned. The roles are returned in the context of the specified user. The role name, type, and assignment information are returned. For more information, see RoleHolder.

Usage

The <urn:user> parameter uniquely identifies the user. Providing the <urn:project> value 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.

Faults

XML

The following XML is a snippet of the payload that is sent with GetUserRoles.

<urn:GetUserRoles>
    <urn:auth>
        <urn:userId>bill</urn:userId>
        <urn:password></urn:password>
        <urn:hostname></urn:hostname>
    </urn:auth>
    <urn:user>
        <urn:loginId>john</urn:loginId>
    </urn:user>
    <urn:project>
        <urn:displayName>IM Project</urn:displayName>
    </urn:project>
</urn:GetUserRoles>