The TrueSight Web Service (TSWS) login
API uses the POST method to return an authToken value in the JSON response. The authToken provides the credentials and permissions of the user performing the operations and must be specified to authenticate all subsequent TSWS API requests.
The authToken also contains an expiration date for using it.
API | Description |
---|---|
login | Obtains the authToken required to perform all other operations |
configdata | Retrieves configuration data of monitor instances |
perfdata | Retrieves performance data of monitor instances |
API | Description |
---|---|
devices | Retrieves a list of monitored devices |
instances | Retrieves a list of monitored instances |
monitortypes | Retrieves a list of monitor types |
tenants | Retrieves a list of tenants |
https://<PresentationServerHostName>/tsws/10.0/api/authenticate/login
Element | Description |
---|---|
username | User name performing the operation |
password | Password to authenticate the user |
tenantName | Tenant name as it appears in the Presentation Server Example: BmcRealm |
The request parameters in JSON format:
{ "username": "<user name>", "password": "<password>", "tenantName": "<tenant name>" }
The JSON response includes an authToken if the authentication is successful. You must use this authToken value for subsequent requests.
Object | Description |
---|---|
authToken | Value that you specify in subsequent TrueSight Web Services operations. |
authPassed | Value returned by the API. This can be either true or false. True indicates a successful operation and false indicates a failed operation. |
expires | Same as the responseTimeStamp. To perform a TrueSight Web Services operation after this date, you must perform this operation again |
status | Status returned by the API. For example, if the status code is 200, the status returned is OK. |
{ "responseTimeStamp": "2015-07-21T06:23:51", "statusCode": "200", "statusMsg": "OK", "response": { "authToken": "AQIC5wM2LY4Sfczv3QuPxC851ZfQ-.*", "authPassed": true, "expires": "2015-07-21T06:23:51", "status": "OK" } }
1 Comment
Patrick Mischler
On TSIM you can also get the metadata. Would be great if this would also be possible on TSPS