Retrieve a Connection

get

/icsapis/v2/connections/{id}

Retrieves a connection. The response includes only the data visible in the ICS console.

Request

Supported Media Types
Path Parameters

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

404 Response

Connection not found

500 Response

Server error

Examples

The following example shows how to get details about a connection by submitting a GET 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 GET -u jstein:welcome1 -H "Accept:application/json" \
https://integration.us.oraclecloud.com/icsapis/v2/connections/ACME_WEATHER_CONNECTION

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
    "links": {
        "@rel": "self",
        "@href": "https://integration.us.oraclecloud.com/icsapis/v2/connections/ACME_WEATHER_CONNECTION"
    },
    "connectionProperties": [
        {
            "displayName": "WSDL URL",
            "hasAttachment": "false",
            "hidden": "false",
            "length": "0",
            "propertyGroup": "CONNECTION_PROPS",
            "propertyName": "targetWSDLURL",
            "propertyType": "URL_OR_FILE",
            "required": "true"
        },
        {
            "displayName": "Target Server's TLS version (Optional)",
            "hasAttachment": "false",
            "hidden": "false",
            "length": "0",
            "propertyDescription": "Target server's TLS protocol version. Default is TLSv1.1. Possible values TLSv1, TLSv1.1, TLSv1.2",
            "propertyGroup": "CONNECTION_PROPS",
            "propertyName": "tlsVersion",
            "propertyShortDesc": "Target server's Transport Layer Security (TLS) protocol version. Default is TLSv1.1",
            "propertyType": "CHOICE",
            "required": "false"
        },
        {
            "displayName": "Suppress insertion of timestamp into the request (Optional)",
            "hasAttachment": "false",
            "hidden": "false",
            "length": "0",
            "propertyDescription": "In secure Web Services transactions, a WS-Utility (WSU) Timestamp can be inserted into a WS-Security Header \nto define the lifetime of the message in which it is placed. \n\n  If \"Yes\" is selected, no timestamp will be added to WS-Security \n header sent as part of the outbound request. For inbound requests with Basic Auth security policy, no timestamp is required to be sent by the client.",
            "propertyGroup": "CONNECTION_PROPS",
            "propertyName": "suppressTimestampForRequest",
            "propertyShortDesc": "If \"Yes\" is selected, no timestamp will be added to WS-Security header sent as part of the outbound request. For inbound requests with Basic Auth security policy, no timestamp is required.",
            "propertyType": "CHOICE",
            "required": "false"
        },
        {
            "displayName": "Ignore timestamp in the response message (Optional)",
            "hasAttachment": "false",
            "hidden": "false",
            "length": "0",
            "propertyDescription": "Property used by the client to ignore the timestamp \n in the SOAP security header when it receives the response from the service. \n If \"Yes\", then the timestamp is not required in the response \n message; if the timestamp is present, it is ignored.",
            "propertyGroup": "CONNECTION_PROPS",
            "propertyName": "ignoreTimestampInResponse",
            "propertyShortDesc": "If \"Yes\", then the timestamp is not required in the response message",
            "propertyType": "CHOICE",
            "required": "false"
        }
    ],
    "adaptertype": {
        "appTypeConnProperties": [
            {
                "displayName": "WSDL URL",
                "hasAttachment": "false",
                "hidden": "false",
                "length": "0",
                "propertyGroup": "CONNECTION_PROPS",
                "propertyName": "targetWSDLURL",
                "propertyType": "URL_OR_FILE",
                "required": "true"
            },
            {
                "displayName": "Target Server's TLS version (Optional)",
                "hasAttachment": "false",
                "hidden": "false",
                "length": "0",
                "propertyDescription": "Target server's TLS protocol version. Default is TLSv1.1. Possible values TLSv1, TLSv1.1, TLSv1.2",
                "propertyGroup": "CONNECTION_PROPS",
                "propertyName": "tlsVersion",
                "propertyShortDesc": "Target server's Transport Layer Security (TLS) protocol version. Default is TLSv1.1",
                "propertyType": "CHOICE",
                "required": "false"
            },
            {
                "displayName": "Suppress insertion of timestamp into the request (Optional)",
                "hasAttachment": "false",
                "hidden": "false",
                "length": "0",
                "propertyDescription": "In secure Web Services transactions, a WS-Utility (WSU) Timestamp can be inserted into a WS-Security Header \nto define the lifetime of the message in which it is placed. \n\n  If \"Yes\" is selected, no timestamp will be added to WS-Security \n header sent as part of the outbound request. For inbound requests with Basic Auth security policy, no timestamp is required to be sent by the client.",
                "propertyGroup": "CONNECTION_PROPS",
                "propertyName": "suppressTimestampForRequest",
                "propertyShortDesc": "If \"Yes\" is selected, no timestamp will be added to WS-Security header sent as part of the outbound request. For inbound requests with Basic Auth security policy, no timestamp is required.",
                "propertyType": "CHOICE",
                "required": "false"
            },
            {
                "displayName": "Ignore timestamp in the response message (Optional)",
                "hasAttachment": "false",
                "hidden": "false",
                "length": "0",
                "propertyDescription": "Property used by the client to ignore the timestamp \n in the SOAP security header when it receives the response from the service. \n If \"Yes\", then the timestamp is not required in the response \n message; if the timestamp is present, it is ignored.",
                "propertyGroup": "CONNECTION_PROPS",
                "propertyName": "ignoreTimestampInResponse",
                "propertyShortDesc": "If \"Yes\", then the timestamp is not required in the response message",
                "propertyType": "CHOICE",
                "required": "false"
            }
        ],
        "appTypeCredProperties": [
            {
                "displayName": "Username",
                "hasAttachment": "false",
                "hidden": "false",
                "length": "0",
                "propertyDescription": "A username credential",
                "propertyGroup": "CREDENTIALS",
                "propertyName": "username",
                "propertyType": "STRING",
                "required": "true"
            },
            {
                "displayName": "Password",
                "hasAttachment": "false",
                "hidden": "false",
                "length": "0",
                "propertyDescription": "A password credential",
                "propertyGroup": "CREDENTIALS",
                "propertyName": "password",
                "propertyType": "PASSWORD",
                "required": "true"
            }
        ],
        "appTypeLargeIconUrl": "/images/soap/wssoap_92.png",
        "appTypeMediumGrayIconUrl": "/images/soap/wssoap_g_46.png",
        "appTypeMediumIconUrl": "/images/soap/wssoap_46.png",
        "appTypeMediumWhiteIconUrl": "/images/soap/wssoap_w_46.png",
        "appTypeName": "soap",
        "appTypeSmallIconUrl": "/images/soap/wssoap_32.png",
        "displayName": "SOAP",
        "features": "jcaTransportEnabled",
        "source": "PREINSTALLED",
        "supportedSecurityPolicies": "Basic Authentication, Username Password Token, No Security Policy",
        "usage": "0",
        "vedorInfo": {
            "name": "Oracle Corporation",
            "description": "https://www.oracle.com/about",
            "contactUS": "http://www.oracle.com/us/corporate/contact/index.html",
            "supportURL": "http://otn.oracle.com",
            "documentationURL": "https://docs.oracle.com/cloud/latest/intcs_gs/index.html",
            "releaseNotes": ""
        }
    },
    "code": "ACME_WEATHER_CONNECTION",
    "imageURL": "/images/soap/wssoap_w_46.png",
    "name": "Acme Weather Connection",
    "percentageComplete": "100",
    "securityPolicy": "NONE",
    "status": "CONFIGURED",
    "supportsCache": "true"
}