Orchestration
Manage your Artifacts, Tasks, Plans, Schedules, Environments, Workspaces, Promotions and all associated Ressources
Endpoints
-
https://api.eu.cloud.talend.com
URL for the AWS Europe region
-
https://api.ap.cloud.talend.com
URL for the AWS Asia Pacific region
-
https://api.us.cloud.talend.com
URL for the AWS United States East region
-
https://api.au.cloud.talend.com
URL for the AWS Australia region
-
https://api.us-west.cloud.talend.com
URL for the Azure United States West region
Security scheme
This scheme can be referenced across the API
Public
This Bearer authentication can be set in the Authorization header of your requests. Authentication tokens and Personal Access Tokens are supported. Personal Access Tokens can be generated in the Profile Preferences page of the Talend Cloud Portal.
| Name | Description |
|---|
Artifacts
Artifact
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Artifact identifier | string Required |
5cdd2ce2c737973f9d581b99 |
|||||||||
| name | Artifact name | string Required |
Test Artifact |
|||||||||
| type | Artifact type | string Required |
standard |
|||||||||
| versions | array of string Required |
|
||||||||||
| workspace | WorkspaceInfo Required |
ArtifactParameter
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| name | Parameter name | string Required |
parameter_url |
| value | Parameter value | string Optional |
localhost |
| type | Parameter value | string Required |
String |
| required | Is parameter required or not | boolean Required | |
| comment | Comment about parameter | string Optional |
parameter for test |
ArtifactRequest
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | Id of artifact | string Required |
5c1111d7a4186a4eafed0587 |
| version | Artifact version | string Required |
0.1.0 |
ArtifactVersion
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Id of artifact | string Required |
5c1111d7a4186a4eafed0587 |
|||||||||
| name | Name of artifact | string Optional |
Hello world artifact |
|||||||||
| version | Artifact version | string Required |
0.1.0 |
|||||||||
| type | Artifact type | string Required |
standard |
|||||||||
| publisher | Artifact publisher | string Required |
admin |
|||||||||
| marketplaceProduct | Marketplace product | string Required |
Talend Data Fabric (tp_bd_7.2.1.20190612_1410) |
|||||||||
| parameters | array of ArtifactParameter Required |
|
||||||||||
| workspace | WorkspaceInfo Required | |||||||||||
| description | Artifact description | string Optional |
This is test artifact |
|||||||||
| createDate | Artifact date of creation | datetime Required |
RFC3339 |
|||||||||
| repository | SourcesRepositoryData Optional | |||||||||||
| publisherType | Artifact publisher type | string Optional |
HUMAN |
PageArtifact
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| items | array of Artifact Optional |
|
||||||||||
| limit | integer Optional |
INT32 |
||||||||||
| offset | integer Optional |
INT32 |
||||||||||
| total | integer Optional |
INT32 |
Get available Artifacts
GET /orchestration/artifactsGet available Artifacts
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| environmentId | environment id | string Optional | |
| offset | the position of the first item. Must be greater than or equal to 0. Default value - 0 | integer Optional |
INT32 |
| workspaceId | workspace id | string Optional | |
| name | artifact name filter | string Optional | |
| limit | the number of items to return. Must be in range [1, 100]. Default value - 100 | integer Optional |
INT32 |
Response
500Status 500
Server error - something went wrong on server side
Body
application/json
Delete Artifact by id
DELETE /orchestration/artifacts/{artifactId}Delete Artifact by id
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| artifactId | artifact id | string Required |
Response
204Status 204
No content
Get Artifact by id
GET /orchestration/artifacts/{artifactId}Get Artifact by id
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| artifactId | artifact id | string Required |
Response
Get Artifact of a specified version
GET /orchestration/artifacts/{artifactId}/versions/{version}Get Artifact of a specified version
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| artifactId | artifact id | string Required | |
| version | artifact version | string Required |
Response
Delete Artifact of a specified version
DELETE /orchestration/artifacts/{artifactId}/versions/{version}Delete Artifact of a specified version
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| artifactId | artifact id | string Required | |
| version | artifact version | string Required |
Response
204Status 204
No content
Connections
UpdateConnectionRequest
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| name | Connection name | string Optional |
testConnection |
|||||||||
| parameters | array of ConnectionParameter Optional |
|
CreateConnectionRequest
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| name | Connection name | string Required |
testConnection |
|||||||||
| workspaceId | Workspace ID | string Required |
5b3ee8676e8f510dbb3fa806 |
|||||||||
| app | Application name | string Required |
Custom |
|||||||||
| parameters | array of ConnectionParameter Required |
|
ConnectionParameter
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| name | Parameter name | string Required |
param1 |
| value | Parameter value | string Optional |
value1 |
| encrypted | If encrypted or not | boolean Optional |
ConnectionDetails
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Connection ID | string Required | ||||||||||
| name | Connection name | string Required | ||||||||||
| app | Application name | string Required | ||||||||||
| createDate | Creation Date of Connection | datetime Required |
RFC3339 |
|||||||||
| parameters | array of ConnectionParameter Required |
|
||||||||||
| workspace | WorkspaceInfo Required |
PageConnection
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| items | array of ConnectionDetails Optional |
|
||||||||||
| limit | integer Optional |
INT32 |
||||||||||
| offset | integer Optional |
INT32 |
||||||||||
| total | integer Optional |
INT32 |
Create a Connection
POST /orchestration/connectionsResponse
Get available Connections
GET /orchestration/connectionsRequest
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| offset | integer Optional |
INT32 |
|
| name | string Optional | ||
| limit | integer Optional |
100 INT32 |
Response
Update a Connection
PUT /orchestration/connections/{connectionId}Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| connectionId | string Required |
Body
application/json
Response
Delete a Connection
DELETE /orchestration/connections/{connectionId}Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| connectionId | string Required |
Response
204Status 204
No Content
Get a Connection details
GET /orchestration/connections/{connectionId}Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| connectionId | string Required |
Response
Environments
EnvironmentInfo
An Environment is some uniquely named space allowing you to organize your workspaces and subsidiary jobs definition within the cloud platform.
Everything in TMC is related to an Environment : engines, workspaces, artifacts, tasks, plans, etc.
Default preconisation is to define Environments according to your Software Process life cycle, for instance Development, QA, Pre-Production, Production.
Workspace entity will allow you to organize your work within this Environment, according to your Business organization and security isolation rules.
Of course, you can already choose to define Environments as subparts of your IT, for instance ‘Production - Supply Chain’, and choose the right grain of organization.
Using Promotions, you would be able afterwards to define detailed rules for your software to be promoted across your Environments.
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | Unique identifier of the Environment | string Required |
57f64991e4b0b689a64feed3 |
| name | Functional name of the Environment | string Required |
Development |
| description | string Optional |
detailed environment description |
|
| maxCloudContainers | maximum number of cloud engines | integer Optional |
INT32 |
| default | boolean Optional |
Create Environment
POST /orchestration/environmentsCreate an Environment.
Requirements:
- environment name must be unique
- the user account issuing the request must be granted the ENVIRONMENT_MANAGEMENT permission
Environment is created on platform. A CUSTOM workspace is automatically created within this environment with proper ownership permissions assigned onto it.
Upon your request, Cloud Engine could also be assigned to the newly added environment.
Request
Body
application/json
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| name | Unique name for the environment to create | string Required |
Production - Asia - Development - Supply Chain |
| description | string Optional | ||
| maxCloudContainers | Number of Cloud Engines to assign to this Environment | integer Optional |
INT32 |
| workspaceName | Name for the custom workspace created along with the Environment | string Required | |
| owner | Login name of user to be owner of the custom workspace created along with the Environment | string Optional |
jSmith |
Response
400Status 400
Name provided is faulty
401Status 401
User has not the right credentials for completing creation
403Status 403
Status 403
409Status 409
environment name should be unique
500Status 500
Status 500
List Environments
GET /orchestration/environmentsRetrieve all the environments according to filters.
If the user is entitled with CLUSTER_MANAGEMENT or ENVIRONMENT_MANAGEMENT role, all environments matching query will be returned.
If the user is entitled with OPERATOR role, environments matching query and the user workspace permissions will be returned.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| query | search query (FIQL format), e.g. name==Dev*;description==*environment* | string Optional |
Response
200Status 200
List of candidate environments provided
Body
application/json
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| array of EnvironmentInfo |
|
|||||||||||
401Status 401
Status 401
403Status 403
Status 403
500Status 500
Status 500
Update Environment
PUT /orchestration/environments/{Id}Update the identified Environment.
Make sure the user is entitled with ENVIRONMENT_MANAGEMENT role.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| Id | string Required |
Body
application/json
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| name | string Required | ||
| description | string Optional | ||
| maxCloudContainers | integer Optional |
INT32 |
Response
204Status 204
Environment removed
401Status 401
User has not the required credentials
403Status 403
Environment is still in use, it shall not be removed
Body
application/json
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| Usage Details | Promotions and Engines still using this Environment | string Optional |
404Status 404
Environment is not present
409Status 409
Environment name should be unique
500Status 500
Status 500
Remove Environment
DELETE /orchestration/environments/{Id}Remove the identified Environment and all its subparts : workspaces, executables (tasks and plans), etc.
Make sure the user is entitled with ENVIRONMENT_MANAGEMENT role.
Environment in use won’t be removed : if any engine is assigned to this environment or if any promotion relates to this environment, removal is not achieved.
**Please make sure Environment removal is confirmed before calling this endpoint as removal will be cascading all subsidiary elements within the environment : workspaces, tasks, plans, etc. With no cancellation service available. **
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| Id | string Required |
Response
204Status 204
Environment removed
400Status 400
“To delete the environment, you must remove or re-assign its engine(s) to another environment.” or
“Cannot delete environment: it is used in promotions(s)”
401Status 401
User has not the required credentials
403Status 403
Environment is still in use, it shall not be removed
Body
application/json
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| Usage Details | Promotions and Engines still using this Environment | string Optional |
404Status 404
Environment is not present
500Status 500
Status 500
Workspaces
Workspace
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | Workspace identifier | string Required |
57f64991e4b0b689a64feed2 |
| name | Workspace name | string Required |
Personal |
| description | Workspace description | string Optional |
workspace detail description |
| createDate | Date of creation of the workspace | datetime Required |
RFC3339 |
| updateDate | Date of update of the workspace | datetime Required |
RFC3339 |
| owner | Owner of the workspace | string Optional |
admin |
| ownerFullName | Full name of the workspace owner | string Required | |
| type | Workspace type | string Required |
|
| environmentId | Environment id of the workspace | string Required |
WorkspaceInfo
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | Workspace identifier | string Optional |
57f64991e4b0b689a64feed2 |
| name | Workspace name | string Optional |
Personal |
| description | Workspace description | string Optional |
workspace detail description |
| owner | Workspace owner | string Optional |
admin |
| type | Workspace type | string Optional |
custom |
| environment | EnvironmentInfo Optional | ||
| protectedArtifactUpdate | Allows to restrict the scope of task updates when a new artifact version is published.
|
boolean Optional |
CreateWorkspaceRequest
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| name | Name of the workspace to be created | string Required | |
| description | Functional description of your workspace | string Optional | |
| owner | Login name of the owner of the workspace | string Optional |
fDupont |
| environmentId | Environment this workspace will belong to | string Required |
Create Workspace
POST /orchestration/workspacesCreate a Workspace.
Please ensure the following requirements are met :
- provide environment this workspace will belong to
- provide some unique naming within environment
- user must be granted ENVIRONMENT_MANAGEMENT permission
Owner can be provided. By default, creator user would be owner. Type is Custom.
Response
400Status 400
Status 400
401Status 401
Status 401
403Status 403
Status 403
500Status 500
Status 500
List Workspaces
GET /orchestration/workspacesRetrieve all the workspaces according to filters.
If the user is entitled with CLUSTER_MANAGEMENT or ENVIRONMENT_MANAGEMENT role, all workspaces matching query will be returned.
If the user is entitled with OPERATOR role, workspaces matching query and the workspace permissions will be returned.
Use cases
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| query | This parameter defines a search query in FIQL format. The Feed Item Query Language is a syntax for expressing filters across the entries. | string Optional |
name==TestWorkspace,environment.name==TestEnvironment |
Response
200Status 200
Status 200
Body
application/json
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| array of WorkspaceInfo |
|
|||||||||||
401Status 401
Status 401
403Status 403
Status 403
500Status 500
Status 500
Remove Workspace
DELETE /orchestration/workspaces/{id}Remove the Workspace and all its subparts : executables (tasks and plans), permissions, etc.
Make sure the user is entitled with ENVIRONMENT_MANAGEMENT role.
Custom Workspaces only can be removed using this API. (Shared and Personal are linked either to Environment or User’s life cycle)
Workspace in use won’t be removed : if any task, artifact, resource, connection is used in any other workspace, removal is not achieved. Please make sure Workspace removal is confirmed before calling this endpoint as removal will be cascading all subsidiary elements within. With no cancellation service available.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | string Required |
Response
204Status 204
Status 204
401Status 401
Status 401
403Status 403
Status 403
404Status 404
Status 404
409Status 409
There are objects in custom workspace that could not be removed
Update Workspace
PUT /orchestration/workspaces/{id}Update the identified Workspace.
Make sure the user is entitled with ENVIRONMENT_MANAGEMENT role.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | string Required |
Body
application/json
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| name | string Required | ||
| description | string Optional | ||
| owner | string Optional | ||
| protectedArtifactUpdate | Allows to restrict the scope of task updates when a new artifact version is published.
|
boolean Optional |
Response
204Status 204
Status 204
400Status 400
Status 400
401Status 401
Status 401
403Status 403
Status 403
404Status 404
Status 404
500Status 500
Status 500
Plans
Step
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Step id | string Optional |
9af64991e4b0b689a64feed0 |
|||||||||
| name | Step name | string Required |
Step 1 |
|||||||||
| condition | Expected status of successful step | string Required |
|
|||||||||
| taskIds | array of string Required |
|
||||||||||
| handlerOnFailure | StepErrorHandler Optional | |||||||||||
| note | Description to rerun a plan execution from this step | string Optional |
Clear the database for users |
StepErrorHandler
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| taskIds | array of string Optional |
|
||||||||||
| planIds | array of string Optional |
|
Plan
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Resource id | string Required |
5cdd2ce2c737973f9d581b98 |
|||||||||
| name | Resource name | string Required |
Remote Engine |
|||||||||
| description | Resource description | string Optional |
Some description |
|||||||||
| workspace | WorkspaceInfo Optional | |||||||||||
| createDate | Date of creation of the resource | datetime Required |
RFC3339 |
|||||||||
| updateDate | Date of updating of the resource | datetime Optional |
RFC3339 |
|||||||||
| author | Plan author | string Required |
operator123 |
|||||||||
| steps | array of Step Required |
|
||||||||||
| authorType | Plan author type | string Optional |
|
PlanExecutableDetails
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| executable | Executable identifier | string Required |
57f64991e4b0b689a64feed0 |
| name | Executable name | string Required |
simple executable |
| workspace | WorkspaceInfo Optional | ||
| description | Executable description | string Optional |
plan detail description |
| chart | PlanStep Optional | ||
| status | Plan execution status | string Optional |
|
| planPauseDetails | PlanPauseDetails Optional |
PlanRequest
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| name | Plan name | string Required |
Plan 1 |
|||||||||
| workspaceId | Plan workspace | string Required |
57f64991e4b0b689a64feed2 |
|||||||||
| description | Plan description | string Optional |
Some description |
|||||||||
| steps | array of Step Required |
|
PlanStep
Plan Steps for work with required tasks.
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Id of Plan Step | string Optional | ||||||||||
| abstractStepId | Abstract id of the Step | string Optional | ||||||||||
| name | Step name | string Optional | ||||||||||
| status | Status of the current step | string Optional |
|
|||||||||
| stepOnException | PlanStep Optional | |||||||||||
| nextStep | PlanStep Optional | |||||||||||
| flows | array of PlanTask Optional |
|
||||||||||
| note | Note, added to the current step | string Optional | ||||||||||
| taskIds | array of string Optional |
|
PlanTask
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | Id of the current plan task | string Optional | |
| name | Name of the current plan task | string Optional | |
| version | Version of the current plan task | string Optional | |
| description | Plan task description | string Optional | |
| destination | Destination of the the current plan task | string Optional | |
| workspaceId | Id of the plan task’s workspace | string Optional | |
| abstractPlanId | Id of the abstract plan | string Optional | |
| artifact | BaseArtifactVersion Optional | ||
| taskPauseDetails | TaskPauseDetails Optional |
PlanRunConfig
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| trigger | Trigger Required | ||
| parallelExecutionAllowed | Indicates whether this executable is allowed to run in parallel. ‘false’ by default | boolean Optional |
ExecutionStep
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| stepId | string Optional | |||||||||||
| abstractStepId | string Optional | |||||||||||
| stepName | string Optional | |||||||||||
| status | string Optional |
|
||||||||||
| stepOnException | ExecutionStep Optional | |||||||||||
| nextStep | ExecutionStep Optional | |||||||||||
| flows | array of ExecutionFlow Optional |
|
||||||||||
| stepNote | string Optional |
ExecutionFlow
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | Id of current execution flow | string Optional | |
| name | Name of current execution flow | string Optional | |
| version | Version of current execution flow | string Optional | |
| description | Execution flow description | string Optional | |
| destination | Destination of current flow | string Optional | |
| workspaceId | string Optional | ||
| abstractPlanId | string Optional | ||
| plan | boolean Optional | ||
| artifactShortVersion | ArtifactVersion Optional | ||
| upgradeInfo | UpgradeInfo Optional | ||
| jobType | string Optional |
|
|
| pauseDetails | PauseDetails Optional |
PlanPauseDetails
Contains status of Plan regarding Pause/Resume capacity, as well as optional contextual explanation for the pause. You can use this context for audit purpose to link information on the IT event that led to this pause (eg. maintenance window for prod operation).
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| pause | If true, paused | boolean Required | |
| pauseContext | Plan pause description | string Optional | |
| user | User that took the action to pause | string Optional | |
| userType | UserType Optional | ||
| pauseDate | The date time when this pause started | datetime Optional |
RFC3339 |
PlanPauseDetails
{
"pause": true,
"pauseContext": "Pause for Monthly Prod Op #XYZ",
"pauseDate": "2023-01-13T14:42:58.341Z",
"user": "adminMasterX",
"userType": "HUMAN"
}PagePlan
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| items | array of PlanExecutableDetails Optional |
|
||||||||||
| limit | integer Optional |
INT32 |
||||||||||
| offset | integer Optional |
INT32 |
||||||||||
| total | integer Optional |
INT32 |
PauseDetails
Contains status regarding Pause/Resume capacity, as well as optional contextual explanation for the pause. You can use this context to link information on the production event that led to this pause (eg. maintenance window for prod operation).
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| pause | If true, paused | boolean Required | |
| pauseContext | Plan pause description | string Optional | |
| user | User that took the action to pause | string Optional | |
| userType | UserType Optional | ||
| pauseDate | The date time when this pause started | datetime Optional |
RFC3339 |
PauseDetails
{
"pause": true,
"pauseContext": "Pausing execution",
"pauseDate": "2023-01-13T14:42:58.341Z",
"user": "admin",
"userType": "HUMAN"
}Create Plan
POST /orchestration/executables/plansCreate Plan
Response
Get available Plans
GET /orchestration/executables/plansGet available Plans
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| environmentId | environment id | string Optional | |
| offset | the position of the first item. Must be greater than or equal to 0. Default value - 0 | integer Optional |
INT32 |
| workspaceId | workspace id | string Optional | |
| taskId | task Id | string Optional | |
| name | plan name filter | string Optional | |
| limit | the number of items to return. Must be in range [1, 100]. Default value - 100 | integer Optional |
INT32 |
| planId | plan id | string Optional |
Response
Delete Plan
DELETE /orchestration/executables/plans/{planId}Delete Plan
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| planId | executable ID | string Required |
Response
204Status 204
No Content
Get Plan details
GET /orchestration/executables/plans/{planId}Get Plan details
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| planId | executable ID | string Required |
Response
500Status 500
Server error - something went wrong on server side
Body
application/json
Update plan
PUT /orchestration/executables/plans/{planId}Update Plan
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| planId | executable ID | string Required |
Body
application/json
Response
Configure Plan execution
PUT /orchestration/executables/plans/{planId}/run-configConfigure Plan execution
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| planId | plan id | string Required |
Body
application/json
Response
Get Plan configuration
GET /orchestration/executables/plans/{planId}/run-configGet Plan configuration applied to your Plan executions.
Please take note :
- the Trigger definition can now have some new value ‘Multiple’ defined when you link your plan to some Multiple Time Trigger schedule.
- whenever such multiple trigger schedule is linked please use the new dedicated endpoints to manage this specific scheduling configuration.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| planId | plan id | string Required |
Response
Stop schedule for plan
DELETE /orchestration/executables/plans/{planId}/run-configStop schedule for plan
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| planId | plan id | string Required |
Response
204Status 204
No Content
Get plan scheduled triggers
GET /orchestration/executables/plans/{planId}/run-config/eventsGet plan triggers for cron schedules
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| planId | string Required |
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| offset | the position of the first item. Must be greater than or equal to 0. Default value - 0 | integer Optional |
INT32 |
| to | to date time (milliseconds) | string Required | |
| limit | the number of items to return. Must be in range [1, 100]. Default value - 100 | integer Optional |
INT32 |
| from | from date time (milliseconds) | string Optional |
Response
Pause-Resume Plan executions
PUT /orchestration/executables/plans/{planId}/pauseAllow to pause and resume plan executions
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| planId | string Required |
Body
application/json
Response
202Status 202
Status 202
204Status 204
Status 204
Projects
ProjectView
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | string Optional | ||
| name | string Optional | ||
| technicalLabel | string Optional | ||
| description | string Optional | ||
| url | string Optional | ||
| author | string Optional | ||
| owner | string Optional | ||
| projectType | string Optional |
|
|
| repoType | string Optional |
|
|
| createDate | datetime Optional |
RFC3339 |
|
| updateDate | datetime Optional |
RFC3339 |
ProjectCreateRequest
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| owner | Owner name | string Required |
John Doe |
| description | Project description | string Optional |
John Doe |
| url | Project url | string Required |
https://github.com/example/Example.git |
| name | Project name | string Required |
Hello world project |
ProjectRequest
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| owner | Owner name | string Optional |
John Doe |
| description | Project description | string Optional |
John Doe |
| url | Project url | string Optional |
https://github.com/example/Example.git |
SourcesRepositoryData
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| project | project name | string Required | |
| branch | repository branch | string Optional | |
| commit | RepositoryCommitData Optional |
RepositoryCommitData
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | commit id | string Required |
d8a1c8aac0365fb00f32c45ccbd07ad81fe9d60c |
| date | commit date time | datetime Required |
RFC3339 |
| author | commit author | string Required |
mpidhornyi <mpidhornyi@talend.com> |
PageProject
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| items | array of ProjectView Optional |
|
||||||||||
| limit | integer Optional |
INT32 |
||||||||||
| offset | integer Optional |
INT32 |
||||||||||
| total | integer Optional |
INT32 |
Create Project
POST /orchestration/projectsCreate Project
Please take note only PAT access is supported on this endpoint at current.
Response
Get Projects
GET /orchestration/projectsGet Projects
Please take note only PAT access is supported on this endpoint at current.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| projectName | project name filter | string Optional | |
| limit | the number of items to return. Must be in range [1, 100]. Default value - 100 | integer Optional |
INT32 |
| offset | the position of the first item. Must be greater than or equal to 0. Default value - 0 | integer Optional |
INT32 |
Response
Delete project
DELETE /orchestration/projects/{projectId}Delete project
Please take note only PAT access is supported on this endpoint at current.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| projectId | project ID | string Required |
Response
204Status 204
No Content
Get Project by id
GET /orchestration/projects/{projectId}Get Project by id
Please take note only PAT access is supported on this endpoint at current.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| projectId | project ID | string Required |
Response
Update Project
PUT /orchestration/projects/{projectId}Update Project
Please take note only PAT access is supported on this endpoint at current.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| projectId | project ID | string Required |
Body
application/json
Response
Projects Authorization
ProjectUserAuthResponse
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| projectId | string Optional | |||||||||||
| userIds | array of string Optional |
|
ProjectGroupAuthResponse
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| projectId | string Optional | |||||||||||
| groupIds | array of string Optional |
|
Promotions
AdvancedPromotionSpec
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| artifactId | Advanced Promotion Artifact Id | string Optional |
57f64991e4b0b689a64feed0 |
| artifactType | Advanced Promotion Artifact Type. In the following list of allowed values, ‘ACTION’ refers to Artifacts, ‘FLOW’ refers to Tasks, ‘PLAN’ refers to Plans and ‘WORKSPACE’ refers to Workspaces | string Optional |
WORKSPACE |
ArtifactPromotionResult
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Artifact ID | string Optional | ||||||||||
| targetId | Target Artifact ID | string Optional | ||||||||||
| name | Artifact Name | string Optional | ||||||||||
| type | Artifact Type | string Optional |
WORKSPACE |
|||||||||
| analyzeReport | Report Optional | |||||||||||
| promotionReport | Report Optional | |||||||||||
| usedBy | array of FlowPromotionResult Optional |
|
||||||||||
| targetVersion | Artifact Version In Target Environment | string Optional |
"0.1.1.20223008022926" |
|||||||||
| version | Artifact Version In Source Environment | string Optional |
"0.1.1.20223008022926" |
|||||||||
| versions | array of ArtifactPromotionResult Optional |
|
||||||||||
| jobType | Action Job Type | string Optional |
STANDARD |
|||||||||
| workspaceId | Promoted Artifact Workspace ID | string Optional | ||||||||||
| artifactId | Flow artifact name | string Optional |
FlowPromotionResult
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Artifact ID | string Optional | ||||||||||
| targetId | Target Artifact ID | string Optional | ||||||||||
| name | Artifact Name | string Optional | ||||||||||
| type | Artifact Type | string Optional |
WORKSPACE |
|||||||||
| analyzeReport | Report Optional | |||||||||||
| promotionReport | Report Optional | |||||||||||
| usedBy | array of FlowPromotionResult Optional |
|
||||||||||
| targetVersion | Promoted Flow Target Version | string Optional |
"1.1" |
|||||||||
| version | Source Flow Version | integer Optional |
INT32 1 |
|||||||||
| versions | array of ArtifactPromotionResult Optional |
|
||||||||||
| jobType | Flow Job Type | string Optional |
STANDARD |
|||||||||
| workspaceId | Promoted Flow Workspace ID | string Optional | ||||||||||
| artifactId | Flow artifact Id | string Optional |
UpdateDescriptionRequest
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| description | Promotion description | string Required |
This is new description |
PromotionExecutableDetails
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| executable | Executable identifier | string Required |
57f64991e4b0b689a64feed0 |
| name | Executable name | string Required |
simple executable |
| sourceEnvironment | EnvironmentInfo Optional | ||
| targetEnvironment | EnvironmentInfo Optional | ||
| description | Promotion description (not returned when querying a list of objects) | string Optional |
promotion detail description |
CreatePromotionRequest
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| sourceEnvironmentId | Source environment ID | string Required |
5b3ee8676e8f510dbb3fa806 |
| targetEnvironmentId | Target environment ID | string Required |
5b3ee8676e8f510dbb3fa807 |
| description | Promotion description | string Optional |
This is description |
TaskAutoUpgradeRequest
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| workspaceId | Workspace id of task to create | string Required |
57f64991e4b0b689a64feed2 |
|||||||||
| name | Task name | string Required |
Hello world task |
|||||||||
| description | Task description | string Required |
Task detail description |
|||||||||
| tags | array of string Optional |
|
||||||||||
| connections | Task connections | ObjectOptional | ||||||||||
| parameters | Task parameters | ObjectOptional | ||||||||||
| resources | Task resources | ObjectOptional | ||||||||||
| artifact | ArtifactRequest Required | |||||||||||
| autoUpgradeInfo | AutoUpgradeInfo Optional | |||||||||||
UpgradeInfo
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| upgradable | boolean Optional | ||
| autoUpgradeFailed | boolean Optional |
Message
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| info | string Optional | ||
| level | string Optional |
INFO |
PromotionResultInfo
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | Artifact ID | string Optional | |
| targetId | Target Artifact ID | string Optional | |
| name | Artifact Name | string Optional | |
| type | Artifact Type | string Optional |
WORKSPACE |
| analyzeReport | Report Optional | ||
| promotionReport | Report Optional | ||
| targetVersion | Applicable to flows only, displays version of flow in target environment after promotion execution | string Optional |
1.1 |
| version | Applicable to flows only, displays version of flow in source environment | integer Optional |
INT32 |
| workspaceId | Artifact Workspace Id | string Optional |
Report
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| status | string Optional |
CREATED |
||||||||||
| messages | array of Message Optional |
|
RuntimePromotionResult
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Artifact ID | string Optional | ||||||||||
| targetId | Artifact Target ID | string Optional | ||||||||||
| name | Artifact Name | string Optional | ||||||||||
| type | Artifact Type | string Optional |
WORKSPACE |
|||||||||
| analyzeReport | Report Optional | |||||||||||
| promotionReport | Report Optional | |||||||||||
| usedBy | array of FlowPromotionResult Optional |
|
||||||||||
| runProfiles | array of ArtifactPromotionResult Optional |
|
WorkspacePromotionResult
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | Artifact ID | string Optional | ||||||||||
| targetId | Artifact Target ID | string Optional | ||||||||||
| name | Artifact Name | string Optional | ||||||||||
| type | Artifact Type | string Optional |
WORKSPACE |
|||||||||
| analyzeReport | Report Optional | |||||||||||
| promotionReport | Report Optional | |||||||||||
| flows | array of FlowPromotionResult Optional |
|
||||||||||
| plans | array of ArtifactPromotionResult Optional |
|
||||||||||
| actions | array of ArtifactPromotionResult Optional |
|
||||||||||
| connections | array of ArtifactPromotionResult Optional |
|
||||||||||
| resources | array of ArtifactPromotionResult Optional |
|
||||||||||
| engines | array of RuntimePromotionResult Optional |
|
||||||||||
| clusters | array of RuntimePromotionResult Optional |
|
||||||||||
| workspaceType | Promoted Workspace Type | string Optional |
Shared |
PromotionExecutionStatusV26
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| executionId | Job execution ID | string Required |
7b2b122e-d6b8-42de-b0ba-fa2f0d36306e |
|||||||||
| startTimestamp | Start time of job execution (UTC) | datetime Optional |
RFC3339 |
|||||||||
| triggerTimestamp | Trigger time of job execution (UTC) | datetime Required |
RFC3339 |
|||||||||
| finishTimestamp | End time of job execution (UTC) | datetime Optional |
RFC3339 |
|||||||||
| userId | User who triggered or scheduled the execution | string Required |
fupton |
|||||||||
| userType | Promotion Executor user type | string Required |
SERVICE |
|||||||||
| promotionId | Promotion ID | string Optional | ||||||||||
| pipelineId | Deprecated! Use Promotion ID instead | string Optional | ||||||||||
| keepTargetResources | Keep Target Resources flag | boolean Optional | ||||||||||
| keepTargetRunProfiles | Keep Target Run Profiles flag (not returned for API versions earlier V2.2) | boolean Optional | ||||||||||
| advanced | AdvancedPromotionSpec Optional | |||||||||||
| defective | Defective Promotion flag | boolean Optional | ||||||||||
| status | Execution status | string Optional |
ANALIZED |
|||||||||
| statusMessage | Execution Status Message | string Optional | ||||||||||
| workspaces | array of WorkspacePromotionResult Optional |
|
||||||||||
| engines | array of RuntimePromotionResult Optional |
|
||||||||||
| clusters | array of RuntimePromotionResult Optional |
|
||||||||||
| context | Execution context message | string Optional |
255
Free text describing the context for promotion execution |
PromotionAdvancedInfo
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| id | Artifact ID | string Optional | |
| name | Artifact Name | string Optional | |
| workspaceId | Artifact workspace ID | string Optional | |
| type | Defines the scope of the promotion execution | string Optional |
WORKSPACE |
PromotionExecutionDetails
Object
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| keepTargetRunProfiles | Dont touch run profiles on target | boolean Optional | |
| keepTargetResources | Dont touch resources on target | boolean Optional | |
| context | Optional context for audit log the promotion execution | string Optional | |
| promotionAdvancedInfo | PromotionAdvancedInfo Optional |
Get available Promotions
GET /orchestration/executables/promotionsGet available Promotions
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| _s | search query (FIQL format), e.g. “name==dev to prod*” | string Optional |
Response
200Status 200
OK
Body
application/json
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| array of PromotionExecutableDetails |
|
|||||||||||
Create a Promotion
POST /orchestration/executables/promotionsCreate a Promotion
Response
409Status 409
Promotion with same source and target already exists
Body
application/json
Get Promotion details
GET /orchestration/executables/promotions/{promotionId}Get Promotion details
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| promotionId | Promotion ID | string Required |
Response
Delete a Promotion
DELETE /orchestration/executables/promotions/{promotionId}Delete a Promotion
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| promotionId | Promotion ID | string Required |
Response
204Status 204
No Content
Perform promotion analysis
POST /orchestration/executables/promotions/{promotionId}Simulate upcoming executions of a promotion and get reports about its change analysis without executing it in real. Note that the target version displayed in the analysis could differ from the target version from the real promotion execution, if some changes are made in the target environment between the simulation and the actual execution of the promotion.
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| promotionId | Promotion ID | string Required |
Body
application/json
Response
Update a Promotion
PATCH /orchestration/executables/promotions/{promotionId}Update a Promotion
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| promotionId | Promotion ID | string Required |
Body
application/json
Response
204Status 204
No Content
Promotions Authorization
PromotionUsersResponse
Object
| Name | Description | Type | Attributes and examples | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| executable | Promotion ID | string Required |
5d3039de65ff7d3583840bk1 |
|||||||||
| userIds | array of string Required |
|
||||||||||
| serviceAccountIds | array of string Required |
|
Get users assigned to Promotion
GET /orchestration/executables/promotions/{promotionId}/usersGet users assigned to Promotion
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| promotionId | Promotion ID | string Required |
Response
Unassign user from Promotion
DELETE /orchestration/executables/promotions/{promotionId}/users/{userId}Unassign user from Promotion
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| promotionId | Promotion ID | string Required | |
| userId | User ID | string Required |
Response
204Status 204
No Content
Assign user to Promotion
PUT /orchestration/executables/promotions/{promotionId}/users/{userId}Assign user to Promotion
Request
| Name | Description | Type | Attributes and examples |
|---|---|---|---|
| promotionId | Promotion ID | string Required | |
| userId | User ID | string Required |
Response
204Status 204
No Content