1. REST API for Oracle Internet of Things Cloud Service
  2. Tasks
  3. IoT Application Integration

Update Integration, specified by ID

post

/iot/api/v2/apps/{app-id}/integrations/{integration-id}

Update Integration details with provided partial or complete Integration definition. Integration is identified by the given id.

Request

Supported Media Types
Path Parameters
Header Parameters
Body ()
Root Schema : schema
Match All
Show Source
  • Enterprise_Integration
    An enterprise integration is a generic integration that can be used to POST data to an external application/cloud service. Note that we now optionally support adding custom static HTTP headers as part of the integration configuration. ENTERPRISE Integrations can be used for bi-directional data/information flow between an IoT Application and the external applications. To establish inbound channel Integration's endpoint id and shared secret are used by an application to authenticate in the IoT Cloud Service and to get authorization to access the IoT REST APIs. Outbound connection is implemented through the Integration's message dispatching mechanism. If a message's sender belongs to an IoT Application and format field in payload refers to a format, registered on one of the DeviceModels that the Application supports, the message will be mapped to the IoT Application. If the Enterprise Integration under the Application is interested in the format of the message, wihch is indicated in the format list of its streams, the message will be dispatched to the URL of the integration.
  • BICS_Integration
    A BICS integration is an integration that can be used to forward message data to Oracle's Business Intelligence Cloud Service. BICS Integrations can be used to turn message streams into table data transmitted to and consumed by the BI Cloud Service.
  • JDE_Integration
    A JD Edwards (JDE) integration targets a particular IoT Orchestration that is exposed by a relevant JDE instance.
  • MCS_Integration
    A Mobile Cloud Service (MCS) integration targets REST endpoints available on an MCS Mobile Backend.
  • OSCS_Integration
    The OSCS integration is an integration that can be used to forward message data to Oracle Storage Cloud Service (OSCS). OSCS Integrations can be used to communication with any product based on OSCS.
  • OIC_Integration
    The Oracle Integration Cloud integration is an integration that can be used to forward message data to an Oracle Integration Cloud (OIC) instance.
  • OAC_Integration
    The Oracle Analytics Cloud integration is an integration that can be used to forward message data to an Oracle Analytics Cloud (OAC) instance. OAC Integrations can be used to turn message streams into table data transmitted to and consumed by an OAC instance.
Nested Schema : Enterprise_Integration
Type: object
An enterprise integration is a generic integration that can be used to POST data to an external application/cloud service. Note that we now optionally support adding custom static HTTP headers as part of the integration configuration. ENTERPRISE Integrations can be used for bi-directional data/information flow between an IoT Application and the external applications. To establish inbound channel Integration's endpoint id and shared secret are used by an application to authenticate in the IoT Cloud Service and to get authorization to access the IoT REST APIs. Outbound connection is implemented through the Integration's message dispatching mechanism. If a message's sender belongs to an IoT Application and format field in payload refers to a format, registered on one of the DeviceModels that the Application supports, the message will be mapped to the IoT Application. If the Enterprise Integration under the Application is interested in the format of the message, wihch is indicated in the format list of its streams, the message will be dispatched to the URL of the integration.
Show Source
  • authConfig
    Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
  • Type of authentication for outbound connections. IoT Cloud Service supports only BASIC authentication.
  • config
    Integration-level configuration. Two types of values are supported: String and Map. For ENTERPRISE Integration there is only one mandatory entry for config: url. httpHeaders is a reserved config entry for specifying an HTTP headers Map (key as a header name, value as the header value) for outbound connection requests. This field is mandatory.
  • Integration description
  • Integration name. NOTE: When name is omitted or a supplied as a zero-length string the implementation generates a default name automatically.
  • Shared secret. Is specified for inbound connections only and is used by external applications to authenticate in the IoT Cloud Service and to get authorization to access the IoT REST APIs. The value should be base64 encoded.
  • The flag specifying whether the Integration messages should be persisted
  • streams
    The list of Integration Streams. This field is mandatory.
  • ENTERPRISE. This field is mandatory.
