Créer un ordonnancement et ajouter des déclencheurs

Créez un ordonnancement et ajoutez des déclencheurs avant de l'associer à une tâche.

Les ordonnancements supportent uniquement les déclencheurs temporels. Les déclencheurs WebHooks, basés sur les événements, ne sont pas supportés.

Avant de commencer

Générez des jetons d'accès :
- Pour les utilisateur·trices, générez un jeton d'accès personnel en suivant la procédure Générer un jeton d'accès personnel.
- Pour les comptes de service, générez un jeton d'accès de compte de service en suivant la procédure Générer un jeton de compte de service.
Une fois généré, un jeton de compte de service expire après 30 minutes. S'il expire, générez un nouveau jeton à l'aide de la méthode POST sur l'endpoint https://api.<env>.cloud.talend.com/security/oauth/token. Pour plus d'informations concernant la génération de ce jeton, consultez Générer un jeton de compte de service.
Assurez-vous que l'utilisateur·trice ou le compte de service à utiliser pour émettre les appels d'API a l'autorisation TMC_OPERATOR et l'autorisation EXECUTOR pour au moins un espace de travail dans l'environnement où créer l'ordonnancement.

Procédure

Émettez la requête suivante pour créer un ordonnancement. Un ordonnancement doit avoir au moins un déclencheur.

Exemple

method: POST
endpoint: https://api.<env>.cloud.talend.com/orchestration/schedules
headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer <your_personal_access_token_or_service_account_token>"
          }
payload: {
       "environmentId": "id_of_the_environment", #for example, 6242bc6eac74e9757cda41bb
       "Trigger": {
           "name": "My unique trigger name",
           "startDate": "2022-06-16",
           "timeZone": "Europe/Kiev",
           "type": "ONCE",
           atTimes: {
               "type": "AT_TIME",
               "time": "11:00"
                    }
                   }
          }

Dans Talend Management Console, sélectionnez l'environnement dans la liste d'environnements sur la page Environment (Environnement). L'ID de cet environnement s'affiche dans l'URL de la page courante.

API : Émettez l'appel d'API suivant :

method: GET
endpoint: https://api.<env>.cloud.talend.com/orchestration/workspaces
headers: {
     "Content-Type": "application/json",
     "Authorization": "Bearer <your_personal_or_service_account_access_token>"
          }

Dans la réponse, les ID des environnements sont retournés dans le champ environmentId dans chaque bloc d'espace de travail.

Dans les étapes suivantes, vous devez utiliser l'ID de cet ordonnancement du champ Id de la réponse.

Émettez l'appel d'API suivant pour ajouter des déclencheurs à la suite de cet ordonnancement :
Exemple
```
method: POST
endpoint: https://api.<env>.cloud.talend.com/orchestration/schedules/<scheduleId>/triggers
headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer <your_personal_access_token_or_service_account_token>"
          }
payload: {
       "Trigger": {
              "name": "My CRON Trigger",
              "startDate": "2022-06-16",
              "timeZone": "Europe/Kiev",
              "type": "CRON",
              "cronExpression": "0 * * ? *"
                  }
          }
```
Les déclencheurs que vous définissez doivent répondre aux prérequis suivants. Lorsque vous envoyez la requête, une vérification automatique a lieu.
- Le nom d'un déclencheur doit être unique parmi les déclencheurs définis pour un même ordonnancement.
- Un ordonnancement ne peut contenir plus de 15 déclencheurs.
- L'intervalle entre deux événements de la même tâche, comme deux exécutions, ne doit pas être inférieur à 5 minutes.
Note InformationsRemarque : L'ID de l'ordonnancement à utiliser dans l'URL de l'endpoint est celui obtenu dans la réponse lors de la création de cet ordonnancement. Si vous n'avez pas mémorisé cet ID, émettez la requête d'API suivante pour récupérer tous les ordonnancements disponibles sur votre compte :
method: GET endpoint: https://api.<env>.cloud.talend.com/orchestration/schedules headers: { "Content-Type": "application/json", "Authorization": "Bearer <your_personal_access_token_or_service_account_token>" } payload: { "environmentId": "id_of_the_environment", #for example, 6242bc6eac74e9757cda41bb }
L'autorisation View est requise sur au moins un espace de travail de l'environnement.

Résultats

Votre ordonnancement et ses déclencheurs ont été créés. L'ordonnancement est toujours orphelin.

Que faire ensuite

Avant d'appliquer votre ordonnancement à une tâche, vous pouvez simuler des événements que votre ordonnancement déclencherait pour une période donnée, afin de pouvoir valider ou adapter l'ordonnancement.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !

Laissez vos commentaires ici