REST API for Oracle SOA Cloud Service on Oracle Public Cloud Machine

Add a Managed Server

post

/api/v1.1/instances/{identityId}/{serviceId}/servers/{clusterName}

Adds a new managed server to the specified cluster. Scales the service by factor of one node.

Request

Path Parameters

clusterName: Type: string

Required: true

Name of the cluster.

Query Parameters

createClusterIfMissing: Type: boolean

If set to true, creates a cluster with the specified name if it does not exist.

Response

Supported Media Types

application/json
text/plain

Default Response

successful operation

Examples

The following example shows how to scale out by one node an Oracle SOA Cloud Service instance by submitting a POST request on the REST resource using cURL. For more information, see Use cURL.

cURL Command

curl -i -X POST -u joe@example.com:Welcome1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://api-host/paas/service/soa/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance/servers/ExampleI_cluster

Note:: This example uses the URL prefix for the United States ( soacs). For information about the URL prefixes for other regions of the world, see Send Requests.

Example of Response Header

The following shows an example of the response header:

HTTP/1.1 202 Accepted
Date: Thu, 29 Jan 2015 21:20:52 GMT
Transfer-Encoding: chunked
Location: https://api-host/paas/service/soa/api/v1.1/instances/ExampleIdentityDomain/servers/history/job/17
Content-Type: application/json

Example of Response Body

The following shows an example of the response document returned in JSON format.

{
   "status": "New",
   "details": {
      "message": "JASS-SCALING-037: Scale out Job (ID: 17) for service [ExampleInstance] in cluster [ExampleI_cluster] submitted",
      "jobId": "17"
   }
}