Nested Schema : BICS_Integration
Type: object
A BICS integration is an integration that can be used to forward message data to Oracle's Business Intelligence Cloud Service. BICS Integrations can be used to turn message streams into table data transmitted to and consumed by the BI Cloud Service.
Show Source
  • authConfig
    Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
  • Type of authentication for outbound connections. IoT Cloud Service supports only BASIC authentication.
  • config
    Integration-level configuration. Two types of values are supported: String and Map. For BICS Integration there are two mandatory entries for config: url and identityDomain. This field is mandatory.
  • Integration description
  • Integration name. NOTE: When name is omitted or a supplied as a zero-length string the implementation generates a default name automatically.
  • streams
    The list of Integration Streams. This field is mandatory.
  • BICS. This field is mandatory.
Nested Schema : JDE_Integration
Type: object
A JD Edwards (JDE) integration targets a particular IoT Orchestration that is exposed by a relevant JDE instance.
Show Source
Nested Schema : MCS_Integration
Type: object
A Mobile Cloud Service (MCS) integration targets REST endpoints available on an MCS Mobile Backend.
Show Source
Nested Schema : OSCS_Integration
Type: object
The OSCS integration is an integration that can be used to forward message data to Oracle Storage Cloud Service (OSCS). OSCS Integrations can be used to communication with any product based on OSCS.
Show Source
Nested Schema : OIC_Integration
Type: object
The Oracle Integration Cloud integration is an integration that can be used to forward message data to an Oracle Integration Cloud (OIC) instance.
Show Source
  • authConfig
    Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
  • Type of authentication for outbound connections. IoT Cloud Service supports BASIC authentication.
  • config
    Integration-level configuration. This field is mandatory.
  • Integration description
  • Integration name. NOTE: When name is omitted or a supplied as a zero-length string the implementation generates a default name automatically.
  • streams
    The list of Integration Streams. This field is mandatory.
  • ICS. This field is mandatory. Note: For historical reasons, the predecessor to OIC, which is ICS, will be used for type.
Nested Schema : OAC_Integration
Type: object
The Oracle Analytics Cloud integration is an integration that can be used to forward message data to an Oracle Analytics Cloud (OAC) instance. OAC Integrations can be used to turn message streams into table data transmitted to and consumed by an OAC instance.
Show Source
  • authConfig
    Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
  • BASIC. This field is mandatory.
  • config
    Integration-level configuration. This field is mandatory.
  • Integration description
  • Integration name. NOTE: When name is omitted or a supplied as a zero-length string the implementation generates a default name automatically.
  • streams
    The list of Integration Streams. This field is mandatory.
  • OACS. This field is mandatory. Note: For historical reasons, the predecessor to OAC, which is OACS, will be used for type.
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. Two types of values are supported: String and Map. For ENTERPRISE Integration there is only one mandatory entry for config: url. httpHeaders is a reserved config entry for specifying an HTTP headers Map (key as a header name, value as the header value) for outbound connection requests. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : Enterprise_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • formats
    List of Message Formats the Stream is associated with. At least one Format is required for an ENTERPRISE Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : formats
Type: array
List of Message Formats the Stream is associated with. At least one Format is required for an ENTERPRISE Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. Two types of values are supported: String and Map. For BICS Integration there are two mandatory entries for config: url and identityDomain. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : BICS_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Additional stream options list. Only tableName is supported at this moment, which means the table name on BICS cloud server side. Note that the table name value should be within 30 characters.
  • formats
    The Message Format the Stream is associated with. One and only one Format is required for a BICS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Additional stream options list. Only tableName is supported at this moment, which means the table name on BICS cloud server side. Note that the table name value should be within 30 characters.
