Previous Topic: Get a List of Group MembersNext Topic: Create Groups Using Web Services


Get a List of Groups that You Own

You can only modify or delete groups that you own. If you created a group, you are the owner of that group. The global administrator is the owner of all groups in the Groups tree. In addition, the global administrator or tenant administrator can edit your user account to give you ownership of a "branch" of the Groups tree.

Use the Users web service to get a list of the groups of which you are the owner. Consult the following descriptions to use the Users web service:

Issue the following call to see the parameters and available operations for the users web service:

http://CA Performance Center Server IP Address:8181/pc/center/rest/users/documentation

Available GET Methods

get groups owned by user

Retrieves a list of groups for the specified user. The groups that are returned are groups that are owned by the specified user, meaning that this user can modify or delete these groups:

http://CA Performance Center server IP address:8181/pc/
center/webservice/users/idName/idValue/groupsOwnedByUser
get groups

Retrieves a list of groups to which the specified user has view access. The groups that are returned are groups that are within the permission set of the specified user. The user cannot modify or delete these groups:

http://CA Performance Center server IP address:8181/pc/
center/webservice/users/idName/idValue/groups
get id names

Retrieves a list of identifiers that can be used to identify users in other web service methods.

http://CA Performance Center Server IP Address:8181/pc/
center/webservice/users/idNames
idValue

Is the value for the identifying category. For example, if idName is userID, provide the user ID. If idName is userName, provide the user name.

get authentication types

Returns a list of identifiers that can be used to assign authentication types to users.

http://CA Performance Center Server IP Address:8181/pc/
center/webservice/users/authenticationTypes

Available PUT Methods

update role

Updates the role assignment of a specified user account.

http://CA Performance Center Server IP Address:8181/pc
/center/webservice/users/idName/idValue/role/roleIdName/roleIdValue
update time zone

Updates the time zone of a specified user account.

http://CA Performance Center Server IP Address:8181/pc
/center/webservice/users/idName/idValue/timeZone/newTimeZone
set groups

Updates the permission groups that have been granted to a specified user account.

http://CA Performance Center Server IP Address:8181/pc
/center/webservice/users/idName/idValue/groups
set administered groups

Updates the groups of a specified user account.

http://CA Performance Center Server IP Address:8181/pc
/center/webservice/users/idName/idValue/administeredGroup

To add administered groups to a user account, supply XML in the following format (for example):

<groups>
  <group ID="5245"/> 
  <group ID="5246"/> 
  <group ID="5247"/>
... 
 </groups>
update product privilege per datasource

Updates the product privilege of a specified user account to enable access to the user interface of a specific datasource.

http://CA Performance Center Server IP Address:8181/pc
/center/webservice/users/idName/idValue/ds/dsId/
productPrivilege/newProductPrivilege
dsId

The data source identifier. For a list of available data source identifiers, see Basic Datasource Parameters.

For more information about product privileges, see User Account Product Privilege Settings.

Available POST Methods

create

Creates a new user account. The new user is associated with the tenant for the logged-in user. The parameters include a role assignment.

http://CA Performance Center Server IP Address:8181/pc
/center/webservice/users/role/roleIdName/roleIdValue

For more information, see Create a User Account.

create in tenant

Creates a new user account in the specified tenant, with the specified role assignment.

http://CA Performance Center Server IP Address:8181/pc
/center/webservice/users/tenant/tenantIdName/tenantIdValue
/role/roleIdName/roleIdValue