Update a Connection

post

/icsapis/v2/connections/{id}

Updates the security properties, connection properties, agentGroupId, or securityPolicy of a connection. Other properties are ignored. Supported security properties depend on the selected securityPolicy and the connection type. The connection type also determines the supported securityPolicy values.

Request

Supported Media Types
Path Parameters
Header Parameters
Body ()
Root Schema : connection
Type: object
Show Source
Nested Schema : adapterbase
Type: object
Show Source
Nested Schema : connectionProperties
Type: array
Show Source
Nested Schema : securityProperties
Type: array
Show Source
Nested Schema : connectionproperty
Type: object
Show Source

Response

Supported Media Types

200 Response

Successful operation
Body ()
Root Schema : connection
Type: object
Show Source
Nested Schema : adapterbase
Type: object
Show Source
Nested Schema : connectionProperties
Type: array
Show Source
Nested Schema : securityProperties
Type: array
Show Source
Nested Schema : connectionproperty
Type: object
Show Source

400 Response

Missing header information

404 Response

Connection not found

423 Response

Connection is locked

500 Response

Server error

Examples

The following example shows how to update a connection by submitting a POST/PATCH request on the REST resource using cURL. For more information about cURL, see Use cURL. For more information about endpoint URL structure, see Send Requests.

curl -X POST -u jstein:welcome1 -H "X-HTTP-Method-Override:PATCH" \
-H "Content-Type:application/json" -d @connprop.json \
https://integration.us.oraclecloud.com/icsapis/v2/connections/ACME_WEATHER_CONNECTION

Example of Request Body

The following example shows the contents of a request body in JSON format. This is the contents of the connprop.json file listed in the cURL command. The request body only needs to include the properties you want to change. For the complete format, see the example response body for Retrieve a Connection.

{ 
   "connectionProperties": { 
      "propertyGroup": "CONNECTION_PROPS",     
      "propertyName": "targetWSDLURL",   
      "propertyType": "WSDL_URL",  
      "propertyValue": "http://example.com/WeatherWS/Weather.asmx?WSDL" 
   }, 
   "securityPolicy": "BASIC_AUTH", 
   "securityproperties":  [{ 
      "propertyGroup": "CREDENTIALS",     
      "propertyName": "username",   
      "propertyValue": "abcd7"
   }, 
   {
      "propertyGroup": "CREDENTIALS",     
      "propertyName": "password", 
      "propertyValue": "abc222" 
   }]  
}