Nested Schema : formats
Type: array
The Message Format the Stream is associated with. One and only one Format is required for a BICS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : authConfig
Type: object
Authentication information for the JDE instance. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded. This filed is mandatory.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
  • fields
    This is a required item when JDE_STANDARD message type is specified. This Map entry specifies the input data types for the each of the orchestration fields. The entries may be specified in the payload as follows: "fields": { "orchestration_field": "field_type" }
  • Orchestration's supported message format (supported types: IOT_STANDARD (default) or JDE_STANDARD
  • The target JDE IoT Orchestration. This field is mandatory
  • The JDE instance URL. This field is mandatory
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : fields
Type: object
This is a required item when JDE_STANDARD message type is specified. This Map entry specifies the input data types for the each of the orchestration fields. The entries may be specified in the payload as follows: "fields": { "orchestration_field": "field_type" }
Nested Schema : JDE_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Stream level configuration. This is only required if messageType is set to JDE_STANDARD
  • formats
    The Message Format associated with the Stream. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Stream level configuration. This is only required if messageType is set to JDE_STANDARD
Show Source
Nested Schema : formats
Type: array
The Message Format associated with the Stream. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : mapping
Type: object
This Map stores the association between the fields of the message format or an annotation to that of an orchestration's field
Nested Schema : authConfig
Type: object
Authentication information for the MCS instance. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : httpHeaders
Type: object
A key-value map. Must contain a value for Oracle-Mobile-BACKEND-ID. This field is mandatory.
Nested Schema : MCS_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • formats
    List of Message Formats the Stream is associated with. At least one Format is required for MCS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : formats
Type: array
List of Message Formats the Stream is associated with. At least one Format is required for MCS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for OAUTH2 authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : OSCS_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Additional stream options list. Only objectName is supported at this moment, which means name of object on OSCS cloud server side. Note that the value of object name should be within 30 characters.
  • formats
    The Message Format associated with the Stream. One and only one Format is required for an OSCS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Additional stream options list. Only objectName is supported at this moment, which means name of object on OSCS cloud server side. Note that the value of object name should be within 30 characters.
Show Source
Nested Schema : formats
Type: array
The Message Format associated with the Stream. One and only one Format is required for an OSCS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : mapping
Type: object
This Map stores the association between the fields of the message format or an annotation to that of an orchestration's field
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : OIC_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Additional stream options list. Only resourceUri is currently supported.
  • formats
    The Message Format associated with the Stream. Only one Format is required for an OIC Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Additional stream options list. Only resourceUri is currently supported.
Show Source
Nested Schema : formats
Type: array
The Message Format associated with the Stream. Only one Format is required for an OIC Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : resourceUri
Type: object
A relative URL value of the form INTEGRATION_NAME/VERSION_STRING/RESOURCE_URL relative to config url
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : OAC_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Additional stream options list. Only tableName is supported at this moment, which means the table name on OAC cloud server side. Note that the table name value should be within 30 characters.
  • formats
    The Message Format the Stream is associated with. One and only one Format is required for a OAC Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Additional stream options list. Only tableName is supported at this moment, which means the table name on OAC cloud server side. Note that the table name value should be within 30 characters.
Nested Schema : formats
Type: array
The Message Format the Stream is associated with. One and only one Format is required for a OAC Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Back to Top

Response

Supported Media Types

200 Response

Successfully processed
Body ()
Root Schema : schema
Match All
Show Source
  • Enterprise_Integration_receive
    An enterprise integration is a generic integration that can be used to POST data to an external application/cloud service. Note that we now optionally support adding custom static HTTP headers as part of the integration configuration. ENTERPRISE Integrations can be used for bi-directional data/information flow between an IoT Application and the external applications. To establish inbound channel Integration's endpoint id and shared secret are used by an application to authenticate in the IoT Cloud Service and to get authorization to access the IoT REST APIs. Outbound connection is implemented through the Integration's message dispatching mechanism. If a message's sender belongs to an IoT Application and format field in payload refers to a format, registered on one of the DeviceModels that the Application supports, the message will be mapped to the IoT Application. If the Enterprise Integration under the Application is interested in the format of the message, wihch is indicated in the format list of its streams, the message will be dispatched to the URL of the integration.
  • BICS_Integration_receive
    A BICS integration is an integration that can be used to forward message data to Oracle's Business Intelligence Cloud Service. BICS Integrations can be used to turn message streams into table data transmitted to and consumed by the BI Cloud Service.
  • JDE_Integration_receive
    A JD Edwards (JDE) integration targets a particular IoT Orchestration that is exposed by a relevant JDE instance.
  • MCS_Integration_receive
    A Mobile Cloud Service (MCS) integration targets REST endpoints available on an MCS Mobile Backend.
  • OSCS_Integration_receive
    The OSCS integration is an integration that can be used to forward message data to Oracle Storage Cloud Service (OSCS). OSCS Integrations can be used to communication with any product based on OSCS.
  • OIC_Integration_receive
    The Oracle Integration Cloud integration is an integration that can be used to forward message data to an Oracle Integration Cloud (OIC) instance.
  • OAC_Integration_receive
    The Oracle Analytics Cloud integration is an integration that can be used to forward message data to an Oracle Analytics Cloud (OAC) instance.
