openapi: 3.2.0
info:
description: Use the Data Integration API to organize your data integration projects, create data flows, pipelines and tasks, and then publish, schedule, and run tasks that extract, transform, and load data. For more information, see [Data Integration](https://docs.oracle.com/iaas/data-integration/home.htm).
license:
name: Oracle Corporation
title: Data Integration API
version: '20200430'
x-provenance:
method: harvested
first_party: true
publisher: Oracle
source: https://docs.oracle.com/en-us/iaas/api/specs/85979cfb4fad4fd1086a187bef6767b32619ed61ae3506aad96bd6431326aa45.yaml
harvested: '2026-08-04'
note: Published by Oracle as the contract for the Data Integration API OCI service and stored verbatim; API Evangelist added only this provenance block.
x-evidence:
- url: https://docs.oracle.com/en-us/iaas/api/specs/index.json
what: Oracle's own index of every OCI service specification
- url: https://docs.oracle.com/en-us/iaas/api/specs/85979cfb4fad4fd1086a187bef6767b32619ed61ae3506aad96bd6431326aa45.yaml
what: the harvested document for Data Integration API
servers:
- url: https://localhost:8484/20200430
- url: http://localhost:8484/20200430
tags:
- name: DataIntegration
paths:
/workRequests:
get:
description: 'Lists the work requests in a compartment.
'
operationId: ListWorkRequests
parameters:
- $ref: '#/components/parameters/CompartmentIdQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceIdQueryParam'
- $ref: '#/components/parameters/WorkRequestStatusQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
responses:
200:
description: Sucessfully retrieved a list of work requests.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
description: This is the collection of work request summaries, it may be a collection of lightweight details or full definitions.
items:
$ref: '#/components/schemas/WorkRequestSummary'
type: array
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list work requests.
tags:
- DataIntegration
x-related-resource: '#/definitions/WorkRequest'
/workRequests/{workRequestId}:
get:
description: Retrieves the status of the work request with the given ID.
operationId: GetWorkRequest
parameters:
- $ref: '#/components/parameters/WorkRequestIdPathParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved the details of the work request.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
retry-after:
description: Indicates the number of seconds to wait before making a follow-up request.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/WorkRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get work request status.
tags:
- DataIntegration
x-related-resource: '#/definitions/WorkRequest'
/workRequests/{workRequestId}/logs:
get:
description: 'Retrieves a paginated list of logs for a given work request.
'
operationId: ListWorkRequestLogs
parameters:
- $ref: '#/components/parameters/WorkRequestIdPathParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
responses:
200:
description: Successfully retrieved the list of work request logs.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
description: This is the collection of work request summaries, it may be a collection of lightweight details or full definitions.
items:
$ref: '#/components/schemas/WorkRequestLogEntry'
type: array
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list work request logs.
tags:
- DataIntegration
x-related-resource: '#/definitions/WorkRequest'
/workRequests/{workRequestId}/workRequestErrors:
get:
description: 'Retrieves a paginated list of errors for a given work request.
'
operationId: ListWorkRequestErrors
parameters:
- $ref: '#/components/parameters/WorkRequestIdPathParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
responses:
200:
description: Successfully retrieved the list of work request errors.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
description: This is the collection of work request summaries, it may be a collection of lightweight details or full definitions.
items:
$ref: '#/components/schemas/WorkRequestError'
type: array
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list work request errors.
tags:
- DataIntegration
x-related-resource: '#/definitions/WorkRequest'
/workspaces:
get:
description: 'Retrieves a list of Data Integration workspaces.
'
operationId: ListWorkspaces
parameters:
- $ref: '#/components/parameters/CompartmentIdQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LifecycleStateQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved a page of workspace summaries.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
items:
$ref: '#/components/schemas/WorkspaceSummary'
type: array
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of all Data Integration workspaces in a compartment.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
post:
description: 'Creates a new Data Integration workspace ready for performing data integration tasks. To retrieve the OCID for the new workspace, use the opc-work-request-id returned by this API and call the [GetWorkRequest](#/en/data-integration/latest/WorkRequest/GetWorkRequest) API.
'
operationId: CreateWorkspace
parameters:
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
202:
description: Successfully accepted the request. The Data Integration workspace will be created.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'The [OCID](/iaas/Content/API/Concepts/identifiers.htm) of the work request. Use [GetWorkRequest](/api/#/en/workrequests/20160918/WorkRequest/GetWorkRequest)
with this ID to track the status of the request.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a new Data Integration workspace.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateWorkspaceDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateWorkspaceDetails'
description: The information needed to create a new Data Integration workspace.
required: true
/workspaces/{workspaceId}:
delete:
description: Deletes a Data Integration workspace resource using the specified identifier.
operationId: DeleteWorkspace
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/QuiesceTimeoutQueryParam'
- $ref: '#/components/parameters/ForceOperationQueryParam'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
202:
description: Successfully accepted the request. The workspace will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'The [OCID](/iaas/Content/API/Concepts/identifiers.htm) of the work request. Use [GetWorkRequest](/api/#/en/workrequests/20160918/WorkRequest/GetWorkRequest)
with this ID to track the status of the request.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a provisioned Data Integration workspace.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
get:
description: Retrieves a Data Integration workspace using the specified identifier.
operationId: GetWorkspace
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved the specified Data Integration workspace.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Workspace'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a specified workspace.
tags:
- DataIntegration
put:
description: Updates the specified Data Integration workspace.
operationId: UpdateWorkspace
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
202:
description: Successfully accepted the request. The Data Integration workspace will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'The [OCID](/iaas/Content/API/Concepts/identifiers.htm) of the work request. Use [GetWorkRequest](/api/#/en/workrequests/20160918/WorkRequest/GetWorkRequest)
with this ID to track the status of the request.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Workspace'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update the Data Integration workspace identified by the ID.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateWorkspaceDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateWorkspaceDetails'
description: The information needed to update the workspace.
required: true
/workspaces/{workspaceId}/actions/changeCompartment:
post:
description: 'Moves a workspace to a specified compartment.
'
operationId: ChangeCompartment
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
202:
description: Successfully accepted the request. The workspace will be moved to the specified compartment.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'The [OCID](/iaas/Content/API/Concepts/identifiers.htm) of the work request. Use [GetWorkRequest](/api/#/en/workrequests/20160918/WorkRequest/GetWorkRequest)
with this ID to track the status of the request.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to move a workspace to reside in a specified compartment.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ChangeCompartmentDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/ChangeCompartmentDetails'
description: The information needed to move a workspace to a specified compartment.
required: true
/workspaces/{workspaceId}/actions/start:
post:
description: 'Starts a workspace.
'
operationId: StartWorkspace
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
202:
description: Successfully accepted the request. The workspace will be started.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'The [OCID](/iaas/Content/API/Concepts/identifiers.htm) of the work request. Use [GetWorkRequest](/api/#/en/workrequests/20160918/WorkRequest/GetWorkRequest)
with this ID to track the status of the request.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to start the workspace.
tags:
- DataIntegration
x-obmcs-terraform:
actionType: START
x-related-resource: '#/definitions/Workspace'
/workspaces/{workspaceId}/actions/stop:
post:
description: 'Stops a workspace.
'
operationId: StopWorkspace
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/QuiesceTimeoutQueryParam'
- $ref: '#/components/parameters/ForceOperationQueryParam'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
202:
description: Successfully accepted the request. The workspace will be stopped.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'The [OCID](/iaas/Content/API/Concepts/identifiers.htm) of the work request. Use [GetWorkRequest](/api/#/en/workrequests/20160918/WorkRequest/GetWorkRequest)
with this ID to track the status of the request.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to stop a workspace.
tags:
- DataIntegration
x-obmcs-terraform:
actionType: STOP
x-related-resource: '#/definitions/Workspace'
/workspaces/{workspaceId}/applications:
get:
description: Retrieves a list of applications and provides options to filter the list.
operationId: ListApplications
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/NameContainsQueryParameter'
- $ref: '#/components/parameters/IdentifierFilter'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PaginationLimitQueryParam'
- $ref: '#/components/parameters/PageNumberQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
'200':
description: Successfully retrieved a list of applications.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationSummaryCollection'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to lists applications with filtering options.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
x-targetService: metadata
post:
description: 'Creates an application.
'
operationId: CreateApplication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
'200':
description: Successfully created an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Application'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to create an application.
tags:
- DataIntegration
x-example: "Example: Create a new application.\nPOST /20200430/workspaces/<workspace_id>/applications HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"definedTags\": {},\n \"freeformTags\": {},\n \"modelType\": \"INTEGRATION_APPLICATION\",\n \"compartmentId\": \"ocid1.compartment.oc1..tbd\",\n \"name\": \"New Application\",\n \"identifier\": \"NEW_APPLICATION\",\n \"description\": \"\"\n}\nExample: Copy an application - create a new application from an existing one.\nPOST /20200430/workspaces/<workspace_id>/applications HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"definedTags\": {},\n \"freeformTags\": {},\n \"sourceApplicationInfo\": {\n \"applicationKey\": \"source_application_key\",\n \"workspaceId\": \"ocid1.disworkspace.oc1.iad.tbd\"\n },\n \"modelType\": \"INTEGRATION_APPLICATION\",\n \"compartmentId\": \"ocid1.compartment.oc1..tbd\",\n \"name\": \"New Application\",\n \"identifier\": \"NEW_APPLICATION\",\n \"description\": \"\"\n}\n"
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateApplicationDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateApplicationDetails'
description: The details needed to create an application.
required: true
/workspaces/{workspaceId}/applications/{applicationKey}:
delete:
description: Removes an application using the specified identifier.
operationId: DeleteApplication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'204':
description: Successfully deleted the specified application.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
412:
$ref: '#/components/responses/412'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to delete an application.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
x-targetService: metadata
get:
description: Retrieves an application using the specified identifier.
operationId: GetApplication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully retrieved an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Application'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to get an application.
tags:
- DataIntegration
x-targetService: metadata
put:
description: Updates an application.
operationId: UpdateApplication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully updated an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Application'
412:
$ref: '#/components/responses/412'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to update an application.
tags:
- DataIntegration
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateApplicationDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateApplicationDetails'
description: The details needed to update an application.
required: true
/workspaces/{workspaceId}/applications/{applicationKey}/compositeState:
get:
description: 'This endpoint can be used to get composite state for a given aggregator
'
operationId: GetCompositeState
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/AggregatorKeyCompositeStateQueryParam'
responses:
200:
description: Composite State object for provided Aggregator Key.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If
you need to contact Oracle about a particular request,
please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/CompositeState'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Get Composite State for a given aggregator
tags:
- DataIntegration
/workspaces/{workspaceId}/applications/{applicationKey}/dependentObjects:
get:
description: Retrieves a list of all dependent objects for a specific application.
operationId: ListDependentObjects
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/NameContainsQueryParameter'
- $ref: '#/components/parameters/IdentifierFilter'
- $ref: '#/components/parameters/TypeFilter'
- $ref: '#/components/parameters/TypeInSubtree'
- $ref: '#/components/parameters/PaginationLimitQueryParam'
- $ref: '#/components/parameters/PageNumberQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully retrieved a list of objects depended on by an application.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/DependentObjectSummaryCollection'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to list all dependent objects.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
x-targetService: metadata
/workspaces/{workspaceId}/applications/{applicationKey}/dependentObjects/{dependentObjectKey}:
get:
description: Retrieves the details of a dependent object from an application.
operationId: GetDependentObject
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/dependentObjectKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully retrieved the details of a dependent object.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DependentObject'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to get the details of a dependent object.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
x-targetService: metadata
/workspaces/{workspaceId}/applications/{applicationKey}/detailedDescription:
delete:
description: Deletes detailed description of an Application.
operationId: DeleteApplicationDetailedDescription
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
responses:
202:
description: Successfully accepted the delete request. The detailed description will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete detailed description of an Application.
tags:
- DataIntegration
x-related-resource: '#/definitions/DetailedDescription'
x-targetService: metadata
get:
description: Retrieves detailed description of an Application
operationId: GetApplicationDetailedDescription
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
responses:
200:
description: Successfully retrieved the detailed description of specified Application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DetailedDescription'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get the detailed description of an Application.
tags:
- DataIntegration
x-related-resource: '#/definitions/DetailedDescription'
x-targetService: metadata
post:
description: Creates detailed description for an application.
operationId: CreateApplicationDetailedDescription
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
'200':
description: Successfully created detailed description for an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DetailedDescription'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to create detailed description for an application.
tags:
- DataIntegration
x-related-resource: '#/definitions/DetailedDescription'
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateDetailedDescriptionDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateDetailedDescriptionDetails'
description: Detailed description of an application.
required: true
put:
description: Updates the detailed description of an Application.
operationId: UpdateApplicationDetailedDescription
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
responses:
200:
description: Successfully accepted the update request. The detailed description will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DetailedDescription'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to change the detailed description of an Application.
tags:
- DataIntegration
x-related-resource: '#/definitions/DetailedDescription'
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateDetailedDescriptionDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateDetailedDescriptionDetails'
description: The details needed to update the detailed description of Application
required: true
/workspaces/{workspaceId}/applications/{applicationKey}/patchChanges:
get:
description: Retrieves a list of patches in an application and provides options to filter the list.
operationId: ListPatchChanges
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/SincePatchQueryParam'
- $ref: '#/components/parameters/ToPatchQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageNumberQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully retrieved a list of patches in an application.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/PatchChangeSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to list changes made in the application by patches.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
/workspaces/{workspaceId}/applications/{applicationKey}/patches:
get:
description: Retrieves a list of patches in an application and provides options to filter the list. For listing changes based on a period and logical objects changed, see ListPatchChanges API.
operationId: ListPatches
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierFilter'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PaginationLimitQueryParam'
- $ref: '#/components/parameters/PageNumberQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully retrieved a list of patches in an application.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/PatchSummaryCollection'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to list patches with filtering options. For listing changes based on a period and logical objects changed, see ListPatchChanges API.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
x-targetService: metadata
post:
description: Creates a patch in an application.
operationId: CreatePatch
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
'200':
description: Successfully created a patch in an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Patch'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to create a patch in an application.
tags:
- DataIntegration
x-example: "Example: Execute a task with no parameters.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/patches HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"patchType\": \"REFRESH\"\n}\n"
x-related-resource: '#/definitions/Application'
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreatePatchDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreatePatchDetails'
description: Detailed needed to create a patch in an application.
required: true
/workspaces/{workspaceId}/applications/{applicationKey}/patches/{patchKey}:
delete:
description: Removes a patch using the specified identifier.
operationId: DeletePatch
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/patchKey'
responses:
202:
description: Successfully accepted the delete request. The patch will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a patch.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
x-targetService: metadata-service
get:
description: Retrieves a patch in an application using the specified identifier.
operationId: GetPatch
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/patchKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully retrieved a patch in an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Patch'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to get a patch in an application.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
x-targetService: metadata
/workspaces/{workspaceId}/applications/{applicationKey}/publishedObjects:
get:
description: Retrieves a list of all the published objects for a specified application. Use the fields query parameter with value 'metadata' to retrieve minimal information.
operationId: ListPublishedObjects
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/NameStartsWithQueryParam'
- $ref: '#/components/parameters/NameContainsQueryParameter'
- $ref: '#/components/parameters/IdentifierFilter'
- $ref: '#/components/parameters/TypeFilter'
- $ref: '#/components/parameters/TypeInSubtree'
- $ref: '#/components/parameters/PaginationLimitQueryParam'
- $ref: '#/components/parameters/PageNumberQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully retrieved a list of published objects for an application.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/PublishedObjectSummaryCollection'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to list the all published objects.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
x-targetService: metadata
/workspaces/{workspaceId}/applications/{applicationKey}/publishedObjects/{publishedObjectKey}:
get:
description: Retrieves the details of a published object from an application.
operationId: GetPublishedObject
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/publishedObjectKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/ExpandReferences'
responses:
'200':
description: Successfully retrieved the details of a published object.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/PublishedObject'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to get details of a published object.
tags:
- DataIntegration
x-related-resource: '#/definitions/Application'
x-targetService: metadata
/workspaces/{workspaceId}/applications/{applicationKey}/references:
get:
description: Retrieves a list of references in an application. Reference objects are created when dataflows and tasks use objects, such as data assets and connections.
operationId: ListReferences
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
responses:
'200':
description: Successfully retrieved references in an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ReferenceSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to get a list of references for an application. Reference objects are created when dataflows and tasks use objects, such as data assets and connections. This endpoint returns a set of the references used in the application.
tags:
- DataIntegration
x-related-resource: '#/definitions/Reference'
/workspaces/{workspaceId}/applications/{applicationKey}/references/{referenceKey}:
get:
description: Retrieves a reference in an application.
operationId: GetReference
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/referenceKey'
responses:
'200':
description: Successfully retrieved a reference in an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Reference'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to get a reference for an application.
tags:
- DataIntegration
x-related-resource: '#/definitions/Reference'
put:
description: Updates the application references. For example, to map a data asset to a different target object.
operationId: UpdateReference
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/referenceKey'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
200:
description: Successfully accepted the update request. The task run will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Reference'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update application references. For example, to map a data asset to a different target object.
tags:
- DataIntegration
x-example: "Example: Update data asset reference for an ADW.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/references/<reference_key> HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"targetObject\": {\n \"key\": \"target_adw_data_asset_key\",\n \"modelType\": \"ORACLE_ADWC_DATA_ASSET\"\n }\n}\nExample: Update connection reference for an ADW.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/references/<reference_key> HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"targetObject\": {\n \"key\": \"target_adw_connection_key\",\n \"modelType\": \"ORACLE_ADWC_CONNECTION\"\n }\n}\nExample: Update schema reference.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/references/<reference_key> HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"targetObject\": {\n \"key\": \"dataref:connection_key/YOURSCHEMANAME\",\n \"modelType\": \"SCHEMA\"\n }\n}\n"
x-related-resource: '#/definitions/Reference'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateReferenceDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateReferenceDetails'
description: The details needed to update the references.
required: true
/workspaces/{workspaceId}/applications/{applicationKey}/runtimePipelines:
get:
description: 'This endpoint can be used to list runtime pipelines with filtering options
'
operationId: ListRuntimePipelines
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/KeyListQueryParam'
- $ref: '#/components/parameters/AggregatorKeyQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/AggregatorTypeListQueryParam'
- $ref: '#/components/parameters/FilterListQueryParameter'
responses:
200:
description: A page of Runtime Pipeline objects.
headers:
opc-next-page:
description: 'For pagination of a list of `RuntimePipeline`s. If this header appears in the response, then this
is a partial list of RuntimePipeline. Include this value as the `page` parameter in a subsequent
GET request to get the next batch of RuntimePipelines.
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If
you need to contact Oracle about a particular request,
please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/RuntimePipelineSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Lists Runtime Pipelines with filtering options
tags:
- DataIntegration
x-feature-id: Orchestration
/workspaces/{workspaceId}/applications/{applicationKey}/runtimePipelines/{runtimePipelineKey}:
get:
description: Retrieves a runtime pipeline using the specified identifier.
operationId: GetRuntimePipeline
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/runtimePipelineKey'
- $ref: '#/components/parameters/ExpandReferences'
responses:
200:
description: Successfully retrieved the specified runtime pipeline.
headers:
etag:
description: For optimistic concurrency control. See `if-match`.
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If
you need to contact Oracle about a particular request,
please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/RuntimePipeline'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a runtime pipeline using the specified identifier.
tags:
- DataIntegration
x-feature-id: Orchestration
/workspaces/{workspaceId}/applications/{applicationKey}/runtimePipelines/{runtimePipelineKey}/runtimeOperators:
get:
description: 'This endpoint can be used to list runtime operators with filtering options
'
operationId: ListRuntimeOperators
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/runtimePipelineKey'
- $ref: '#/components/parameters/KeyListQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/AggregatorTypeListQueryParam'
responses:
200:
description: A page of Runtime Operator objects.
headers:
opc-next-page:
description: 'For pagination of a list of `RuntimeOperator`s. If this header appears in the response, then this
is a partial list of RuntimeOperator. Include this value as the `page` parameter in a subsequent
GET request to get the next batch of RuntimeOperators.
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If
you need to contact Oracle about a particular request,
please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/RuntimeOperatorSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Lists Runtime Operators with filtering options
tags:
- DataIntegration
x-feature-id: Orchestration
? /workspaces/{workspaceId}/applications/{applicationKey}/runtimePipelines/{runtimePipelineKey}/runtimeOperators/{runtimeOperatorKey}
: get:
description: Retrieves a runtime operator using the specified identifier.
operationId: GetRuntimeOperator
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/runtimePipelineKey'
- $ref: '#/components/parameters/runtimeOperatorKey'
responses:
200:
description: Successfully retrieved the specified runtime operator.
headers:
etag:
description: For optimistic concurrency control. See `if-match`.
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If
you need to contact Oracle about a particular request,
please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/RuntimeOperator'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a runtime operator using the specified identifier.
tags:
- DataIntegration
x-feature-id: Orchestration
/workspaces/{workspaceId}/applications/{applicationKey}/schedules:
get:
description: 'Use this endpoint to list schedules.
'
operationId: ListSchedules
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/KeyListQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/TypeListQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/FavoritesQueryParam'
- $ref: '#/components/parameters/FilterQueryParam'
responses:
'200':
description: List of Schedule objects
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ScheduleSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of schedules.
tags:
- DataIntegration
x-related-resource: '#/definitions/Schedule'
post:
description: Endpoint to create a new schedule
operationId: CreateSchedule
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
200:
description: Schedule is created successfully
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Schedule'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a new schedule object.
tags:
- DataIntegration
x-example: "Example: Create a schedule with a Cron expression.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/schedules HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"name\": \"Schedule every 30 mins\",\n \"identifier\": \"SCHEDULE_EVERY_30_MINS\",\n \"frequencyDetails\": { \"modelType\": \"CUSTOM\", \"customExpression\": \"*/30 * * * *\" },\n \"isDaylightAdjustmentEnabled\": false,\n \"timezone\": \"UTC\"\n}\n"
x-related-resource: '#/definitions/Schedule'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateScheduleDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateScheduleDetails'
description: Request body parameter for Schedule details
required: true
/workspaces/{workspaceId}/applications/{applicationKey}/schedules/{scheduleKey}:
delete:
description: Endpoint to delete schedule.
operationId: DeleteSchedule
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/scheduleKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'204':
description: Schedule and corresponding objects are deleted
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a schedule.
tags:
- DataIntegration
x-related-resource: '#/definitions/Schedule'
get:
description: Retrieves schedule by schedule key
operationId: GetSchedule
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/scheduleKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: A Schedule object
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Schedule'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a schedule.
tags:
- DataIntegration
x-related-resource: '#/definitions/Schedule'
put:
description: Endpoint used to update the schedule
operationId: UpdateSchedule
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/scheduleKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Schedule is updated
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Schedule'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update the schedule object identified by the key.
tags:
- DataIntegration
x-related-resource: '#/definitions/Schedule'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateScheduleDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateScheduleDetails'
description: Request body parameter for Schedule details
required: true
/workspaces/{workspaceId}/applications/{applicationKey}/taskRunLineages:
get:
description: 'This endpoint can be used to list Task Run Lineages within a given time window.
'
operationId: ListTaskRunLineages
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/FilterListQueryParameter'
- $ref: '#/components/parameters/TimeUpdatedGreaterThanQueryParam'
- $ref: '#/components/parameters/TimeUpdatedGreaterThanOrEqualToQueryParam'
- $ref: '#/components/parameters/TimeUpdatedLessThanQueryParam'
- $ref: '#/components/parameters/TimeUpdatedLessThanOrEqualToQueryParam'
responses:
200:
description: A page of TaskRunLineage objects.
headers:
opc-next-page:
description: 'For pagination of a list of `TaskRunLineage`s. If this header appears in the response, then this
is a partial list of TaskRunLineage. Include this value as the `page` parameter in a subsequent
GET request to get the next batch of TaskRunLineages.
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If
you need to contact Oracle about a particular request,
please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskRunLineageSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Lists Task Run Lineages with filtering options.
tags:
- DataIntegration
x-feature-id: Orchestration
/workspaces/{workspaceId}/applications/{applicationKey}/taskRuns:
get:
description: Retrieves a list of task runs and provides options to filter the list.
operationId: ListTaskRuns
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/KeyListQueryParam'
- $ref: '#/components/parameters/AggregatorQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/FilterListQueryParameter'
- $ref: '#/components/parameters/NameStartsWithQueryParam'
- $ref: '#/components/parameters/NameContainsQueryParameter'
responses:
200:
description: Successfully retrieved a page of task runs.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/TaskRunSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to lists task runs with filtering options.
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskRun'
x-targetService: metadata-service
post:
description: Creates a data integration task run for the specified task.
operationId: CreateTaskRun
parameters:
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
responses:
200:
description: Successfully created a task run.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskRun'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a Data Integration task run for the specified task.
tags:
- DataIntegration
x-example: "Example: Execute a task with no parameters.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/taskRuns HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"registryMetadata\": {\n \"aggregatorKey\": \"your_task_key_to_run\"\n }\n}\nExample: Execute a task with a string parameter.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/taskRuns HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"configProvider\": {\n \"bindings\": {\n \"YOUR_STRING_PARAMETER\": {\n \"simpleValue\": \"Hello\"\n }\n }\n },\n \"registryMetadata\": {\n \"aggregatorKey\": \"your_task_key_to_run\"\n }\n}\n"
x-related-resource: '#/definitions/TaskRun'
x-targetService: metadata-service
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateTaskRunDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateTaskRunDetails'
description: The details needed to create a task run.
required: true
/workspaces/{workspaceId}/applications/{applicationKey}/taskRuns/{taskRunKey}:
delete:
description: Deletes a task run using the specified identifier.
operationId: DeleteTaskRun
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/taskRunKey'
responses:
202:
description: Successfully accepted the delete request. The task run will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a task run.
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskRun'
x-targetService: metadata-service
get:
description: Retrieves a task run using the specified identifier.
operationId: GetTaskRun
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/taskRunKey'
responses:
200:
description: Successfully retrieved the specified task run.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskRun'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a task run using the specified identifier.
tags:
- DataIntegration
put:
description: Updates the status of the task run. For example, aborts a task run.
operationId: UpdateTaskRun
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/taskRunKey'
responses:
200:
description: Successfully accepted the update request. The task run will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskRunDetails'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to change the status of the task run. For example, to abort the task run.
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskRun'
x-targetService: metadata-service
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateTaskRunDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateTaskRunDetails'
description: The details needed to update the status of a task run.
required: true
/workspaces/{workspaceId}/applications/{applicationKey}/taskRuns/{taskRunKey}/logs:
get:
description: Gets log entries for task runs using its key.
operationId: ListTaskRunLogs
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/taskRunKey'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
responses:
200:
description: Successfully retrieved a list of task run logs.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
description: This is the collection of task run log entries.
items:
$ref: '#/components/schemas/TaskRunLogSummary'
type: array
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list task run logs.
tags:
- DataIntegration
/workspaces/{workspaceId}/applications/{applicationKey}/taskSchedules:
get:
description: 'This endpoint can be used to get the list of all the TaskSchedule objects.
'
operationId: ListTaskSchedules
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/KeyListQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/TypeListQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IsEnabledQueryParam'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
200:
description: A page of TaskSchedule objects
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/TaskScheduleSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of task schedules.
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskSchedule'
post:
description: Endpoint to be used create TaskSchedule.
operationId: CreateTaskSchedule
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
200:
description: TaskSchedule is created successfully
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskSchedule'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a new task schedule object.
tags:
- DataIntegration
x-example: "Example: Schedule a task with no parameters.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/taskSchedules HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"name\": \"Task Every Period\",\n \"identifier\": \"TASK_EVERY_PERIOD\",\n \"scheduleRef\": {\"key\":\"your_schedule_key\"},\n \"registryMetadata\": {\n \"aggregatorKey\": \"your_task_key_to_run\"\n }\n}\nExample: Schedule a task with a string parameter.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/taskSchedules HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"name\": \"Task Every Period\",\n \"identifier\": \"TASK_EVERY_PERIOD\",\n \"scheduleRef\": {\"key\":\"your_schedule_key\"},\n \"configProvider\": {\n \"bindings\": {\n \"YOUR_STRING_PARAMETER\": {\n \"simpleValue\": \"Hello\"\n }\n }\n },\n \"registryMetadata\": {\n \"aggregatorKey\": \"your_task_key_to_run\"\n }\n}\nExample: Schedule a task with end time and retry and other properties.\nPOST /20200430/workspaces/<workspace_id>/applications/<application_key>/taskSchedules HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"name\": \"Task Every Period\",\n \"identifier\": \"TASK_EVERY_PERIOD\",\n \"endTimeMillis\": 1768791660000,\n \"expectedDuration\": 1,\n \"expectedDurationUnit\": \"HOURS\",\n \"isConcurrentAllowed\": true,\n \"isEnabled\": true,\n \"retryAttempts\": 3,\n \"retryDelay\": 1,\n \"retryDelayUnit\": \"MINUTES\",\n \"scheduleRef\": {\"key\":\"your_schedule_key\"},\n \"timezone\": \"UTC\",\n \"registryMetadata\": {\n \"aggregatorKey\": \"your_task_key_to_run\"\n }\n}\n"
x-related-resource: '#/definitions/TaskSchedule'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateTaskScheduleDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateTaskScheduleDetails'
description: Request body parameter for TaskSchedule details
required: true
/workspaces/{workspaceId}/applications/{applicationKey}/taskSchedules/{taskScheduleKey}:
delete:
description: Endpoint to delete TaskSchedule.
operationId: DeleteTaskSchedule
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/taskScheduleKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'204':
description: TaskSchedule and corresponding objects are deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a task schedule.
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskSchedule'
get:
description: Endpoint used to get taskSchedule by its key
operationId: GetTaskSchedule
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/taskScheduleKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: A TaskSchedule object
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskSchedule'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to fetch a task Schedule.
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskSchedule'
put:
description: Endpoint used to update the TaskSchedule
operationId: UpdateTaskSchedule
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/taskScheduleKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: TaskSchedule is updated
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskSchedule'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update the task schedule object identified by the key
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskSchedule'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateTaskScheduleDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateTaskScheduleDetails'
description: Request body parameter for TaskSchedule details
required: true
/workspaces/{workspaceId}/connectionValidations:
get:
description: Retrieves a list of connection validations within the specified workspace.
operationId: ListConnectionValidations
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/KeyQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved a page of connection validations.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectionValidationSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of connection validations.
tags:
- DataIntegration
x-related-resource: '#/definitions/ConnectionValidation'
post:
description: Creates a connection validation.
operationId: CreateConnectionValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/CreateConnectionValidationDetails'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
200:
description: Successfully created a connection validation.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectionValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
summary: Use this endpoint to create a connection validation object.
tags:
- DataIntegration
x-related-resource: '#/definitions/ConnectionValidation'
x-targetService: connectivity
/workspaces/{workspaceId}/connectionValidations/{connectionValidationKey}:
delete:
description: Deletes a connection validation.
operationId: DeleteConnectionValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionValidationKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
204:
description: The validation object is successfully deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a connection validation.
tags:
- DataIntegration
x-related-resource: '#/definitions/ConnectionValidation'
get:
description: Retrieves a connection validation using the specified identifier.
operationId: GetConnectionValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionValidationKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved a connection validation.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectionValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get the connection validation based on its ID.
tags:
- DataIntegration
x-related-resource: '#/definitions/ConnectionValidation'
/workspaces/{workspaceId}/connections:
get:
description: Retrieves a list of all connections.
operationId: ListConnections
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/DataAssetKeyQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/TypeQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
200:
description: Successfully retrieved a list of connections.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ConnectionSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a summary of connections.
tags:
- DataIntegration
x-related-resource: '#/definitions/Connection'
x-targetService: connectivity
post:
description: Creates a connection under an existing data asset.
operationId: CreateConnection
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/CreateConnectionDetails'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
200:
description: Successfully created a connection.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Connection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a connection under an existing data asset.
tags:
- DataIntegration
x-related-resource: '#/definitions/Connection'
x-targetService: connectivity
/workspaces/{workspaceId}/connections/{connectionKey}:
delete:
description: Removes a connection using the specified identifier.
operationId: DeleteConnection
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
204:
description: Successfully deleted the connection.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete the connection by given connection id.
tags:
- DataIntegration
x-related-resource: '#/definitions/Connection'
x-targetService: connectivity
get:
description: Retrieves the connection details using the specified identifier.
operationId: GetConnection
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved the specified connection.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Connection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get the connection details using the specified identifier.
tags:
- DataIntegration
x-related-resource: '#/definitions/Connection'
x-targetService: connectivity
put:
description: Updates a connection under a data asset.
operationId: UpdateConnection
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionKey'
- $ref: '#/components/parameters/UpdateConnectionDetails'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
responses:
200:
description: Successfully updated the connection.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Connection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update a connection under a data asset.
tags:
- DataIntegration
x-example: "Example: Update a connection.\nPOST /20200430/workspaces/<workspace_id>/connections/<connection_key> HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"name\": \"Default connection\",\n \"description\": \"Connection description here.\",\n \"identifier\": \"DEFAULT_CONNECTION\",\n \"modelType\": \"ORACLE_ADWC_CONNECTION\",\n \"username\": \"YOUR_SCHEMA\",\n \"passwordSecret\": {\n \"secretConfig\": {\n \"secretId\": \"ocid1.vaultsecret.oc1.iad.tbd\",\n \"modelType\": \"OCI_VAULT_SECRET_CONFIG\"\n }\n },\n \"tnsAlias\": \"iadtest_high\",\n \"isDefault\": true,\n \"key\": \"your_connection_key\",\n \"registryMetadata\": {\n \"aggregatorKey\": \"your_data_asset_key\"\n }\n}\n"
x-related-resource: '#/definitions/Connection'
x-targetService: connectivity
/workspaces/{workspaceId}/connections/{connectionKey}/schemas:
get:
description: Retrieves a list of all the schemas that can be accessed using the specified connection.
operationId: ListSchemas
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionKey'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SchemaResourceNameQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/NameListQueryParam'
- $ref: '#/components/parameters/IncludeTypesQueryParam'
responses:
200:
description: Successfully retrieved a list of schemas that can be accessed using the specified connection.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/SchemaSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
summary: Use this endpoint to get a summary of schemas using the specified connection.
tags:
- DataIntegration
x-related-resource: '#/definitions/Schema'
x-targetService: connectivity
/workspaces/{workspaceId}/connections/{connectionKey}/schemas/{schemaResourceName}:
get:
description: Retrieves a schema that can be accessed using the specified connection.
operationId: GetSchema
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionKey'
- $ref: '#/components/parameters/SchemaResourceName'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved a schema that can be accessed using the specified connection.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Schema'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
summary: Use this endpoint to get a schema with the given schema resource name.
tags:
- DataIntegration
x-related-resource: '#/definitions/Schema'
x-targetService: connectivity
/workspaces/{workspaceId}/connections/{connectionKey}/schemas/{schemaResourceName}/dataEntities:
get:
description: "Lists a summary of data entities from the data asset using the specified connection. \n"
operationId: ListDataEntities
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionKey'
- $ref: '#/components/parameters/SchemaResourceName'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/TypeQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/NameListQueryParam'
- $ref: '#/components/parameters/IsPatternParam'
- $ref: '#/components/parameters/IncludeTypesQueryParam'
responses:
200:
description: Successfully retrieved a page of data entities.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/DataEntitySummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list the summaries of data entities within the specified schema.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataEntity'
x-targetService: connectivity
/workspaces/{workspaceId}/connections/{connectionKey}/schemas/{schemaResourceName}/dataEntities/{dataEntityKey}:
get:
description: Retrieves the data entity details with the given name from live schema.
operationId: GetDataEntity
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionKey'
- $ref: '#/components/parameters/SchemaResourceName'
- $ref: '#/components/parameters/DataEntityKey'
responses:
200:
description: Successfully retrieved the data entity.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DataEntity'
400:
description: Bad Request
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
401:
description: Unauthorized
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
404:
description: Not Found
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
429:
$ref: '#/components/responses/429'
500:
description: Internal Server Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to get the data entity from live schema.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataEntity'
x-targetService: connectivity
/workspaces/{workspaceId}/connections/{connectionKey}/schemas/{schemaResourceName}/entityShapes:
post:
description: Creates the data entity shape using the shape from the data asset.
operationId: CreateEntityShape
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/ConnectionKey'
- $ref: '#/components/parameters/SchemaResourceName'
responses:
200:
description: Successfully created the data entity shape.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/EntityShape'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
412:
$ref: '#/components/responses/412'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a data entity shape using the shape from the data asset.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataEntity'
x-targetService: connectivity
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateEntityShapeDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateEntityShapeDetails'
description: The details needed to create the data entity shape.
required: true
/workspaces/{workspaceId}/copyObjectRequests:
get:
description: 'This endpoint can be used to get the list of copy object requests.
'
operationId: ListCopyObjectRequests
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/CopyStatusQueryParameter'
- $ref: '#/components/parameters/GetCopyObjectProjection'
- $ref: '#/components/parameters/TimeStartedQueryParam'
- $ref: '#/components/parameters/TimeEndedQueryParam'
responses:
'200':
description: List copy object requests
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/CopyObjectRequestSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected error.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: List copy object requests.
tags:
- DataIntegration
x-targetService: metadata
post:
description: 'Copy Metadata Object.
'
operationId: CreateCopyObjectRequest
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
'202':
description: Successfully accepted the copy object request.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/CopyObjectRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to copy object from one workspace to same/another workspace.
tags:
- DataIntegration
x-example: "Example: Copy objects from one workspace to another.\nPOST /20200430/workspaces/<workspace_id>/copyObjectRequests HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"sourceWorkspaceId\": \"source_workspace_id\",\n \"objectKeys\": [\n \"source_object_key\"\n ],\n \"copyConflictResolution\": {\n \"requestType\": \"RETAIN\"\n }\n}\n"
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateCopyObjectRequestDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateCopyObjectRequestDetails'
description: The details needed to copy metadata object.
required: true
/workspaces/{workspaceId}/copyObjectRequests/{copyObjectRequestKey}:
delete:
description: Delete copy object request using the specified identifier.
operationId: DeleteCopyObjectRequest
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/copyObjectRequestKey'
- $ref: '#/components/parameters/IfMatchHeader'
responses:
202:
description: Successfully accepted the delete request. The copy object request will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete copy object request.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
x-targetService: metadata-service
get:
description: 'This endpoint can be used to get the summary/details of object being copied.
'
operationId: GetCopyObjectRequest
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/copyObjectRequestKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Copy metadata object request summary/details.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/CopyObjectRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected error.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Get copy object request summary/details by key.
tags:
- DataIntegration
x-targetService: metadata
put:
description: Updates the status of a copy object request.
operationId: UpdateCopyObjectRequest
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/copyObjectRequestKey'
responses:
200:
description: Successfully accepted the update request. The copy object request will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/CopyObjectRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to change the status of a copy object request. For example, cancel a copy object request.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
x-targetService: metadata-service
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateCopyObjectRequestDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateCopyObjectRequestDetails'
description: The details needed to update the status of a copy object request.
required: true
/workspaces/{workspaceId}/countStatistics/{countStatisticKey}:
get:
description: "Retrieves statistics on a workspace. It returns an object with an array of property values, such as the number of projects, |\n applications, data assets, and so on.\n"
operationId: GetCountStatistic
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- description: A unique key of the container object, such as workspace, project, and so on, to count statistics for. The statistics is fetched for the given key.
in: path
name: countStatisticKey
required: true
schema:
type: string
responses:
200:
description: Successfully retreived a page of workspace statistics.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/CountStatistic'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list statistics on the workspace.
tags:
- DataIntegration
x-related-resource: '#/definitions/Project'
x-targetService: metadata-service
/workspaces/{workspaceId}/dataAssets:
get:
description: 'Retrieves a list of all data asset summaries.
'
operationId: ListDataAssets
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/TypeQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
200:
description: Successfully retrieved a list of data asset summaries.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/DataAssetSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get all the data asset summaries. Result can be filtered based on type of data asset by passing type query parameter.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataAsset'
x-targetService: connectivity
post:
description: Creates a data asset with default connection.
operationId: CreateDataAsset
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/CreateDataAssetDetails'
responses:
200:
description: Successfully created a data asset.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DataAsset'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a data asset with default connection.
tags:
- DataIntegration
x-example: "Example: Create an OCI Object Storage Data Asset.\nPOST /20200430/workspaces/<workspace_id>/dataAssets HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"name\": \"My Data Asset\",\n \"identifier\": \"MY_DATA_ASSET\",\n \"modelType\": \"ORACLE_OBJECT_STORAGE_DATA_ASSET\",\n \"defaultConnection\": {\n \"name\": \"Default connection\",\n \"identifier\": \"DEFAULT_CONNECTION\",\n \"modelType\": \"ORACLE_OBJECT_STORAGE_CONNECTION\"\n },\n \"ociRegion\": \"us-ashburn-1\",\n \"tenancyId\": \"ocid1.tenancy.oc1..tbd\",\n \"namespace\": \"your_namespace\"\n}\nExample: Create an OCI ADW Data Asset.\nPOST /20200430/workspaces/<workspace_id>/dataAssets HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"name\": \"My ADW Data Asset\",\n \"identifier\": \"MY_ADW_DATA_ASSET\",\n \"modelType\": \"ORACLE_ADWC_DATA_ASSET\",\n \"defaultConnection\": {\n \"name\": \"Default connection\",\n \"identifier\": \"DEFAULT_CONNECTION\",\n \"modelType\": \"ORACLE_ADWC_CONNECTION\",\n \"username\": \"YOURSCHEMA\",\n \"passwordSecret\": {\n \"secretConfig\": {\n \"secretId\": \"ocid1.vaultsecret.oc1.iad.tbd\",\n \"modelType\": \"OCI_VAULT_SECRET_CONFIG\"\n }\n },\n \"tnsAlias\": \"iadtest_high\"\n },\n \"walletSecret\": {\n \"secretConfig\": {\n \"modelType\": \"OCI_VAULT_SECRET_CONFIG\",\n \"secretId\": \"ocid1.vaultsecret.oc1.iad.tbd\"\n }\n },\n \"stagingDataAsset\": {\n \"modelType\": \"ORACLE_OBJECT_STORAGE_DATA_ASSET\",\n \"key\": \"your_object_storage_data_asset_key\"\n },\n \"stagingConnection\": {\n \"modelType\": \"ORACLE_OBJECT_STORAGE_CONNECTION\",\n \"key\": \"your_object_storage_connection_key\",\n \"name\": \"Default Connection\"\n },\n \"bucketSchema\": {\n \"modelType\": \"SCHEMA\",\n \"key\": \"dataref:your_object_storage_connection_key/your_bucket\"\n }\n}\n"
x-related-resource: '#/definitions/DataAsset'
x-targetService: connectivity
/workspaces/{workspaceId}/dataAssets/{dataAssetKey}:
delete:
description: Removes a data asset using the specified identifier.
operationId: DeleteDataAsset
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/DataAssetKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
204:
description: Successfully processed the delete request.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a data asset by key.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataAsset'
x-targetService: connectivity
get:
description: Retrieves details of a data asset using the specified identifier.
operationId: GetDataAsset
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/DataAssetKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved the specified data asset.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DataAsset'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get details of a data asset based on data asset key.
tags:
- DataIntegration
x-targetService: connectivity
put:
description: Updates a specific data asset with default connection.
operationId: UpdateDataAsset
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/DataAssetKey'
- $ref: '#/components/parameters/UpdateDataAssetDetails'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
responses:
200:
description: Successfully updated the data asset.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DataAsset'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update a data asset with default connection.
tags:
- DataIntegration
x-targetService: connectivity
/workspaces/{workspaceId}/dataFlowValidations:
get:
description: Retrieves a list of data flow validations within the specified workspace.
operationId: ListDataFlowValidations
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/KeyQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved a list of data flow validations.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/DataFlowValidationSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of data flow validations.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataFlowValidation'
post:
description: 'Accepts the data flow definition in the request payload and creates a data flow validation.
'
operationId: CreateDataFlowValidation
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully processed the validation request. The migration definition along with a list of validation results is returned.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DataFlowValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to execute a data flow validation.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataFlowValidation'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateDataFlowValidationDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateDataFlowValidationDetails'
description: The information needed to create the data flow validation for the data flow object.
required: true
/workspaces/{workspaceId}/dataFlowValidations/{dataFlowValidationKey}:
delete:
description: Removes a data flow validation using the specified identifier.
operationId: DeleteDataFlowValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/dataFlowValidationKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
204:
description: Successfully deleted the data flow validation.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a data flow validation.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataFlowValidation'
get:
description: Retrieves a data flow validation using the specified identifier.
operationId: GetDataFlowValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/dataFlowValidationKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved the specified data flow validation.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DataFlowValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to gets a data flow validation using the specified identifier.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataFlowValidation'
/workspaces/{workspaceId}/dataFlows:
get:
description: 'Retrieves a list of data flows in a project or folder.
'
operationId: ListDataFlows
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/FolderKeyQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
200:
description: Successfully retrieved a page of data flows.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/DataFlowSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of all data flows in a project or folder.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataFlow'
post:
description: 'Creates a new data flow in a project or folder ready for performing data integrations.
'
operationId: CreateDataFlow
parameters:
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully created a new data flow.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DataFlow'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a new data flow object for specifying the data transformations that need to performed.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataFlow'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateDataFlowDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateDataFlowDetails'
description: The details needed to create a new data flow.
required: true
/workspaces/{workspaceId}/dataFlows/{dataFlowKey}:
delete:
description: Removes a data flow from a project or folder using the specified identifier.
operationId: DeleteDataFlow
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/dataFlowKey'
responses:
202:
description: Successfully accepted the delete request. The data flow will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a data flow.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataFlow'
get:
description: Retrieves a data flow using the specified identifier.
operationId: GetDataFlow
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/dataFlowKey'
- $ref: '#/components/parameters/ExpandReferences'
responses:
200:
description: Successfully retrieved the specified data flow.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DataFlow'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a data flow.
tags:
- DataIntegration
put:
description: Updates a specific data flow.
operationId: UpdateDataFlow
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/dataFlowKey'
responses:
200:
description: Successfully accepted the update request. The data flow will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DataFlow'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update the data flow object identified by the key.
tags:
- DataIntegration
x-related-resource: '#/definitions/DataFlow'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateDataFlowDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateDataFlowDetails'
description: The details needed to updated a data flow.
required: true
/workspaces/{workspaceId}/disApplications:
get:
description: Retrieves a list of DIS Applications in a compartment and provides options to filter the list.
operationId: ListDisApplications
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/NameContainsQueryParameter'
- $ref: '#/components/parameters/IdentifierFilter'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PaginationLimitQueryParam'
- $ref: '#/components/parameters/PageNumberQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/FavoritesQueryParam'
- description: OCID of the compartment for which the list of DIS Applications is to be retrieved.
in: query
name: compartmentId
required: true
schema:
type: string
responses:
'200':
description: Successfully retrieved a list of applications.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/DisApplicationSummaryCollection'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to list DIS applications in a given compartment with filtering options.
tags:
- DataIntegration
x-related-resource: '#/definitions/DisApplication'
x-targetService: metadata
post:
description: 'Creates a DIS Application.
'
operationId: CreateDisApplication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
'200':
description: Successfully created the DIS application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DisApplication'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to create a DIS application.
tags:
- DataIntegration
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateDisApplicationDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateDisApplicationDetails'
description: The details needed to create a DIS application.
required: true
/workspaces/{workspaceId}/disApplications/{applicationKey}/detailedDescription:
delete:
description: Deletes detailed description of an Application.
operationId: DeleteDisApplicationDetailedDescription
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
responses:
202:
description: Successfully accepted the delete request. The detailed description will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete detailed description of an Application.
tags:
- DataIntegration
x-related-resource: '#/definitions/DetailedDescription'
x-targetService: metadata
get:
description: Retrieves detailed description of an Application.
operationId: GetDisApplicationDetailedDescription
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
responses:
200:
description: Successfully retrieved the detailed description of specified Application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DetailedDescription'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get the detailed description of an Application.
tags:
- DataIntegration
x-related-resource: '#/definitions/DetailedDescription'
x-targetService: metadata
post:
description: Creates detailed description for an application.
operationId: CreateDisApplicationDetailedDescription
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
'200':
description: Successfully created detailed description for an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DetailedDescription'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to create detailed description for an application.
tags:
- DataIntegration
x-related-resource: '#/definitions/DetailedDescription'
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateDetailedDescriptionDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateDetailedDescriptionDetails'
description: Detailed description of an application.
required: true
put:
description: Updates the detailed description of an Application.
operationId: UpdateDisApplicationDetailedDescription
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/applicationKey'
responses:
200:
description: Successfully accepted the update request. The detailed description will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DetailedDescription'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to change the detailed description of an Application.
tags:
- DataIntegration
x-related-resource: '#/definitions/DetailedDescription'
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateDetailedDescriptionDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateDetailedDescriptionDetails'
description: The details needed to update the detailed description of Application.
required: true
/workspaces/{workspaceId}/disApplications/{disApplicationId}:
delete:
description: Removes a DIS application using the specified identifier.
operationId: DeleteDisApplication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/disApplicationId'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'204':
description: Successfully deleted the specified application.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
412:
$ref: '#/components/responses/412'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to delete a DIS application.
tags:
- DataIntegration
x-related-resource: '#/definitions/DisApplication'
x-targetService: metadata
get:
description: Retrieves an application using the specified OCID.
operationId: GetDisApplication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/disApplicationId'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully retrieved the DIS Application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DisApplication'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to get a DIS application.
tags:
- DataIntegration
x-targetService: metadata
put:
description: Updates a DIS Application.
operationId: UpdateDisApplication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/disApplicationId'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully updated an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DisApplication'
412:
$ref: '#/components/responses/412'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to update a DIS application.
tags:
- DataIntegration
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateDisApplicationDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateDisApplicationDetails'
description: The details needed to update an application.
required: true
/workspaces/{workspaceId}/disApplications/{disApplicationId}/actions/changeCompartment:
post:
description: 'Moves a DIS Application to a specified compartment.
'
operationId: ChangeDisApplicationCompartment
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/disApplicationId'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
202:
description: Successfully moved the DIS Application to the specified compartment.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'The [OCID](/iaas/Content/API/Concepts/identifiers.htm) of the work request. Use [GetWorkRequest](/api/#/en/workrequests/20160918/WorkRequest/GetWorkRequest)
with this ID to track the status of the request.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to move a DIS Application to reside in a specified compartment.
tags:
- DataIntegration
x-related-resource: '#/definitions/DisApplication'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ChangeDisApplicationCompartmentDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/ChangeDisApplicationCompartmentDetails'
description: The information needed to move a DIS Application to a specified compartment.
required: true
/workspaces/{workspaceId}/disApplications/{disApplicationId}/taskRunLineages:
get:
description: 'This endpoint can be used to list Task Run Lineages within a given time window.
'
operationId: ListDisApplicationTaskRunLineages
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/disApplicationId'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/FilterListQueryParameter'
- $ref: '#/components/parameters/TimeUpdatedGreaterThanQueryParam'
- $ref: '#/components/parameters/TimeUpdatedGreaterThanOrEqualToQueryParam'
- $ref: '#/components/parameters/TimeUpdatedLessThanQueryParam'
- $ref: '#/components/parameters/TimeUpdatedLessThanOrEqualToQueryParam'
responses:
200:
description: A page of TaskRunLineage objects.
headers:
opc-next-page:
description: 'For pagination of a list of `TaskRunLineage`s. If this header appears in the response, then this
is a partial list of TaskRunLineage. Include this value as the `page` parameter in a subsequent
GET request to get the next batch of TaskRunLineages.
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If
you need to contact Oracle about a particular request,
please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskRunLineageSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Lists Task Run Lineages with filtering options.
tags:
- DataIntegration
x-feature-id: Orchestration
x-related-resource: '#/definitions/TaskRunLineageSummaryCollection'
/workspaces/{workspaceId}/exportRequests:
get:
description: 'This endpoint can be used to get the list of export object requests.
'
operationId: ListExportRequests
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/ExportStatusQueryParameter'
- $ref: '#/components/parameters/GetExportObjectProjection'
- $ref: '#/components/parameters/TimeStartedQueryParam'
- $ref: '#/components/parameters/TimeEndedQueryParam'
responses:
200:
description: List export object requests.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ExportRequestSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: List export object requests.
tags:
- DataIntegration
x-targetService: metadata
post:
description: Export Metadata Object
operationId: CreateExportRequest
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
202:
description: Successfully accepted the export object request. Returned export object request summary.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ExportRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to export objects
tags:
- DataIntegration
x-example: "Example: Create an export of an object and overwrite the file.\nPOST /20200430/workspaces/<workspace_id>/exportRequests HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"bucketName\":\"your_bucket_name\",\n \"objectStorageRegion\":\"us-ashburn-1\",\n \"objectStorageTenancyId\":\"ocid1.tenancy.oc1..tbd\",\n \"fileName\":\"your_filename.zip\",\n \"areReferencesIncluded\":true,\n \"isObjectOverwriteEnabled\":true,\n \"objecKeys\":[\"your_object_key_to_export\"]\n}\n"
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateExportRequestDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateExportRequestDetails'
description: The details needed to export metadata object.
required: true
/workspaces/{workspaceId}/exportRequests/{exportRequestKey}:
delete:
description: 'Delete export object request using the specified identifier.
'
operationId: DeleteExportRequest
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/exportRequestKey'
- $ref: '#/components/parameters/IfMatchHeader'
responses:
204:
description: Successfully deleted the export request.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete export object request.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
x-targetService: metadata-service
get:
description: 'This endpoint can be used to get the summary/details of object being exported.
'
operationId: GetExportRequest
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/exportRequestKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Export metadata object request summary/details.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ExportRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Get export object request summary/details by key.
tags:
- DataIntegration
x-targetService: metadata
put:
description: Updates the status of a export object request.
operationId: UpdateExportRequest
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/exportRequestKey'
responses:
200:
description: Successfully updates the export request, typically to terminate the export.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ExportRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to change the status of a export object request. For example, cancel a export object request.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
x-targetService: metadata-service
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateExportRequestDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateExportRequestDetails'
description: The details needed to update the status of a export object request.
required: true
/workspaces/{workspaceId}/folders:
get:
description: 'Retrieves a list of folders in a project and provides options to filter the list.
'
operationId: ListFolders
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/AggregatorQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/NameContainsQueryParameter'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
200:
description: Successfully retrieved a page of folders.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/FolderSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list the folders in a project.
tags:
- DataIntegration
x-related-resource: '#/definitions/Folder'
x-targetService: metadata-service
post:
description: 'Creates a folder in a project or in another folder, limited to two levels of folders. |
Folders are used to organize your design-time resources, such as tasks or data flows.
'
operationId: CreateFolder
parameters:
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully created a folder.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Folder'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a folder.
tags:
- DataIntegration
x-related-resource: '#/definitions/Folder'
x-targetService: metadata-service
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateFolderDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateFolderDetails'
description: The details needed to create a folder.
required: true
/workspaces/{workspaceId}/folders/{folderKey}:
delete:
description: Removes a folder from a project using the specified identifier.
operationId: DeleteFolder
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/folderKey'
responses:
202:
description: Successfully accepted the delete request. The folder will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a `Folder` object.
tags:
- DataIntegration
x-related-resource: '#/definitions/Folder'
x-targetService: metadata-service
get:
description: Retrieves a folder using the specified identifier.
operationId: GetFolder
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/folderKey'
- $ref: '#/components/parameters/GetProjection'
responses:
200:
description: Successfully retrieved the specified folder.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Folder'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a folder using its key.
tags:
- DataIntegration
put:
description: Updates a specific folder.
operationId: UpdateFolder
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/folderKey'
responses:
200:
description: Successfully accepted the update request. The folder will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Folder'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update the `Folder` object identified by its key.
tags:
- DataIntegration
x-related-resource: '#/definitions/Folder'
x-targetService: metadata-service
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateFolderDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateFolderDetails'
description: The details needed to update a folder.
required: true
/workspaces/{workspaceId}/functionLibraries:
get:
description: 'Retrieves a list of function libraries in a project and provides options to filter the list.
'
operationId: ListFunctionLibraries
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/AggregatorQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
responses:
200:
description: Successfully retrieved a page of functionLibraries.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/FunctionLibrarySummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list the function libraries in a project.
tags:
- DataIntegration
x-related-resource: '#/definitions/FunctionLibrary'
post:
description: 'Creates a function library in a project or in another function library, limited to two levels of function libraries. |
FunctionLibraries are used to organize your design-time resources, such as tasks or data flows.
'
operationId: CreateFunctionLibrary
parameters:
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully created a functionLibrary.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/FunctionLibrary'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a function Library.
tags:
- DataIntegration
x-related-resource: '#/definitions/FunctionLibrary'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateFunctionLibraryDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateFunctionLibraryDetails'
description: The details needed to create a function Library.
required: true
/workspaces/{workspaceId}/functionLibraries/{functionLibraryKey}:
delete:
description: Removes a Function Library from a project using the specified identifier.
operationId: DeleteFunctionLibrary
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/functionLibraryKey'
responses:
204:
description: Successfully accepted the delete request. The Function Library is deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a `FunctionLibrary` object.
tags:
- DataIntegration
x-related-resource: '#/definitions/FunctionLibrary'
get:
description: Retrieves a Function Library using the specified identifier.
operationId: GetFunctionLibrary
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/functionLibraryKey'
- $ref: '#/components/parameters/GetProjection'
responses:
200:
description: Successfully retrieved the specified Function Library.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/FunctionLibrary'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a Function Library using its key.
tags:
- DataIntegration
put:
description: Updates a specific Function Library.
operationId: UpdateFunctionLibrary
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/functionLibraryKey'
responses:
200:
description: Successfully accepted the update request. The Function Library will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/FunctionLibrary'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update the `FunctionLibrary` object identified by its key.
tags:
- DataIntegration
x-related-resource: '#/definitions/FunctionLibrary'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateFunctionLibraryDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateFunctionLibraryDetails'
description: The details needed to update a FunctionL ibrary.
required: true
/workspaces/{workspaceId}/importRequests:
get:
description: 'This endpoint can be used to get the list of import object requests.
'
operationId: ListImportRequests
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/ImportStatusQueryParameter'
- $ref: '#/components/parameters/GetImportObjectProjection'
- $ref: '#/components/parameters/TimeStartedQueryParam'
- $ref: '#/components/parameters/TimeEndedQueryParam'
responses:
200:
description: List import object requests.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ImportRequestSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: List import object requests.
tags:
- DataIntegration
x-targetService: metadata
post:
description: Import Metadata Object
operationId: CreateImportRequest
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
202:
description: Successfully accepted the import object request. Returned import object request summary.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-work-request-id:
description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ImportRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to import an object
tags:
- DataIntegration
x-example: "Example: Create an import of a file and retain existing objects.\nPOST /20200430/workspaces/<workspace_id>/importRequests HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"bucketName\":\"your_bucket_name\",\n \"fileName\":\"your_filename.zip\",\n \"objectStorageTenancyId\":\"ocid1.tenancy.oc1..tbd\",\n \"objectStorageRegion\": \"us-ashburn-1\",\n \"objectKeyForImport\": null,\n \"importConflictResolution\": {\n \"importConflictResolutionType\": \"RETAIN\"\n }\n}\n"
x-targetService: metadata
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateImportRequestDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateImportRequestDetails'
description: The details needed to import metadata object.
required: true
/workspaces/{workspaceId}/importRequests/{importRequestKey}:
delete:
description: 'Delete import object request using the specified identifier.
'
operationId: DeleteImportRequest
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/importRequestKey'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/IfMatchHeader'
responses:
204:
description: Successfully deleted the import request.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete import object request.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
x-targetService: metadata-service
get:
description: 'This endpoint can be used to get the summary/details of object being imported.
'
operationId: GetImportRequest
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/importRequestKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
responses:
200:
description: Import metadata object request summary/details.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ImportRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Get import object request summary/details by key.
tags:
- DataIntegration
x-targetService: metadata
put:
description: Updates the status of a import object request.
operationId: UpdateImportRequest
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/importRequestKey'
responses:
200:
description: Successfully updates the import request, typically to terminate the import.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ImportRequest'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to change the status of a import object request. For example, cancel a import object request.
tags:
- DataIntegration
x-related-resource: '#/definitions/Workspace'
x-targetService: metadata-service
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateImportRequestDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateImportRequestDetails'
description: The details needed to update the status of a import object request.
required: true
/workspaces/{workspaceId}/pipelineValidations:
get:
description: Retrieves a list of pipeline validations within the specified workspace.
operationId: ListPipelineValidations
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/KeyQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved a list of pipeline validations.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/PipelineValidationSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of pipeline validations.
tags:
- DataIntegration
x-related-resource: '#/definitions/PipelineValidation'
post:
description: 'Accepts the data flow definition in the request payload and creates a pipeline validation.
'
operationId: CreatePipelineValidation
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully processed the validation request. The migration definition along with a list of validation results is returned.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/PipelineValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to execute a pipeline validation.
tags:
- DataIntegration
x-related-resource: '#/definitions/PipelineValidation'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreatePipelineValidationDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreatePipelineValidationDetails'
description: The information needed to create the data flow validation for the pipeline object.
required: true
/workspaces/{workspaceId}/pipelineValidations/{pipelineValidationKey}:
delete:
description: Removes a pipeline validation using the specified identifier.
operationId: DeletePipelineValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/pipelineValidationKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
204:
description: Successfully deleted the pipeline validation.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a pipeline validation.
tags:
- DataIntegration
x-related-resource: '#/definitions/PipelineValidation'
get:
description: Retrieves a pipeline validation using the specified identifier.
operationId: GetPipelineValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/pipelineValidationKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved the specified pipeline validation.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/PipelineValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to gets a pipeline validation using the specified identifier.
tags:
- DataIntegration
x-related-resource: '#/definitions/PipelineValidation'
/workspaces/{workspaceId}/pipelines:
get:
description: 'Retrieves a list of pipelines in a project or folder from within a workspace, the query parameter specifies the project or folder.
'
operationId: ListPipelines
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/AggregatorQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
200:
description: Successfully retrieved a page of pipelines.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/PipelineSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of all pipelines in a project or folder within a workspace.
tags:
- DataIntegration
x-related-resource: '#/definitions/Pipeline'
post:
description: 'Creates a new pipeline in a project or folder ready for performing task orchestration.
'
operationId: CreatePipeline
parameters:
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully created a new pipeline.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Pipeline'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a new pipeline object for specifying the orchestration operations that need to performed.
tags:
- DataIntegration
x-related-resource: '#/definitions/Pipeline'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreatePipelineDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreatePipelineDetails'
description: The details needed to create a new pipeline.
required: true
/workspaces/{workspaceId}/pipelines/{pipelineKey}:
delete:
description: Removes a pipeline from a project or folder using the specified identifier.
operationId: DeletePipeline
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/pipelineKey'
responses:
202:
description: Successfully accepted the delete request. The pipeline will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a pipeline.
tags:
- DataIntegration
x-related-resource: '#/definitions/Pipeline'
get:
description: Retrieves a pipeline using the specified identifier.
operationId: GetPipeline
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/pipelineKey'
- $ref: '#/components/parameters/ExpandReferences'
responses:
200:
description: Successfully retrieved the specified pipeline.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Pipeline'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a pipeline.
tags:
- DataIntegration
x-related-resource: '#/definitions/Pipeline'
put:
description: Updates a specific pipeline.
operationId: UpdatePipeline
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/pipelineKey'
responses:
200:
description: Successfully accepted the update request. The pipeline will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Pipeline'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update the pipeline object identified by the key.
tags:
- DataIntegration
x-related-resource: '#/definitions/Pipeline'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePipelineDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdatePipelineDetails'
description: The details needed to updated a pipeline.
required: true
/workspaces/{workspaceId}/projects:
get:
description: 'Retrieves a lists of projects in a workspace and provides options to filter the list.
'
operationId: ListProjects
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/NameContainsQueryParameter'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
200:
description: Successfully retrieved a page of projects.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ProjectSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list projects in the workspace.
tags:
- DataIntegration
x-related-resource: '#/definitions/Project'
x-targetService: metadata-service
post:
description: 'Creates a project. Projects are organizational constructs within a workspace that you use to organize your design-time resources, such as tasks or data flows. Projects can be organized into folders.
'
operationId: CreateProject
parameters:
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully created a project.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Project'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a project.
tags:
- DataIntegration
x-related-resource: '#/definitions/Project'
x-targetService: metadata-service
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateProjectDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateProjectDetails'
description: The details needed to create a project in a workspace.
required: true
/workspaces/{workspaceId}/projects/{projectKey}:
delete:
description: Removes a project from the workspace using the specified identifier.
operationId: DeleteProject
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/projectKey'
responses:
202:
description: Successfully accepted the delete request. The project will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a `Project` object.
tags:
- DataIntegration
x-related-resource: '#/definitions/Project'
x-targetService: metadata-service
get:
description: Retrieves a project using the specified identifier.
operationId: GetProject
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/projectKey'
- $ref: '#/components/parameters/GetProjection'
responses:
200:
description: Successfully retrieved the specified project.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Project'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a project using its key.
tags:
- DataIntegration
put:
description: Updates a specific project.
operationId: UpdateProject
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/projectKey'
responses:
200:
description: Successfully accepted the update request. The project will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Project'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update the `Project` object identified by the key.
tags:
- DataIntegration
x-related-resource: '#/definitions/Project'
x-targetService: metadata-service
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateProjectDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateProjectDetails'
description: The details needed to update a project.
required: true
/workspaces/{workspaceId}/taskValidations:
get:
description: 'Retrieves a list of task validations within the specified workspace.
'
operationId: ListTaskValidations
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/KeyQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved a list of task validations.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/TaskValidationSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of task validations.
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskValidation'
post:
description: Validates a specific task.
operationId: CreateTaskValidation
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/CreateTaskValidationDetails'
responses:
200:
description: Successfully validated the specified task.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskValidation'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
summary: Use this endpoint to validate a task.
tags:
- DataIntegration
/workspaces/{workspaceId}/taskValidations/{taskValidationKey}:
delete:
description: 'Removes a task validation using the specified identifier.
'
operationId: DeleteTaskValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/TaskValidationKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
204:
description: Successfully deleted the task validation.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a task validation.
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskValidation'
get:
description: 'Retrieves a task validation using the specified identifier.
'
operationId: GetTaskValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/TaskValidationKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved the specified validation.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/TaskValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a task validation using the specified identifier.
tags:
- DataIntegration
x-related-resource: '#/definitions/TaskValidation'
/workspaces/{workspaceId}/tasks:
get:
description: 'Retrieves a list of all tasks in a specified project or folder.
'
operationId: ListTasks
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/FolderKeyQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/KeyListQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/TypeListQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
200:
description: Successfully retrieved a page of tasks.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/TaskSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of all tasks in a specified project or folder.
tags:
- DataIntegration
x-related-resource: '#/definitions/Task'
post:
description: 'Creates a new task ready for performing data integrations. There are specialized types of tasks that include data loader and integration tasks.
'
operationId: CreateTask
parameters:
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully created the task.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Task'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a new task. Tasks can be data loading tasks or integration tasks.
tags:
- DataIntegration
x-example: "Example: Create a REST Task.\nPOST /20200430/workspaces/<workspace_id>/tasks HTTP/1.1\nHost: dataintegration.us-ashburn-1.oraclecloud.com\n<authorization and other headers>\n{\n \"modelType\": \"REST_TASK\",\n \"name\": \"Execute OCI POST API and Poll\",\n \"description\": \"Execute a POST REST API. This fits a very specific OCI pattern for REST calls. One thing to note, is that the attribute used in the poll is hard-wired right now as the attribute id in the response.\",\n \"identifier\": \"EXECUTE_OCI_POST_API_AND_POLL\",\n \"parameters\": [\n {\n \"modelType\": \"PARAMETER\",\n \"type\": \"Seeded:/typeSystems/PLATFORM/dataTypes/STRING\",\n \"configValues\": {\n \"configParamValues\": {\n \"length\": { \"intValue\": 255 }\n }\n },\n \"description\": \"\",\n \"defaultValue\": \"https://abc\",\n \"isInput\": true,\n \"isOutput\": false,\n \"name\": \"URL\",\n \"typeName\": \"STRING\"\n },\n {\n \"modelType\": \"PARAMETER\",\n \"key\": \"14154173-021f-4f6b-92f8-0757e8543a45\",\n \"type\": {\n \"modelType\": \"JAVA_TYPE\",\n \"javaTypeName\": \"com.oracle.dicom.model.dataformat.JsonText\"\n },\n \"description\": \"POST API Request Body\",\n \"isInput\": true,\n \"isOutput\": false,\n \"name\": \"REQUEST_BODY\",\n \"rootObjectDefaultValue\": {\n \"modelType\": \"JSON_TEXT\",\n \"encoded\": false,\n \"configValues\": {\n \"configParamValues\": {\n \"dataParam\": { \"stringValue\": \"{}\" }\n }\n }\n },\n \"typeName\": \"com.oracle.dicom.model.dataformat.JsonText\"\n },\n {\n \"modelType\": \"PARAMETER\",\n \"type\": \"Seeded:/typeSystems/PLATFORM/dataTypes/STRING\",\n \"configValues\": {\n \"configParamValues\": {\n \"length\": { \"intValue\": 255 }\n }\n },\n \"description\": \"\",\n \"defaultValue\": \"https://abc\",\n \"isInput\": true,\n \"isOutput\": false,\n \"name\": \"POLL_URL\",\n \"typeName\": \"STRING\"\n },\n {\n \"modelType\": \"PARAMETER\",\n \"key\": \"e9000971-ce45-4423-874f-719293fe41c4\",\n \"type\": {\n \"modelType\": \"JAVA_TYPE\",\n \"javaTypeName\": \"com.oracle.dicom.model.expression.Expression\"\n },\n \"description\": \"\",\n \"defaultValue\": \"SYS.RESPONSE_STATUS >= 200 AND SYS.RESPONSE_STATUS < 300\",\n \"isInput\": true,\n \"isOutput\": false,\n \"name\": \"SUCCESS_CONDITION\",\n \"typeName\": \"com.oracle.dicom.model.expression.Expression\"\n },\n {\n \"modelType\": \"PARAMETER\",\n \"key\": \"5088c60a-f85c-4741-94e5-5edf8bb4f9a5\",\n \"type\": {\n \"modelType\": \"JAVA_TYPE\",\n \"javaTypeName\": \"com.oracle.dicom.model.expression.Expression\"\n },\n \"description\": \"\",\n \"defaultValue\": \"CAST(json_path(SYS.RESPONSE_PAYLOAD, '$.lifecycleState') AS String) != 'SUCCEEDED' AND CAST(json_path(SYS.RESPONSE_PAYLOAD, '$.lifecycleState') AS String) != 'FAILED'\",\n \"isInput\": true,\n \"isOutput\": false,\n \"name\": \"POLL_CONDITION\",\n \"typeName\": \"com.oracle.dicom.model.expression.Expression\"\n }\n ],\n \"opConfigValues\": {\n \"configParamValues\": {\n \"successCondition\": { \"parameterValue\": \"e9000971-ce45-4423-874f-719293fe41c4\" }\n }\n },\n \"executeRestCallConfig\": {\n \"modelType\": \"REST_CALL_CONFIG\",\n \"key\": \"7b2af7c3-ca47-4724-ae6c-a20cf978d70f\",\n \"methodType\": \"POST\",\n \"requestHeaders\": { \"Content-Type\": \"application/json\" },\n \"configValues\": {\n \"configParamValues\": {\n \"requestURL\": { \"stringValue\": \"${URL}\" },\n \"requestPayload\": { \"parameterValue\": \"14154173-021f-4f6b-92f8-0757e8543a45\" }\n }\n }\n },\n \"cancelRestCallConfig\": {\n \"modelType\": \"REST_CALL_CONFIG\",\n \"methodType\": \"DELETE\"\n },\n \"pollRestCallConfig\": {\n \"modelType\": \"POLL_REST_CALL_CONFIG\",\n \"methodType\": \"GET\",\n \"configValues\": {\n \"configParamValues\": {\n \"pollMaxDuration\": { \"objectValue\": 120 },\n \"pollMaxDurationUnit\": { \"stringValue\": \"SECONDS\" },\n \"pollInterval\": { \"objectValue\": 60 },\n \"pollIntervalUnit\": { \"stringValue\": \"SECONDS\" },\n \"requestURL\": { \"stringValue\": \"${POLL_URL}\" },\n \"pollCondition\": { \"parameterValue\": \"5088c60a-f85c-4741-94e5-5edf8bb4f9a5\" }\n }\n }\n },\n \"typedExpressions\": [\n {\n \"modelType\": \"TYPED_EXPRESSION\",\n \"type\": \"Seeded:/typeSystems/PLATFORM/dataTypes/VARCHAR\",\n \"configValues\": {\n \"configParamValues\": {\n \"length\": { \"intValue\": 2000 }\n }\n },\n \"expression\": \"CAST(json_path(SYS.RESPONSE_PAYLOAD, '$.id') AS String)\\t\",\n \"name\": \"ID\"\n }\n ],\n \"apiCallMode\": \"ASYNC_GENERIC\",\n \"authConfig\": {\n \"modelType\": \"OCI_RESOURCE_AUTH_CONFIG\",\n \"resourcePrincipalSource\": \"WORKSPACE\"\n },\n \"registryMetadata\": {\n \"aggregatorKey\": \"your_project_key\"\n } \n}\n"
x-related-resource: '#/definitions/Task'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateTaskDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateTaskDetails'
description: The details needed to create a new task.
required: true
/workspaces/{workspaceId}/tasks/{taskKey}:
delete:
description: Removes a task using the specified identifier.
operationId: DeleteTask
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
responses:
202:
description: Successfully accepted the delete request. The task will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a task.
tags:
- DataIntegration
x-related-resource: '#/definitions/Task'
get:
description: Retrieves a task using the specified identifier.
operationId: GetTask
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/ExpandReferences'
responses:
200:
description: Successfully retrieved the specified task.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Task'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a task.
tags:
- DataIntegration
put:
description: Updates a specific task. For example, you can update the task description or move the task to a different folder by changing the `aggregatorKey` to a different folder in the registry.
operationId: UpdateTask
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
responses:
200:
description: Sucessfully accepted the update request. The task will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Task'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update a task.
tags:
- DataIntegration
x-related-resource: '#/definitions/Task'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateTaskDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateTaskDetails'
description: The details needed to update a task.
required: true
/workspaces/{workspaceId}/tasks/{taskKey}/externalPublicationValidations:
get:
description: 'Retrieves a lists of external publication validations in a workspace and provides options to filter the list.
'
operationId: ListExternalPublicationValidations
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
responses:
200:
description: Successfully retrieved a page of external publication validations.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ExternalPublicationValidationSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to list external publication validations in the workspace.
tags:
- DataIntegration
x-related-resource: '#/definitions/ExternalPublicationValidation'
x-targetService: metadata-service
post:
description: Validates a specific task.
operationId: CreateExternalPublicationValidation
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
200:
description: Successfully validated the specified task.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ExternalPublicationValidation'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
summary: Use this endpoint to validate a task that is externally published to OCI DataFlow.
tags:
- DataIntegration
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateExternalPublicationValidationDetails'
description: The information needed to create a task validation.
required: true
/workspaces/{workspaceId}/tasks/{taskKey}/externalPublicationValidations/{externalPublicationValidationKey}:
delete:
description: 'Removes a task validation using the specified identifier.
'
operationId: DeleteExternalPublicationValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/externalPublicationValidationKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
204:
description: Successfully deleted the task validation.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a task validation.
tags:
- DataIntegration
x-related-resource: '#/definitions/ExternalPublicationValidation'
get:
description: Retrieves an external publication validation using the specified identifier.
operationId: GetExternalPublicationValidation
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/externalPublicationValidationKey'
responses:
200:
description: Successfully retrieved the specified external publication validation.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ExternalPublicationValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a project using its key.
tags:
- DataIntegration
/workspaces/{workspaceId}/tasks/{taskKey}/externalPublications:
get:
description: Retrieves a list of external publications in an application and provides options to filter the list.
operationId: ListExternalPublications
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageNumberQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
'200':
description: Successfully retrieved a list of publications in an OCI DataFlow application.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ExternalPublicationSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to list external publication objects with filtering options.
tags:
- DataIntegration
x-related-resource: '#/definitions/ExternalPublication'
post:
description: Publish a DataFlow in a OCI DataFlow application.
operationId: CreateExternalPublication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
responses:
'200':
description: Successfully created an externalObject in an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ExternalPublication'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to publish a task in a OCI Data Flow Application.
tags:
- DataIntegration
x-related-resource: '#/definitions/ExternalPublication'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateExternalPublicationDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateExternalPublicationDetails'
description: Details needed to publish a task to OCI DataFlow application.
required: true
/workspaces/{workspaceId}/tasks/{taskKey}/externalPublications/{externalPublicationsKey}:
delete:
description: Removes a published object using the specified identifier.
operationId: DeleteExternalPublication
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/externalPublicationsKey'
responses:
202:
description: Successfully accepted the delete request. The patch will be deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a published object.
tags:
- DataIntegration
x-related-resource: '#/definitions/ExternalPublication'
get:
description: Retrieves a publshed object in an task using the specified identifier.
operationId: GetExternalPublication
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/externalPublicationsKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: Successfully retrieved a patch in an application.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ExternalPublication'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Use this endpoint to get an externalPublished object in an application.
tags:
- DataIntegration
x-related-resource: '#/definitions/ExternalPublication'
put:
description: Updates the external publication object.
operationId: UpdateExternalPublication
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/taskKey'
- $ref: '#/components/parameters/externalPublicationsKey'
responses:
200:
description: Accepted the request. The external daatflow publication object will be updated.
headers:
etag:
description: For optimistic concurrency control. See `if-match`.
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If
you need to contact Oracle about a particular request,
please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ExternalPublication'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Update the external publication object identified by the key.
tags:
- DataIntegration
x-related-resource: '#/definitions/ExternalPublication'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateExternalPublicationDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateExternalPublicationDetails'
description: The information to be updated.
required: true
/workspaces/{workspaceId}/templates:
get:
description: This endpoint can be used to list application templates with filtering options.
operationId: ListTemplates
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierFilter'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PaginationLimitQueryParam'
- $ref: '#/components/parameters/PageNumberQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: List of application templates.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/TemplateSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Lists application templates with filtering options.
tags:
- DataIntegration
x-related-resource: '#/definitions/Template'
/workspaces/{workspaceId}/templates/{templateId}:
get:
description: This endpoint can be used to get an application template using a key.
operationId: GetTemplate
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/templateId'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
'200':
description: An application template.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Template'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
description: Unexpected Error.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorDetails'
summary: Gets an application template.
tags:
- DataIntegration
/workspaces/{workspaceId}/userDefinedFunctionValidations:
get:
description: Retrieves a list of UserDefinedFunctionvalidations within the specified workspace.
operationId: ListUserDefinedFunctionValidations
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/KeyQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved a list of UserDefinedFunction validations.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/UserDefinedFunctionValidationSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of UserDefinedFunction validations.
tags:
- DataIntegration
x-related-resource: '#/definitions/UserDefinedFunctionValidation'
post:
description: 'Accepts the UserDefinedFunction definition in the request payload and creates a UserDefinedFunction validation.
'
operationId: CreateUserDefinedFunctionValidation
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully processed the validation request. The validation results are returned.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/UserDefinedFunctionValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to execute a UserDefinedFunction validation.
tags:
- DataIntegration
x-related-resource: '#/definitions/UserDefinedFunctionValidation'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateUserDefinedFunctionValidationDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateUserDefinedFunctionValidationDetails'
description: The information needed to create the UserDefinedFunction validation for the UserDefinedFunction object.
required: true
/workspaces/{workspaceId}/userDefinedFunctionValidations/{userDefinedFunctionValidationKey}:
delete:
description: Removes a UserDefinedFunction validation using the specified identifier.
operationId: DeleteUserDefinedFunctionValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/userDefinedFunctionValidationKey'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
204:
description: Successfully deleted the UserDefinedFunction validation.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a UserDefinedFunction validation.
tags:
- DataIntegration
x-related-resource: '#/definitions/UserDefinedFunctionValidation'
get:
description: Retrieves a UserDefinedFunction validation using the specified identifier.
operationId: GetUserDefinedFunctionValidation
parameters:
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/userDefinedFunctionValidationKey'
- $ref: '#/components/parameters/RequestIdHeader'
responses:
200:
description: Successfully retrieved the specified UserDefinedFunction validation.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/UserDefinedFunctionValidation'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to gets a UserDefinedFunction validation using the specified identifier.
tags:
- DataIntegration
x-related-resource: '#/definitions/UserDefinedFunctionValidation'
/workspaces/{workspaceId}/userDefinedFunctions:
get:
description: 'Retrieves a list of UserDefinedFunctions in a function library.
'
operationId: ListUserDefinedFunctions
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/FunctionLibraryKeyQueryParam'
- $ref: '#/components/parameters/FieldsQueryParam'
- $ref: '#/components/parameters/NameQueryParam'
- $ref: '#/components/parameters/IdentifierListQueryParam'
- $ref: '#/components/parameters/LimitQueryParam'
- $ref: '#/components/parameters/PageQueryParam'
- $ref: '#/components/parameters/SortOrderQueryParam'
- $ref: '#/components/parameters/SortByQueryParam'
- $ref: '#/components/parameters/FavoritesQueryParam'
responses:
200:
description: Successfully retrieved a page of UserDefinedFunctions.
headers:
opc-next-page:
description: 'Retrieves the next page of results. When this header appears in the response, additional pages of results remain. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-prev-page:
description: 'Retrieves the previous page of results. When this header appears in the response, previous pages of results exist. See [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
opc-total-items:
description: 'Total items in the entire list.
'
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/UserDefinedFunctionSummaryCollection'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a list of all UserDefinedFunctions in a project or function library.
tags:
- DataIntegration
x-related-resource: '#/definitions/UserDefinedFunction'
post:
description: 'Creates a new UserDefinedFunction in a function library ready for performing data integrations.
'
operationId: CreateUserDefinedFunction
parameters:
- $ref: '#/components/parameters/RetryTokenHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
responses:
200:
description: Successfully created a new UserDefinedFunction.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/UserDefinedFunction'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
409:
$ref: '#/components/responses/409'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to create a new UserDefinedFunction object for specifying the data transformations that need to performed.
tags:
- DataIntegration
x-related-resource: '#/definitions/UserDefinedFunction'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateUserDefinedFunctionDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateUserDefinedFunctionDetails'
description: The details needed to create a new UserDefinedFunction.
required: true
/workspaces/{workspaceId}/userDefinedFunctions/{userDefinedFunctionKey}:
delete:
description: Removes a UserDefinedFunction from a function library using the specified identifier.
operationId: DeleteUserDefinedFunction
parameters:
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/userDefinedFunctionKey'
responses:
204:
description: Successfully accepted the delete request. The UserDefinedFunction is deleted.
headers:
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to delete a UserDefinedFunction.
tags:
- DataIntegration
x-related-resource: '#/definitions/UserDefinedFunction'
get:
description: Retrieves a UserDefinedFunction using the specified identifier.
operationId: GetUserDefinedFunction
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/userDefinedFunctionKey'
responses:
200:
description: Successfully retrieved the specified UserDefinedFunction.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/UserDefinedFunction'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to get a UserDefinedFunction.
tags:
- DataIntegration
put:
description: Updates a specific UserDefinedFunction.
operationId: UpdateUserDefinedFunction
parameters:
- $ref: '#/components/parameters/RequestIdHeader'
- $ref: '#/components/parameters/IfMatchHeader'
- $ref: '#/components/parameters/workspaceId'
- $ref: '#/components/parameters/userDefinedFunctionKey'
responses:
200:
description: Successfully accepted the update request. The UserDefinedFunction will be updated.
headers:
etag:
description: 'For optimistic concurrency control. See [ETags for Optimistic Concurrency Control](/iaas/Content/API/Concepts/usingapi.htm#eleven).
'
schema:
type: string
opc-request-id:
description: 'Unique Oracle-assigned identifier for the request. If you need to contact
Oracle about a particular request, please provide the request ID.
'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/UserDefinedFunction'
400:
$ref: '#/components/responses/400'
401:
$ref: '#/components/responses/401'
404:
$ref: '#/components/responses/404'
412:
$ref: '#/components/responses/412'
429:
$ref: '#/components/responses/429'
500:
$ref: '#/components/responses/500'
default:
$ref: '#/components/responses/DefaultError'
summary: Use this endpoint to update the UserDefinedFunction object identified by the key.
tags:
- DataIntegration
x-related-resource: '#/definitions/UserDefinedFunction'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateUserDefinedFunctionDetails'
multipart/form-data:
schema:
$ref: '#/components/schemas/UpdateUserDefinedFunctionDetails'
description: The details needed to updated a UserDefinedFunction.
required: true
components:
parameters:
NameQueryParam:
description: Used to filter by the name of the object.
in: query
name: name
required: false
x-default-description: If no name filter is specified, all names will be processed.
schema:
type: string
TimeUpdatedLessThanQueryParam:
description: This parameter allows users to get objects which were updated before a certain time. The format of timeUpatedLessThan is "YYYY-MM-dd'T'HH:mm:ss.SSS'Z'"
in: query
name: timeUpatedLessThan
required: false
x-default-description: If no TimeUpdatedLessThanQueryParam is specified, then all Objects are considered irrespective of the time they are updated.
schema:
type: string
format: date-time
IfMatchHeader:
description: 'For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the `etag` from a previous GET or POST response for that resource.
The resource will be updated or deleted only if the `etag` you provide matches the resource''s current `etag` value.
When ''if-match'' is provided and its value does not exactly match the ''etag'' of the resource on the server, the request fails with the 412 response code.
'
in: header
name: if-match
required: false
schema:
type: string
taskKey:
description: The task key.
in: path
name: taskKey
required: true
schema:
type: string
maxLength: 36
minLength: 1
ConnectionValidationKey:
description: The key of the connection validation.
in: path
name: connectionValidationKey
required: true
schema:
type: string
maxLength: 36
minLength: 1
AggregatorKeyCompositeStateQueryParam:
description: Unique key of the aggregator for which we want to get the Composite State
in: query
name: aggregatorKey
required: true
schema:
type: string
TaskValidationKey:
description: The task validation key.
in: path
name: taskValidationKey
required: true
schema:
type: string
maxLength: 36
minLength: 1
LifecycleStateQueryParam:
description: The lifecycle state of a resource. When specified, the operation only returns resources that match the given lifecycle state. When not specified, all lifecycle states are processed as a match.
in: query
name: lifecycleState
required: false
x-default-description: If not specified in query, all lifecycle states are processed as a match.
x-obmcs-enumref: '#/definitions/Workspace/lifecycleState'
schema:
type: string
TypeFilter:
description: 'Used to filter by the object type of the object.
It can be suffixed with an optional filter operator InSubtree.
For Data Integration APIs, a filter based on type Task is used.
'
in: query
name: type
required: false
style: form
explode: true
schema:
type: array
items:
type: string
default: []
FieldsQueryParam:
description: Specify the value 'metadata' to retrieve minimal information for example when listing published objects. This uses fewer system resources, leading to faster retrieval times.
in: query
name: fields
required: false
style: form
explode: true
schema:
type: array
items:
type: string
default: []
QuiesceTimeoutQueryParam:
description: Used to set the timeout for Data Integration to gracefully close down any running jobs before stopping the workspace.
in: query
name: quiesceTimeout
required: false
schema:
type: integer
format: int64
default: 0
minimum: 0
TimeUpdatedGreaterThanQueryParam:
description: This parameter allows users to get objects which were updated after a certain time. The format of timeUpdatedGreaterThan is "YYYY-MM-dd'T'HH:mm:ss.SSS'Z'"
in: query
name: timeUpdatedGreaterThan
required: false
x-default-description: If no TimeUpdatedGreaterThanQueryParam is specified, then all Objects are considered irrespective of the time they are updated.
schema:
type: string
format: date-time
AggregatorTypeListQueryParam:
description: Unique type of the aggregator
in: query
name: aggregatorType
required: false
x-default-description: No aggregator type filter, all types will be processed.
style: form
explode: true
schema:
type: array
items:
type: string
default: []
TimeUpdatedGreaterThanOrEqualToQueryParam:
description: This parameter allows users to get objects which were updated after and at a certain time. The format of timeUpdatedGreaterThanOrEqualTo is "YYYY-MM-dd'T'HH:mm:ss.SSS'Z'"
in: query
name: timeUpdatedGreaterThanOrEqualTo
required: false
x-default-description: If no TimeUpdatedGreaterThanOrEqualToQueryParam is specified, then all Objects are considered irrespective of the time they are updated.
schema:
type: string
format: date-time
TypeListQueryParam:
description: Used to filter by the object type of the object. It can be suffixed with an optional filter operator InSubtree. If this operator is not specified, then exact match is considered.
Examples: