...
...
...
...
...
...
Panel | ||||
---|---|---|---|---|
|
...
- Create a User
- Delete a User
- List Users
- Modify a User
- Read a User
- Create Personal Access Token
- List Personal Access Tokens
- Revoke Personal Access Token
Formatting specifications for each web service, including details about parameter requirements, are provided.
...
XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
...
Anchor |
---|
...
|
Description | |
---|---|
URI | http://host_name/uc/resources/user |
HTTP Method |
DELETE |
Description |
Deletes a User. | |
URI Parameters | See Delete a User URI Parameters, below. |
Example URI |
Authentication
HTTP Basic
Produces Content-Type
text/plain
Consumes Content-Type
Application/XML, Application/JSON
Example Responses
Status 200
ucp_taUFeDdhrlpn8Gc5Vu9IO2LRQ29pbvBRJUSPvifX
Status 400
Error message.
Status 403
Operation prohibited due to security constraints.
Status 404
A user with name “{name}” does not exist.
A user with id "{uuid}" does not exist.
Status 500
Unexpected request failure. See log(s) for more details.
Create Personal Access Token: Payload Properties (XML, JSON)
Property
UI Field Name
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Parameter | Description | Specifications | Required | Mutually Exclusive With |
---|
N/A
UUID of the user
UUID of the user
N
userName
N/A
User Name
String value of User name
N
userId
Token Name
Token Name
Specifies the name of the application that will access the Universal Controller Web Service APIs using the personal access token.
Y
Expiration
Description of property.
Specifies when the personal access token expires. If left unspecified, the token never expires.
N
Create Personal Access Token: XML and JSON Examples
XML | JSON | Example Request|||
---|---|---|---|---|
| ID used within the Controller to identify this user. | String; URI parameter. | Y (unless |
|
| Name used within the Controller to identify this user. | String; URI parameter. | Y (unless |
|
Anchor | ||||
---|---|---|---|---|
|
Description | |
---|---|
URI | http://host_name/uc/resources/user/list |
HTTP Method | GET |
Description | Retrieves information on all Users. |
Example URI | http://localhost:8080/uc/resources/user/list http://localhost:9090/uc/resources/user/list?showTokens=true |
Authentication | HTTP Basic |
Produces Content-Type | application/xml, application/json |
Example | |
User Properties | See User Properties. |
User Permission Properties | |
User Role Properties | See User Role Properties. |
List Users: URI Parameters
Name | Description | Specifications | Required |
---|---|---|---|
| Show personal access tokens. | Boolean
| N |
Anchor | ||||
---|---|---|---|---|
|
XML | JSON | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Example Response |
|
|
...
Description
...
URI
...
HTTP Method
...
DELETE
...
Description
...
Deletes a User.
...
URI Parameters
...
See Delete a User URI Parameters, below.
...
Example URI
...
- http://localhost:8080/uc/resourcess/user?username=Test_User_Name
- http://localhost:9080/uc/resources/user?userid=18fcf558002743e38edc49114734b6d9
...
Example Response
...
- Status 200 /OK
User {username} deleted successfully. - Status 400 /Bad Request
Mutual exclusion violation. Cannot specify userid and username at the same time. - Status 404 /Not Found
User with {username/userid} does not exist.
...
Parameter
...
Description
...
Specifications
...
Required
...
Mutually Exclusive With
...
userid
...
ID used within the Controller to identify this user.
...
String; URI parameter.
...
Y (unless userename
is specified)
...
username
...
username
...
Name used within the Controller to identify this user.
...
String; URI parameter.
...
Y (unless userid
is specified)
...
userid
...
Description
...
URI
...
http://host_name/uc/resources/user/token/list
...
HTTP Method
...
GET
...
Description
...
List the user tokens
...
Example URI
...
http://localhost:9090/uc/resources/user/token/list
http://localhost:9090/uc/resources/user/token/list?username=test
http://localhost:9090/uc/resources/user/token/list?userid=1234567
...
Authentication
...
HTTP Basic
...
Produces Content-Type
...
Application/XML, Application/JSON
...
Consumes Content-Type
...
Example Responses
...
Status 200
Successful token list
Status 400
Error message.
Status 403
Operation prohibited due to security constraints.
Status 404
A user with name “{name}” does not exist.
A user with id "{uuid}" does not exist.
Status 500
Unexpected request failure. See log(s) for more details.
List Personal Access Tokens: Query Parameters
The following request parameters can be used to filter the results for the service.
...
Property
...
UI Field Name
...
Description
...
Specifications
...
Required
...
Mutually Exclusive With
...
userid
...
N/A
...
UUID of the user
...
UUID of the user
...
N
...
username
...
username
...
N/A
...
User Name
...
String value of User name
...
N
...
userid
List Personal Access Tokens: XML and JSON Examples
...
XML
...
JSON
...
Expand | ||
---|---|---|
| ||
|
...
Expand | ||
---|---|---|
| ||
|
...
Description | ||||||
---|---|---|---|---|---|---|
URI | http://host_name/uc/resources/user/list | |||||
HTTP Method | GET | |||||
Description | Retrieves information on all Users. | |||||
Example URI | http://localhost:8080/uc/resources/user/list | |||||
Authentication | HTTP Basic | |||||
|
Anchor | ||||
---|---|---|---|---|
|
Description | |
---|---|
URI | http://host_name/uc/resources/user |
HTTP Method | PUT |
Description | Modifies the User specified by the sysId in the request. |
Example URI | http://localhost:8080/uc/resources/user |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | n/a |
Example | |
User Properties | See User Properties. |
User Permission Properties | |
User Role Properties | See User Role Properties. |
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Description | ||
---|---|---|
URI | http://host_name/uc/resources/user | |
HTTP Method | GET | |
Description | Retrieves information on a specific User. | |
URI Parameters | See Read a User: URI Parameters, below. | |
Example URI | ||
Consumes Content-Type | n/a | |
Produces Content-Type | application/xml, application/jsonExample | |
User Properties | ||
User Permission Properties | ||
User Role Properties | See User Role Properties. |
Optionally Include Personal Access Tokens on User Payloads: List User API
The User Read and List API’s optionally allows to display the tokens using the query parameter. The default value is false and user has to pass the parameter to view the token details.
...
Description
...
URI
...
http://host_name/uc/resources/user/list
...
HTTP Method
...
GET
...
Description
...
List the user tokens
...
Example URI
...
http://localhost:9090/uc/resources/user/list?showTokens=true
http://localhost:9090/uc/resources/user/list?showTokens=false
...
Authentication
...
HTTP Basic
...
Produces Content-Type
...
Application/XML, Application/JSON
...
Consumes Content-Type
...
Example Responses
...
Status 200
Successful user details
Status 400
Error message.
Status 403
Operation prohibited due to security constraints.
Status 500
Unexpected request failure. See log(s) for more details.
...
XML
...
JSON
...
...
Expand | ||
---|---|---|
| ||
[ { |
...
Description
...
URI
...
HTTP Method
...
PUT
...
Description
...
Modifies the User specified by the sysId in the request.
To modify User properties without modifying related records, see the excludeRelated property.
...
Example URI
...
Consumes Content-Type
...
application/xml, application/json
...
Produces Content-Type
...
n/a
...
Example
...
See Create, Modify, and Read a User: XML and JSON Examples.
...
User Properties
...
See User Properties.
...
User Permission Properties
...
See User Permission Properties.
...
User Role Properties
...
See User Role Properties.
...
Example Response
...
- Status 200 /OK
Successfully updated the user with sysId <sysId>.
...
Description
...
URI
...
HTTP Method
...
GET
...
Description
...
Retrieves information on a specific User.
...
URI Parameters
...
See Read a User: URI Parameters, below.
...
Example URI
...
- http://localhost:8080/uc/resources/user?username=test.user
- http://localhost:8080/uc/resources/user?userid=c489750500d444eca9325559d0ef9673
...
Consumes Content-Type
...
n/a
...
Produces Content-Type
...
application/xml, application/json
...
User Properties
...
See User Properties.
...
User Permission Properties
...
See User Permission Properties.
...
User Role Properties
...
See User Role Properties.
...
Example Response
...
- Status 200 /OK
(See Create, Modify, and Read a User: XML and JSON Examples.) - Status 404 /Not Found
A user with id "f87848b00a0001037f43e7c81c8ec969" does not exist.
Optionally Include Personal Access Tokens on User Payloads: Read User API
The User Read and List API’s optionally allows to display the tokens using the query parameter. The default value is false and user has to pass the parameter to view the token details.
...
Description
...
URI
...
http://host_name/uc/resources/user
...
HTTP Method
...
GET
...
Description
...
List the user tokens
...
Example URI
...
http://localhost:9090/uc/resources/user?username=test&showTokens=true
http://localhost:9090/uc/resources/user?userid=1234567&showTokens=false
...
Authentication
...
HTTP Basic
...
Produces Content-Type
...
Application/XML, Application/JSON
...
Consumes Content-Type
...
Example Responses
...
Status 200
Successful user details
Status 400
Error message.
Status 403
Operation prohibited due to security constraints.
Status 404
A user with name “{name}” does not exist.
A user with id "{uuid}" does not exist.
Status 500
Unexpected request failure. See log(s) for more details.
...
Name
...
Description
...
Specifications
...
Required
...
Mutually Exclusive With
...
userid
...
Unique ID for this User.
...
Y
(unless username
is specified)
...
username
...
username
...
Name used within the Controller to identify this User.
...
Maximum 40 alphanumerics.
...
Y
(unless userid
is specified)
...
userid
...
showTokens
...
Show tokens.
...
Boolean
True - Includes the Token details
False (Default) - Empty Token List
...
Description
...
URI
...
http://host_name/uc/resources/user/token
...
HTTP Method
...
DELETE
...
Description
...
Delete the personal access token(s)
...
Example URI
...
http://localhost:9090/uc/resources/user/token?tokenname=test1&username=abc
http://localhost:9090/uc/resources/user/token?tokenname=test1&userid=1234567
...
Authentication
...
HTTP Basic
...
Produces Content-Type
...
Consumes Content-Type
...
Example Responses
...
Status 200
Personal access token revoked successfully.
Status 400
Error message.
Status 403
Operation prohibited due to security constraints.
Status 404
A user with name “{name}” does not exist.
A user with id "{uuid}" does not exist.
Status 500
Unexpected request failure. See log(s) for more details.
Revoke Personal Access Token: Query Parameters
The following request parameters will be needed for the service.
...
Property
...
UI Field Name
...
Description
...
Specifications
...
Required
...
Mutually Exclusive With
...
userid
...
N/A
...
UUID of the user
...
UUID of the user
...
Y
...
username
...
username
...
N/A
...
User Name
...
String value of User name
...
N
...
userid
...
tokenname
...
token name
...
Token Name
...
Specifies the name of the application that will access the Universal Controller Web Service APIs using the personal access token.
...
Y
...
Property
...
UI Field Name
...
Description
...
Specifications
...
Required
...
Active
...
Specification for whether or not the user is active. An active user can log in to the Controller. An inactive user cannot log in to the Controller, and the user will not appear in user lists.
...
Boolean. Valid Values: true/false. Default is false.
...
N
...
Web Browser Access
...
Specification for whether or not the user can log in to the user interface.
Valid Values:
Default is – System Default – (0).
...
N
...
Business Phone
...
Business phone number of this user.
...
N
...
Command Line Access
...
Specification for whether or not the user can log in to the Universal Controller Command Line Interface (CLI).
Valid values:
Default is – System Default – (0).
...
N
...
Department
...
Business department of this user.
...
N
...
...
Email address of this user.
...
N
...
n/a
For the Modify User web service; specification for whether or not to exclude related records (User Permissions, User Roles) from the update, even if they are provided in the request.
Note | ||
---|---|---|
| ||
In XML, |
...
Valid values: true/false (default is false).
...
N
...
First Name
...
First Name of this user.
...
N
...
Last Name
...
Last Name of this user.
...
N
...
Locked out
...
Specification for whether or not the user is locked out of the Controller.
...
Boolean. Valid Values: true/false. Default is false.
...
N
...
Login Methods
...
Login method(s) that the user can authenticate with.
Valid Values:
...
N
...
Manager
...
Business manager of this user.
...
Manager user ID
...
N
...
Middle Name
...
Middle Name of this user.
...
N
...
Mobile Phone
...
Mobile phone number of this user.
...
N
...
Password Requires Reset
...
Specification for whether or not the user will be prompted to reset the password at next login.
...
Boolean. Valid Values: true/false. Default is false.
...
N
...
n/a
Specification for whether or not the Create a User web service will persist the sysId property.
Note | ||
---|---|---|
| ||
In XML, |
...
Valid values: true/false (default is true).
...
N
...
n/a
...
System ID field in the database for this record.
...
Persisted only if retainSysIds is set to true.
...
N
...
Time Zone
...
Time zone of this user.
...
When this user logs in, all scheduling times will be shown in the user's time zone, unless the trigger specifies a different time zone.
...
N
...
Title
...
Business title of this user.
...
N
...
User ID
...
Log in ID for this user.
...
Y
...
Password
...
Password of this user.
If userPassword
is included in the request, userPassword
will be updated.
...
Used only by the Create a User and Modify a User web services.
...
Y
(for Create
a User)
...
Web Service Access
...
Specification for whether or not the user can log in to the Universal Controller RESTful Web Services API.
Valid values:
Default is – System Default – (0).
...
N
...
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Name | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|
| Unique ID for this User. | Y |
| |
| Name used within the Controller to identify this User. | Maximum 40 alphanumerics. | Y |
|
| Show personal access tokens. | Boolean
| N |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Property | UI Field Name | Description | Specifications | Required | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
active | Active | Specification for whether or not the user is active. An active user can log in to the Controller. An inactive user cannot log in to the Controller, and the user will not appear in user lists. | Boolean. Valid Values: true/false. Default is false. | N | |||||||||||
browserAccess | Web Browser Access | Specification for whether or not the user can log in to the user interface. | Valid Values:
Default is – System Default – (0). | N | |||||||||||
businessPhone | Business Phone | Business phone number of this user. | N | ||||||||||||
commandLineAccess | Command Line Access | Specification for whether or not the user can log in to the Universal Controller Command Line Interface (CLI). | Valid values:
Default is – System Default – (0). | N | |||||||||||
department | Department | Business department of this user. | N | ||||||||||||
email | Email address of this user. | N | |||||||||||||
excludeRelated | n/a | For the Modify User web service; specification for whether or not to exclude related records (User Permissions, User Roles) from the update, even if they are provided in the request.
| Valid values: true/false (default is false). | N | |||||||||||
firstName | First Name | First Name of this user. | N | ||||||||||||
lastName | Last Name | Last Name of this user. | N | ||||||||||||
lockedOut | Locked out | Specification for whether or not the user is locked out of the Controller. | Boolean. Valid Values: true/false. Default is false. | N | |||||||||||
loginMethod | Login Methods | Login method(s) that the user can authenticate with. | Valid Values:
| N | |||||||||||
manager | Manager | Business manager of this user. | Manager user ID | N | |||||||||||
middleName | Middle Name | Middle Name of this user. | N | ||||||||||||
mobilePhone | Mobile Phone | Mobile phone number of this user. | N | ||||||||||||
passwordNeedsReset | Password Requires Reset | Specification for whether or not the user will be prompted to reset the password at next login. | Boolean. Valid Values: true/false. Default is false. | N | |||||||||||
retainSysIds | n/a | Specification for whether or not the Create a User web service will persist the sysId property.
| Valid values: true/false (default is true). | N | |||||||||||
sysId | n/a | System ID field in the database for this record. | Persisted only if retainSysIds is set to true. | N | |||||||||||
timeZone | Time Zone | Time zone of this user. | When this user logs in, all scheduling times will be shown in the user's time zone, unless the trigger specifies a different time zone. | N | |||||||||||
title | Title | Business title of this user. | N | ||||||||||||
tokens | Personal Access Tokens | List of personal access tokens. If Format:
JSON
| N | ||||||||||||
| n/a | Specifies whether the tokens will be displayed in the response. | Boolean. Valid Values: true/false. Default is false. | N | |||||||||||
userName | User ID | Log in ID for this user. | Y | ||||||||||||
userPassword | Password | Password of this user. | Used only by the Create a User and Modify a User web services. | Y | |||||||||||
webServiceAccess | Web Service Access | Specification for whether or not the user can log in to the Universal Controller RESTful Web Services API. | Valid values:
Default is – System Default – (0). | N |
Anchor | ||||
---|---|---|---|---|
|
Property | UI Field Name | Description | Specifications | Required | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
allGroups | Member of Any Business Service or Unassigned | Specification for whether or not this permission applies both to records that belong to any Business Service and to records that do not belong to any Business Service. | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
commands | Commands | Commands that are associated with each permission. | Valid values: see #Command Permissions, below. | N | ||||||||||||||
defaultGroup | Unassigned to Business Service | Specification for whether or not this permission applies to records that do not belong to any Business Service. | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
nameWildcard | Name | Specification to apply this permission to records whose name matches the string specified here. | Wildcards (*'s) can be used. | Y | ||||||||||||||
opCreate | Create | Allows the user to create records of the specified | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
opDelete | Delete | Allows the user to delete records of the specified | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
opExecute | Execute | Allows the user to execute records of the specified | Boolean. Valid Values: true/false. Default is false.
If the Strict Connection Execute Constraints Universal Controller system property is true:
| N | ||||||||||||||
opRead | Read | Allows the user to read records of the specified | Boolean. Valid Values: true/false. Default is false.
| N | ||||||||||||||
opUpdate | Update | Allows the user to update records of the specified | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
opswiseGroups | Member of Business Services | Applies this permission to records that are members of the selected Business Service(s).
| N | |||||||||||||||
permissionType | Type | Type of permission for this user. | Valid values:
| Y | ||||||||||||||
sysId | n/a | System ID field in the database for a record. | Persisted only if retainSysIds is set to true. | N |
Anchor | ||||
---|---|---|---|---|
|
Permission Type | Commands |
---|---|
Agent |
|
Agent Cluster |
|
Application |
|
Bundle |
|
Calendar |
|
Credential | |
Database Connection |
|
Email Connection |
|
Email Template |
|
OMS Server |
|
PeopleSoft Connection |
|
Promotion Target |
|
SAP Connection |
|
Script |
|
SNMP Manager |
|
Task |
|
Task Instance |
|
Trigger |
|
Variable | |
Virtual Resource |
|
Anchor | ||||
---|---|---|---|---|
|
Property | UI Field Name | Description | Specifications | Required | ||||||
---|---|---|---|---|---|---|---|---|---|---|
role | n/a | Role assigned to this user. | N | |||||||
sysId | n/a | System ID field in the database for a record. | N |
Anchor | ||||
---|---|---|---|---|
|
Description | |
---|---|
URI | http://host_name/uc/resources/user/token |
HTTP Method | POST |
Description | Create the personal access token |
Example URI | |
Authentication | HTTP Basic |
Produces Content-Type | text/plain |
Consumes Content-Type | Application/XML, Application/JSON |
Example Responses |
|
Anchor | ||||
---|---|---|---|---|
|
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| N/A | UUID of the user | UUID of the user | N | userName | ||||||
| N/A | User Name | String value of User name | N | userId | ||||||
| Name | Token Name | Specifies the name of the application that will access the Universal Controller Web Service APIs using the personal access token. | Y | |||||||
| Expiration | Description of property. | Specifies when the personal access token expires. If left unspecified, the token never expires. Valid Value: yyyy-mm-dd | N |
Create Personal Access Token: XML and JSON Examples
XML | JSON | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
Description | |
---|---|
URI | http://host_name/uc/resources/user/token/list |
HTTP Method | GET |
Description | List the user tokens |
Example URI | http://localhost:9090/uc/resources/user/token/list http://localhost:9090/uc/resources/user/token/list?username=test http://localhost:9090/uc/resources/user/token/list?userid=1234567 |
Authentication | HTTP Basic |
Produces Content-Type | Application/XML, Application/JSON |
Consumes Content-Type | |
Example Responses |
|
List Personal Access Tokens: Query Parameters
The following request parameters can be used to filter the results of this service.
...
Property | UI Field Name | Description | Specifications | Required | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Anchor | allGroups - PERM | allGroups - PERM | Member of Any Business Service or Unassigned | Specification for whether or not this permission applies both to records that belong to any Business Service and to records that do not belong to any Business Service. | Boolean. Valid Values: true/false. Default is false. | N | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | commands - PERM | commands - PERM | Commands | Commands that are associated with each permission. | Valid values: see #Command Permissions, below. | N | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | defaultGroup - PERM | defaultGroup - PERM | Unassigned to Business Service | Specification for whether or not this permission applies to records that do not belong to any Business Service. | Boolean. Valid Values: true/false. Default is false. | N | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | nameWildcard - PERM | nameWildcard - PERM | Name | Specification to apply this permission to records whose name matches the string specified here. | Wildcards (*'s) can be used. | Y | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | opCreate - PERM | opCreate - PERM | Create | Allows the user to create records of the specified | Boolean. Valid Values: true/false. Default is false. | N | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | opDelete - PERM | opDelete - PERM | Delete | Allows the user to delete records of the specified | Boolean. Valid Values: true/false. Default is false. | N | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | opExecute - PERM | opExecute - PERM | Execute | Allows the user to execute records of the specified | N | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | opRead - PERM | opRead - PERM | Read | Allows the user to read records of the specified | N | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | opUpdate - PERM | opUpdate - PERM | Update | Allows the user to update records of the specified | Boolean. Valid Values: true/false. Default is false. | N | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | opswiseGroups - PERM | opswiseGroups - PERM | Member of Business Services | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Panel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Panel | N | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | permissionType - PERM | permissionType - PERM | Type | Type of permission for this user. | Y | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anchor | sysId - PERM | sysId - PERM | n/a | System ID field in the database for a record. | Persisted only if retainSysIds is set to true. | N |
...
Permission Type
...
Commands
...
Agent
...
- ALL
- resume_agent
- suspend_agent
...
Agent Cluster
...
- ALL
- resolve_agent_cluster
- resume_agent_cluster
- suspend_agent_cluster
- resume_agent_cluster_membership
- suspend_agent_cluster_membership
...
Application
...
- ALL
- appl_start
- appl_stop
- appl_query
...
Bundle
...
- ALL
- promote_bundle
...
Calendar
...
- ALL
- copy_calendar
...
Credential
...
Database Connection
...
- ALL
- copy_database_connection
- database_connection_test
...
Email Connection
...
- ALL
- copy_email_connection
- email_connection_test
...
Email Template
...
- ALL
- copy_email_template
...
OMS Server
...
- ALL
- resume_oms_server
- suspend_oms_server
...
PeopleSoft Connection
...
- ALL
- copy_peoplesoft_connection
...
Promotion Target
...
- ALL
- refresh_target_agents
...
SAP Connection
...
- ALL
- copy_sap_connection
...
Script
...
- ALL
- copy_script
...
SNMP Manager
...
- ALL
- copy_snmp_manager
...
Task
...
- ALL
- copy_task
- launch
- recalculate_forecast
- reset_statistics
- reset_zos_override_statistics
- set_execution_restriction
...
Task Instance
...
- ALL
- cancel
- clear_all_dependencies
- clear_exclusive
- clear_resources
- clear_timewait
- force_finish
- force_finish_cancel
- hold
- insert_task
- rerun
- release
- release_recursive
- retrieve_output
- set_edge_satisfied (Mark as Satisfied in UI)
- set_edges_satisfied (Clear Predecessors in UI)
- set_priority_low
- set_priority_medium
- set_priority_high
- set_manual_completed
- set_manual_started
- skip
- unskip
...
Trigger
...
- ALL
- assign_trigger_execution_user
- copy_trigger
- disable_trigger
- enable_trigger
- recalculate_forecast
- set_skip_count
- trigger_now
...
Variable
...
Virtual Resource
...
- ALL
- copy_virtual_resource
Mutually Exclusive With | |||||
---|---|---|---|---|---|
userid | N/A | UUID of the user | UUID of the user | N | username |
username | N/A | User Name | String value of User name | N | userid |
List Personal Access Tokens: XML and JSON Examples
XML | JSON | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
Description | |
---|---|
URI | http://host_name/uc/resources/user/token |
HTTP Method | DELETE |
Description | Delete the personal access token(s) |
Example URI | http://localhost:9090/uc/resources/user/token?tokenname=test1&username=abc http://localhost:9090/uc/resources/user/token?tokenname=test1&userid=1234567 |
Authentication | HTTP Basic |
Produces Content-Type | |
Consumes Content-Type | |
Example Responses |
|
Revoke Personal Access Token: Query Parameters
The following request parameters will be needed for the service.
Property | UI Field Name | Description | Specifications | Required | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Anchor | role - ROLE | role - ROLE | n/a | Role assigned to this user. | N | ||||||||||||
Anchor | sysId - ROLE | sysId - ROLE | n/a | System ID field in the database for a record. | NMutually Exclusive With | ||||||||||||
userid | N/A | UUID of the user | UUID of the user | Y | username | ||||||||||||
username | N/A | User Name | String value of User name | N | userid | ||||||||||||
tokenname | token name | Token Name | Specifies the name of the application that will access the Universal Controller Web Service APIs using the personal access token. | Y |