Nested Schema : Enterprise_Integration_receive
Type: object
An enterprise integration is a generic integration that can be used to POST data to an external application/cloud service. Note that we now optionally support adding custom static HTTP headers as part of the integration configuration. ENTERPRISE Integrations can be used for bi-directional data/information flow between an IoT Application and the external applications. To establish inbound channel Integration's endpoint id and shared secret are used by an application to authenticate in the IoT Cloud Service and to get authorization to access the IoT REST APIs. Outbound connection is implemented through the Integration's message dispatching mechanism. If a message's sender belongs to an IoT Application and format field in payload refers to a format, registered on one of the DeviceModels that the Application supports, the message will be mapped to the IoT Application. If the Enterprise Integration under the Application is interested in the format of the message, wihch is indicated in the format list of its streams, the message will be dispatched to the URL of the integration.
Show Source
  • authConfig
    Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
  • Type of authentication for outbound connections. IoT Cloud Service supports only BASIC authentication.
  • config
    Integration-level configuration. Two types of values are supported: String and Map. For ENTERPRISE Integration there is only one mandatory entry for config: url. httpHeaders is a reserved config entry for specifying an HTTP headers Map (key as a header name, value as the header value) for outbound connection requests. This field is mandatory.
  • The time when the Integration is created as a long value corresponding to epoch time in milliseconds.
  • The time when the Integration is created as a string.
  • Integration description
  • ID of the Integration
  • links
  • Integration name. NOTE: When name is omitted or a supplied as a zero-length string the implementation generates a default name automatically.
  • Shared secret. Is specified for inbound connections only and is used by external applications to authenticate in the IoT Cloud Service and to get authorization to access the IoT REST APIs. The value should be base64 encoded.
  • State of the Integration. Valid values are [].
  • The flag specifying whether the Integration messages should be persisted
  • streams
    The list of Integration Streams. This field is mandatory.
  • ENTERPRISE. This field is mandatory.
Nested Schema : BICS_Integration_receive
Type: object
A BICS integration is an integration that can be used to forward message data to Oracle's Business Intelligence Cloud Service. BICS Integrations can be used to turn message streams into table data transmitted to and consumed by the BI Cloud Service.
Show Source
  • authConfig
    Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
  • Type of authentication for outbound connections. IoT Cloud Service supports only BASIC authentication.
  • config
    Integration-level configuration. Two types of values are supported: String and Map. For BICS Integration there is only one mandatory entry for config: url. This field is mandatory.
  • The time when the Integration is created as a long value corresponding to epoch time in milliseconds.
  • The time when the Integration is created as a string.
  • Integration description
  • ID of the Integration
  • links
  • Integration name. NOTE: When name is omitted or a supplied as a zero-length string the implementation generates a default name automatically.
  • State of the Integration. Valid values are [].
  • streams
    The list of Integration Streams. This field is mandatory.
  • BICS. This field is mandatory.
