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

Remove a Managed Server

delete

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

Removes a managed server from a cluster.

Request

Path Parameters

serverName: Type: string

Required: true

Name of the server.

Query Parameters

force

Type: boolean

Forces the server removal if set to true.

Default Value

false

Response

Supported Media Types

application/json
text/plain

Default Response

successful operation

Examples

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

cURL Command

curl -i -X DELETE -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_server_4

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
Connection: close
Date: Thu, 29 Jan 2015 21:11:01 GMT
Transfer-Encoding: chunked
Location: http://api-host:80/paas/service/soa/api/v1.1/instances/ExampleIdentityDomain/servers/history/job/20
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": "SOACS-SCALING-044: Scaling in Job (ID: 20) server name [ExampleI_server_4] submitted for service [ExampleInstance]",
      "jobId": "20"
   }
}