Updating an Integration Service cluster
The update API uses the PUT method to update an Integration Service cluster. You must provide authentication credentials by using the login API before updating the cluster. For information about the authentication process, see Authentication-for-the-Infrastructure-Management-REST-API.
URL to access the update API
The generic format of a URL for the update API is as follows:
https://<TSPShostname>:<port>/tsws/10.0/api/unifiedadmin/IntegrationServiceCluster/
<identifier1>,<identifier2>,...<identifierN>/update?&idType=<IDType>
Entry | Description |
|---|---|
https|http | Type of protocol to send the request. TrueSight Presentation Server supports HTTPS protocol by default. You can use HTTP protocol as well. |
serverHost | Host name of the Presentation Server. |
port | Port number through which communication is established. By default, the HTTPS protocol is supported and the default port number is 443. If you use HTTP protocol, use the port number 80. |
identifier1, identifier2,...identifierN | Identifiers of the Integration Service clusters. The supported identifier types are:
You can provide multiple identifiers, separated by commas. |
idType | Specifies the identifier type for the Integration Service cluster that the web service request uses. The supported type of resource identifiers are as follows:
The default value is name. |
Input parameters in the JSON format to update a Integration Service cluster
You can provide the following parameters in the JSON format along with the URL.
When you provide input parameters for any web service request, you must specify the content-type parameter in the header of the web service request as follows:
The sample input parameters in the JSON format are as follows:
"integrationServiceCluster": {
"integrationServices": [
{
"host":"IS01",
"port":"3183"
},
{
"host":"IS2",
"port":"3183"
},
{
"host":"Test.adb.cxv.sdf.asd.fdf.asd.adf",
"port":"3183"
}
],
"name":"Clluster01-Modified",
"overwriteIS":"true",
"description": "This is sample Cluster 01"
}
}
Attributes | Description |
|---|---|
integrationServices | List of Integration Services that you want to update |
action | Specifies the type of update that you want to perform. The supported actions are:
|
host | Name of the Integration Service that is part of the cluster |
name | Name of the Integration Service cluster that you want to update |
description | Description of the Integration Service cluster |
port | Port number through which communication is established |
Response information for the update API
A sample JSON response is as follows:
"responseTimeStamp":"2016-05-18T23:06:10",
"statusCode": "200",
"statusMsg": "OK",
"response": [
{
"resourceId":"c7714477-863c-49a6-8aa2-fc2443788c30",
"resourceName":"Clluster01-Modified",
"resourceURI":null,
"statusCode":"200",
"statusMsg":"OK"
}
]
}