Creating a Integration Service cluster


The create API uses the POST method to create a Integration Service cluster. You must provide authentication credentials by using the login API before creating the cluster. For information about the authentication process, see Web-services-authentication.

URL to access the create API

The generic format of a URL for the create API is as follows:

http|https://<serverHost>:<port>/bppmws/api/unifiedadmin/
IntegrationServiceCluster/create

Example

http://bppmwsserver:80/bppmws/api/unifiedadmin/
IntegrationServiceCluster/create

Input parameters in the JSON format to create 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:

content-type application/json

The sample input parameters in the JSON format are as follows:

{
   "integrationServiceCluster": {
       "bppmserver": {
           "name": "bppm-1234",
           "id": "id1"
       },
       "integrationServices": [
           {
               "host": "bppmIS",
               "port": "1234"
           },
           {
               "host": "bppmIS1",
               "port": "1235"
           },
           {
               "host": "bppmIS2",
               "port": "1234"
           },
           {
               "host": "bppmIS3",
               "port": "1235"
           }
        ],
       "name": "bppmIScluster",
       "description": "New cluster"
   }
}

Attributes

Description

bppmserver

Details of the BMC TrueSight Infrastructure Management Server on which you plan to configure the Integration Service cluster. You can either provide the name of the server or the identifier for the BMC TrueSight Infrastructure Management Server. 

This parameter is mandatory.

name

Name of the BMC TrueSight Infrastructure Management Server

id

Identifier of the BMC TrueSight Infrastructure Management Server

integrationServices

List of Integration Services that are part of the cluster. This parameter is mandatory.

host

Name of the Integration Service. This parameter is mandatory.

port

Port number through which communication is established. This parameter is mandatory.

name

Name of the Integration Service cluster that you create. This parameter is mandatory.

description

Brief description about the Integration Service cluster

Response information for the create API

A sample JSON response is as follows:

{
   "response": [
       {
           "resourceName": "bppmIScluster",
           "statusCode": "200",
           "statusMsg": "OK",
           "resourceId": "700"
       }
    ],
   "statusCode": "200",
   "statusMsg": "OK",
   "responseTimeStamp": "2012-06-20T08:36:24",
}

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*