Obtenir les tâches pour lesquelles vous souhaitez mettre à jour la version de l'artefact - Cloud

Mettre à jour la version de l'artefact dans les tâches via l'API
Version
Cloud
Language
Français
Product
Talend Cloud
Module
Talend Management Console
Content
Création et développement > Updating Tasks
Last publication date
2024-02-12
Utilisez l'endpoint orchestration/executables/tasks avec les paramètres de requête workspaceId et artifactId pour obtenir une liste de tâches utilisant l'artefact à mettre à jour.

Avant de commencer

  • Générez des jetons d'accès :

    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 le compte à utiliser pour émettre des appels d'API a l'autorisation Operations - Manage (Opérations - Gestion) (ID : TMC_OPERATOR).

Procédure

  1. Émettez la requête suivante pour obtenir les exécutions planifiées des tâches d'un environnement donné.

    Exemple

    method: GET
endpoint: https://api.<env>.cloud.talend.com/orchestration/executables/tasks
headers: {
          "Content-Type": "application/json",
          "Authorization": "Bearer <your_personal_access_token_or_service_account_token>"
          }
query parameters: {
         "workspaceId": "id_of_the_workspace"
         "artifactId": "id_of_the_artifact_that_the_task_will_be_updated_to_use"
                  }
    Le paramètre artifactId identifie l'artefact à utiliser par la tâche mise à jour. Le paramètre workspaceId indique l'espace de travail duquel vous obtenez les tâches. Vous les obtenez via des requêtes d'API ou les trouvez dans Talend Management Console.
  2. Facultatif : Vous pouvez utiliser Talend API Tester pour construire visuellement vos requêtes d'API.

    Exemple

  3. Cliquez sur Send (Envoyer) pour émettre votre appel et obtenir toutes les tâches utilisant cet artefact.

Résultats

Le code de statut 200 est retourné avec une liste de tâches dans le corps de la réponse. L'exemple suivant vous montre à quoi ressemble une tâche dans la réponse. Toutes ces tâches utilisent l'artefact à mettre à jour.
{
  "id": "your_task_id",
  "name": "Hello world task",
  "description": "task detail description",
  "workspace": {
    "id": "your_workspace_id",
    "name": "Personal",
    "description": "workspace detail description",
    "owner": "admin",
    "type": "custom",
    "environment": {
      "id": "your_environment_id",
      "name": "Development",
      "description": "environment detail description",
      "default": true
    }
  },
  "version": "0.1",
  "artifact": {
    "createDate": "2021-11-22T13:13:27.602Z",
    "updateDate": "2021-11-22T13:13:27.602Z",
    "id": "id_of_the_artifact_to_be_updated",
    "name": "Hello world artifact",
    "version": "0.1.0" (The artifact version to be updated)
  },
  "tags": [
    "tag1",
    "tag2"
  ],
  "connections": {
    "aws": "5d405e381f40e07fbab6757c",
    "googledrive": "5d405e831f40e07fbab6757d"
  },
  "parameters": {
    "parameter_p1": "1111",
    "custom_parameter": "custom"
  },
  "resources": {
    "resource_file_f1": "5d567ad48f68ae1a1e16e4a4"
  },
  "autoUpgradeInfo": {
    "autoUpgradable": false,
    "overrideWithDefaultParameters": false
  }
}