Orchestration - Cloud

Talend Cloud Release Notes

Version
Cloud
Language
English (United States)
Product
Talend Cloud
Module
Talend API Designer
Talend API Tester
Talend Data Inventory
Talend Data Preparation
Talend Data Stewardship
Talend Management Console
Talend Pipeline Designer
Content
Installation and Upgrade
Release Notes
Support for the CRON type trigger has been added to Orchestration API endpoints with regard to the run configuration of tasks and plans.
  • The CRON trigger type and the cronExpression field have been added to the following Orchestration API endpoints:
    Updated Orchestration API endpoints
    Method Endpoint Description Query parameters Body example
    GET /executables/tasks/{taskId}/run-config Gets the configuration details of the scheduled runs of a specific task. - -
    PUT /executables/tasks/{taskId}/run-config Defines or updates the configuration of the scheduled runs of a specific task.

    -
    {
        "trigger":
        {
            "type": "CRON",
            "cronExpression": "*/10 9 15 * ? 2022",
            "startDate": "2022-01-26",
            "timeZone": "Europe/Paris"
        },
        "runtime":
        {
            "type": "REMOTE_ENGINE",
          	"id": "${engineId}"
        },
        "logLevel": "INFO"
    }
    GET /executables/plans/{planId}/run-config Gets the configuration details of the scheduled runs of a specific plan. - -
    PUT /executables/plans/{planId}/run-config Defines or updates the configuration of the scheduled runs of a specific plan. -
    {
        "trigger":
        {
            "type": "CRON",
            "cronExpression": "*/10 9 15 * ? 2022",
            "startDate": "2022-01-26",
            "timeZone": "Europe/Paris"
        },
        "runtime":
        {
            "type": "REMOTE_ENGINE",
          	"id": "${engineId}"
        },
        "logLevel": "INFO"
    }
  • New Orchestration API endpoints have been added to the task and the plan APIs to retrieve a list of the upcoming scheduled runs, set with the CRON type triggers only for the time being:
    New Orchestration API endpoints
    Method Endpoint Description Query parameters
    GET /executables/tasks/{taskId}/run-config/events Gets the next scheduled runs of a specific task. It returns a list of dates and times for each of which a task run is triggered.
    • from: earliest date and time (in milliseconds) of the timespan in which you search for task runs to take place according to the schedule.
    • to: latest date and time (in milliseconds) of the timespan in which you search for task runs to take place according to the schedule
    • limit: number of entries to return. The default value is 100 and the value range is from 1 to 100
    • offset: the start position of the search, greater or equal to 0

    The to parameter is required.

    GET /executables/plans/{planId}/run-config/events Gets the next scheduled runs of a specific plan. It returns a list of dates and times for each of which a plan run is triggered.
    • from: earliest date and time (in milliseconds) of the timespan in which you search for plan runs to take place according to the schedule.
    • to: latest date and time (in milliseconds) of the timespan in which you search for plan runs to take place according to the schedule
    • limit: number of entries to return. The default value is 100 and the value range is from 1 to 100
    • offset: the start position of the search, greater or equal to 0

    The to parameter is required.

Access these endpoints via https://api.us.cloud.talend.com/tmc/swagger/swagger-ui.html. You'll find a list of the URLs corresponding to each data center in Talend Cloud regions and URLs.