Retrieve Integration Instances
/ic/api/integration/v1/monitoring/instances
Request
- application/json; charset=utf-8
-
fields: string
Limit query results to a few fields. Valid values are runId, id and all.
-
limit: integer(int32)
Use with the offset parameter for paginating through the returned results. The limit is the maximum number of items to return at one time. For example, offset=3&limit=16 indicates to list results starting at the 4th item, and the list will contain 16 items.
-
offset: integer(int32)
Use with the limit parameter for paginating through the returned results. The offset is the starting point from which to return records. Default value is 0. For example, offset=3&limit=16 indicates to list results at the 4th item, and the list will contain 16 items.
-
q: string
Filter parameters.
- timewindow: 1h, 6h, 1d, 2d, 3d, RETENTIONPERIOD. Default value is 1h. Oracle recommends to specify the time window as close as possible to the requirement.
- code: Integration identifier.
- version: Integration version.
- status: Status of the integration instance. Valid values are COMPLETED, FAILED and ABORTED.
- startdate: Custom time range start date/time in UTC format for filtering instances. Oracle recommends to use specify the start date as close as possible to the requirement.
- enddate: Custom time range end date/time in UTC format for filtering instances. Oracle recommends to specify the end date as close as possible to the requirement.
- primaryValue: Value of the primary business identifier.
- secondaryValue: Value of secondary business identifier.
- tertiaryValue: Value of tertiary business identifier.
- businessIDValue: Search for any of the business identifier values - primary, secondary or tertiary.
- jobid: Recovery job identifier corresponding to bulk resubmission of errored integration instances.
- runId: Run identifier of the scheduled integration instance.
- requestId: Applies only to scheduled orchestrations. ID of the request that triggered the integration instance.
- id: Integration instance identifier
- parentInstanceId: Integration instance identifier of a parent integration to search for locally invoked child integration instances.
Example:
{timewindow:'1h', id:'118', status:'FAILED', code:'ERROR', version:'01.00.0000', requestId:'2432', jobid:'18'}
Response
- application/json; charset=utf-8
- application/vnd.oracle.resource+json;type=collection
200 Response
object
-
activityStream:
array activityStream
-
auditTrail:
array auditTrail
-
creationDate:
string(date-time)
-
date:
string(date-time)
-
id:
string
-
integrationId:
string
-
integrationName:
string
-
integrationVersion:
string
-
isDataAccurate:
boolean
Default Value:
false
-
isLitmusFlow:
boolean
Default Value:
false
-
isLitmusSupported:
boolean
Default Value:
false
-
lastTrackedTime:
string(date-time)
-
links:
array links
-
litmusDescription:
string
-
litmusRecordingId:
string
-
litmusResultStatus:
string
-
mepType:
string
-
nonScheduleAsync:
boolean
Default Value:
false
-
parentInstanceId:
string
-
pkName:
string
-
pkValue:
string
-
projectFound:
boolean
Default Value:
false
-
requestId:
string
-
runId:
string
-
secondaryTrackingName:
string
-
secondaryTrackingValue:
string
-
status:
string
Allowed Values:
[ "IN_PROGRESS", "FAILED", "COMPLETED", "ABORTED", "RECOVERING", "UNKNOWN", "RESUBMITTED", "SCHEDULE_WAITING", "SCHEDULE_PAUSED" ]
-
tertiaryTrackingName:
string
-
tertiaryTrackingValue:
string
-
trackings:
array trackings
object
-
name:
string
-
primary:
boolean
Default Value:
false
-
value:
string
400 Response
500 Response
Examples
The following examples show how to retrieve monitoring details about integration instances 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.
Example: Get details about all integration instances
curl -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" https://integration.us.oraclecloud.com/ic/api/integration/v1/monitoring/instances
Example: Get details about all integration instances for the integration with the code SC2RNSYNC in uppercase or lowercase for the past 3 days
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" --data-urlencode "q={code : 'SC2RNSYNC', timewindow : '3d'}" https://integration.us.oraclecloud.com/ic/api/integration/v1/monitoring/instances
Example: Get details about the scheduled orchestration instance triggered by the specified request ID
Applies only to scheduled orchestrations.
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" --data-urlencode "q={requestId: '1234', timewindow : '3d'}" https://integration.us.oraclecloud.com/ic/api/integration/v1/monitoring/instances
Example: Paginate through returned results
Pagination is done with limit
and offset
. In this example, we list integration instances starting at the fourth item. The list contains 16 items.
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" -d "offset=3&limit=16" https://integration.us.oraclecloud.com/ic/api/integration/v1/monitoring/instances
Example: Limit results to runId field only
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" -d "fields=runId'" https://integration.us.oraclecloud.com/ic/api/integration/v1/monitoring/instances
Example: Combine Parameters
To combine query parameters, use q
with the --data-urlencode
option. The other parameters can be added after the -d
option.
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" --data-urlencode "q={code : 'SC2RNSYNC', timewindow : '3d'}" -d "offset=3&limit=16" -d "fields=id" https://integration.us.oraclecloud.com/ic/api/integration/v1/monitoring/instances