Nested Schema : JDE_Integration_receive
Type: object
A JD Edwards (JDE) integration targets a particular IoT Orchestration that is exposed by a relevant JDE instance.
Show Source
Nested Schema : MCS_Integration_receive
Type: object
A Mobile Cloud Service (MCS) integration targets REST endpoints available on an MCS Mobile Backend.
Show Source
Nested Schema : OSCS_Integration_receive
Type: object
The OSCS integration is an integration that can be used to forward message data to Oracle Storage Cloud Service (OSCS). OSCS Integrations can be used to communication with any product based on OSCS.
Show Source
Nested Schema : OIC_Integration_receive
Type: object
The Oracle Integration Cloud integration is an integration that can be used to forward message data to an Oracle Integration Cloud (OIC) instance.
Show Source
Nested Schema : OAC_Integration_receive
Type: object
The Oracle Analytics Cloud integration is an integration that can be used to forward message data to an Oracle Analytics Cloud (OAC) instance.
Show Source
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. Two types of values are supported: String and Map. For ENTERPRISE Integration there is only one mandatory entry for config: url. httpHeaders is a reserved config entry for specifying an HTTP headers Map (key as a header name, value as the header value) for outbound connection requests. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : Enterprise_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • formats
    List of Message Formats the Stream is associated with. At least one Format is required for an ENTERPRISE Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : formats
Type: array
List of Message Formats the Stream is associated with. At least one Format is required for an ENTERPRISE Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. Two types of values are supported: String and Map. For BICS Integration there is only one mandatory entry for config: url. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : BICS_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Additional stream options list. Only tableName is supported at this moment, which means the table name on BICS cloud server side. Note that the table name value should be within 30 characters.
  • formats
    The Message Format the Stream is associated with. One and only one Format is required for a BICS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Additional stream options list. Only tableName is supported at this moment, which means the table name on BICS cloud server side. Note that the table name value should be within 30 characters.
Nested Schema : formats
Type: array
The Message Format the Stream is associated with. One and only one Format is required for a BICS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : authConfig
Type: object
Authentication information for the JDE instance. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded. This filed is mandatory.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
  • fields
    This is a required item when JDE_STANDARD message type is specified. This Map entry specifies the input data types for the each of the orchestration fields. The entries may be specified in the payload as follows: "fields": { "orchestration_field": "field_type" }
  • Orchestration's supported message format (supported types: IOT_STANDARD (default) or JDE_STANDARD
  • The target JDE IoT Orchestration. This field is mandatory
  • The JDE instance URL. This field is mandatory
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : fields
Type: object
This is a required item when JDE_STANDARD message type is specified. This Map entry specifies the input data types for the each of the orchestration fields. The entries may be specified in the payload as follows: "fields": { "orchestration_field": "field_type" }
Nested Schema : JDE_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Stream level configuration. This is only required if messageType is set to JDE_STANDARD
  • formats
    The Message Format associated with the Stream. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Stream level configuration. This is only required if messageType is set to JDE_STANDARD
Show Source
Nested Schema : formats
Type: array
The Message Format associated with the Stream. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : mapping
Type: object
This Map stores the association between the fields of the message format or an annotation to that of an orchestration's field
Nested Schema : authConfig
Type: object
Authentication information for the MCS instance. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : httpHeaders
Type: object
A key-value map. Must contain a value for Oracle-Mobile-BACKEND-ID. This field is mandatory.
Nested Schema : MCS_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • formats
    List of Message Formats the Stream is associated with. At least one Format is required for MCS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : formats
Type: array
List of Message Formats the Stream is associated with. At least one Format is required for MCS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for OAUTH2 authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : OSCS_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Additional stream options list. Only objectName is supported at this moment, which means name of object on OSCS cloud server side. Note that the value of object name should be within 30 characters.
  • formats
    The Message Format associated with the Stream. One and only one Format is required for an OSCS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Additional stream options list. Only objectName is supported at this moment, which means name of object on OSCS cloud server side. Note that the value of object name should be within 30 characters.
Show Source
Nested Schema : formats
Type: array
The Message Format associated with the Stream. One and only one Format is required for an OSCS Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : mapping
Type: object
This Map stores the association between the fields of the message format or an annotation to that of an orchestration's field
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : OIC_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Additional stream options list. Only resourceUri is currently supported.
  • formats
    The Message Format associated with the Stream. Only one Format is required for an OIC Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Additional stream options list. Only resourceUri is currently supported.
