Build and Configure Continuous Integration Projects
Create a target dataset for a pipeline
Creates a target dataset for a specified pipeline by providing a set of table mapping IDs. This endpoint submits an asynchronous dataset-creation request.
Process overview:
- Resource validation - validates that the pipeline exists and belongs to the provided project. If validation fails, the request will be rejected.
- Request validation - validates that at least one table mapping ID is provided. The IDs must reference existing table mappings in the pipeline.
- Table mapping retrieval - fetches the actual table mapping details from the pipeline based on the provided IDs. The handler determines the appropriate creation strategy based on the target connection type.
- Async submission - Dataset creation is performed asynchronously;
- Monitoring - on successful submission the endpoint returns 202 Accepted with a Location header that points to the dataset creation status endpoint. Clients should poll that endpoint to monitor progress and completion.
Behavior & semantics:
- Idempotency: repeated requests for the same pipeline and identical mapping IDs may be rejected as a conflict if a create operation is already in progress (409).
- Use the returned Location or the GET status endpoint to obtain the current dataset creation status.
Required Permissions: Either replication-pipeline::create or replication-pipeline::update when permission harmonization is enabled; otherwise, replication-pipeline::manage.
post/v1/integration/continuous/projects/{projectId}/pipelines/{pipelineId}/datasets
Request
- Base URL: https://integration-adapter.connect.cloud.precisely.com
- URL: https://integration-adapter.connect.cloud.precisely.com/v1/integration/continuous/projects/{projectId}/pipelines/{pipelineId}/datasets
- Auth: HTTP bearer
Path parameters
projectIdstring required
Unique identifier of the project containing the pipeline
pipelineIdstring required
Unique identifier of the pipeline
Request body
string[] required
Response
Dataset creation task submitted successfully. Use the Location header to monitor task status.
- Asynchronous Processing - Dataset creation is handled asynchronously; the response indicates task submission
- Task Monitoring - Use the provided Location URI to monitor the status of the dataset creation task
Changes
No recorded changes to this operation across all 1 revision of this API.