Common Request Parameters
A set of Common Request Parameters are required for each User Administration Service operation. The following table lists all of the User Administration Service Common Request Parameters. For more information on the parameters, view the TIBCO LogLogic® Appliance user interface for Manage Users as well as the online help.
| Parameter | Description | Values | Required | Type |
|---|---|---|---|---|
| authToken | Unique authentication token. | yes | string | |
| applianceIp | The managed Appliance on which you perform the operation.
If the value is blank, it retrieves the Appliance IP address from the local Appliance. This parameter is available only for Management Station Appliances using operations with Remote in the name. |
IP address of a managed Appliance. To specify an IP address, use the standard IP address format. For example:
10.1.2.3 |
yes
(for xxxxRemote operations only) |
string |
| loginName | Login name for the user you are creating. | Any text up to 16 characters in length. | yes | string |
| firstName | First name of the user. | Any text up to 64 characters in length. | No | string |
| lastName | Last name of the user. | Any text up to 64 characters in length. | No | string |
| loginPassword | Password used for user login.
In addition, you can use the loginPassword parameter to update/change a user’s password. For Active Directory (AD) users, enclose the password in single-quotes (‘) when it is an input parameter to a shell script. AD passwords can contain special characters (such as !, @, or *) which the shell does not properly interpret unless within single-quotes. |
The password must be at least 6 characters long, contain at least one non-alphabetic character, and cannot be the same as the loginName. | yes | string |
| phone | Contact phone number of user. | Any valid phone number up to 32 characters in length. | No | string |
| Email address of the user. | Any valid email address up to 64 characters in length. | Yes | string | |
| enabled | Enable or disable the user specified with the loginName parameter.
(Appears as enabled or disabled in returned value.) |
Possible values:
yes — enable no — disable |
yes | string |
| privileges | Identifies the access privileges for the specified user. You can specify a User Type (contains a pre-defined list of privileges) or specific privileges.
To view the user interface implementation, navigate to the Administration > Manage Users > Privileges tab. The Import/Export privilege contains a forward slash (/). To specify it here, replace / with %2F. |
For a list of possible values, see
User Administration Privileges.
To specify multiple values, you must separate entries with a forward slash (/). For example: User Administrator/Manage Alerts/Manage Devices |
yes | string |
| devices | Identifies the devices that the user can access. You can specify All for provide access to all devices in the Appliance or you can identify specific devices.
You can use the getList Operation to retrieve a list of device names in your LogLogic Appliance. Alternatively, you can view use the user interface to view all devices by navigating to Administration > Manage Devices. |
Possible values:
All - all devices deviceName - specify each device name as it appears in the LogLogic Appliance. To specify multiple values, you must separate entries with a forward slash (/). For example: “Device1/Device2/Device7/Device9” |
yes | string |
| appliances | (Management Station only)
Identifies the Appliance in the Management Station cluster that this user accesses. |
Any valid IP address | yes (for createUser, createUser Remote, updateUser and updateUser Remote only) | number |
| changeLogin Name | New login name for a user.
If empty, the login name is unchanged. |
Any text up to 64 characters in length. | yes (for updateUser and TIBCO LogLogic LMI Web Services API Implementation Guide only) | string |