Show Source
Nested Schema : formats
Type: array
The Message Format associated with the Stream. Only one Format is required for an OIC Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source
Nested Schema : resourceUri
Type: object
A relative URL value of the form INTEGRATION_NAME/VERSION_STRING/RESOURCE_URL relative to config url
Nested Schema : authConfig
Type: object
Authentication information for outbound connections. username and password are the only credentials supported for BASIC authentication. NOTE: all the authConfig values should be base64 encoded.
Show Source
Nested Schema : config
Type: object
Integration-level configuration. This field is mandatory.
Show Source
Nested Schema : streams
Type: array
The list of Integration Streams. This field is mandatory.
Show Source
Nested Schema : OAC_Integration_Stream
Type: object
Show Source
  • annotations
    List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
  • config
    Additional stream options list. Only tableName is supported at this moment, which means the table name on OAC cloud server side. Note that the table name value should be within 30 characters.
  • formats
    The Message Format the Stream is associated with. One and only one Format is required for a OAC Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Nested Schema : annotations
Type: object
List of Message Annotations for the Stream. Currently only source and apps types of annotations are supported. Source annotations specify the keys of endpoint metadata of the message source to be populated in the message before dispatching it to the target. Apps annotations specify application attributes to be added into the message being dispatched. Only id is supported at this moment, which means the message will be supplied with its (or the source's) application id.
Show Source
Nested Schema : config
Type: object
Additional stream options list. Only tableName is supported at this moment, which means the table name on OAC cloud server side. Note that the table name value should be within 30 characters.
Nested Schema : formats
Type: array
The Message Format the Stream is associated with. One and only one Format is required for a OAC Integration. The Formats must already exist in the Application Endpoint. This field is mandatory.
Show Source
Nested Schema : apps
Type: array
Show Source
Nested Schema : source
Type: array
Show Source

401 Response

Unauthorized. The request requires user authentication.

404 Response

Not Found. The server has not found anything matching the Request-URI. No indication is given of whether the condition is temporary or permanent.
Back to Top

Examples

The following example shows how to update the name field of the Integration instance 0-TMJQ under Application 0-RYJQ by submitting a POST request on the REST resource using cURL.For more information about cURL, see Use cURL.

Note:

In the request and response, iotserver will be replaced by name and port of your assigned Oracle IoT Cloud Service instance. The format of the Cloud Service instance is myinstance-myidentitydomain.iot.us.oraclecloud.com and the default port is 443. 
curl -X POST -H 'Accept: application/json' 
		-H 'Content-Type: application/json' 
		-H 'Authorization:Basic aW90OndlbGNvbWUx' 
		-H 'X-HTTP-Method-Override: PATCH' 
		-d '{ "name": "Application Integration Name Changed"}' "http://iotserver/iot/api/v2/apps/0-RYJQ/integrations/0-TMJQ"

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 200 OK
Content-Type: application/json

Example of Response Body

The following example shows the contents of the response body containing the endpoint Id for the newly updated Integration instance in JSON format.

{
   "id":"0-TMJQ",
   "type":"ENTERPRISE",
   "name":"Application Integration Name Changed",
   "description":"Desc",
   "authType":"NO_AUTH",
   "config":{
      "url":"http://abc:1234"
   },
   "storageEnabled":true,
   "streams":[
      {
         "formats":[
            "urn:format:test:messagedeliverybyintegration:format:1:1468526374322"
         ],
         "config":{

         },
         "annotations":{

         }
      }
   ],
   "state":"ACTIVATED",
   "sharedSecret":"ZGRwZmJlMXV1YTJlMA==",
   "created":1468532454958,
   "createdAsString":"2016-07-14T21:40:54.958Z",
   "resources":[

   ],
   "links":[
      {
         "href":"http://iotserver:7001/iot/api/v2/apps/0-RYJQ/integrations/0-TMJQ/",
         "rel":"self"
      },
      {
         "href":"http://iotserver:7001/iot/api/v2/apps/0-RYJQ/integrations/0-TMJQ/",
         "rel":"canonical"
      }
   ]
}
Back to Top