Accéder au contenu principal Passer au contenu complémentaire

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

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

    Paramètres de création d'une API dans Talend API Tester.
  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
  }
}

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 – faites-le-nous savoir.

Laissez vos commentaires ici