Création d'une tâche REST

Une tâche REST dans le service d'intégration de données vous permet d'appeler un point d'extrémité d'API REST à l'aide du protocole HTTP.

Créer une tâche REST dans un projet ou un dossier. Data Integration inclut un projet par défaut pour vous aider à démarrer. Pour créer d'autres projets ou dossiers, voir Projets et dossiers.

Dans le service d'intégration de données, vous pouvez avoir par défaut des exécutions de tâche simultanées ou parallèles à un moment donné. Pour interdire les exécutions de tâches concurrentes lancées manuellement, cochez la case Désactiver l'exécution simultanée de la tâche lorsque vous créez la tâche. Lorsque les exécutions de tâche simultanées ne sont pas autorisées, une demande d'exécution de tâche échoue s'il existe déjà une exécution de tâche en cours qui est à l'état non terminal.

  • L'interface utilisateur de configuration contient quatre sections dans lesquelles vous fournissez l'API REST et les détails d'authentification pour la tâche, fournissez des valeurs de paramètre facultatives dans la portée de la tâche et vérifiez les erreurs et les avertissements.

    Les étapes de chaque section de la procédure suivante peuvent également être utilisées lors de la modification d'une tâche REST.

    1. Dans la page Tâches du projet ou du dossier dans lequel vous voulez créer une tâche, sélectionnez Créer une tâche, puis REST. Si vous avez besoin d'aide pour trouver la page Tâches d'un projet ou d'un dossier, voir Liste des tâches.
    2. Dans la page Créer une tâche REST, entrez un nom et une description facultative.

      L'identificateur est une valeur générée par le système en fonction du nom. Vous pouvez modifier la valeur, mais après avoir créé et enregistré la tâche, vous ne pouvez pas mettre à jour l'identificateur.

    3. Cochez la case Désactiver l'exécution simultanée de la tâche si vous souhaitez interdire les exécutions concurrentes de cette tâche.
    4. (Facultatif) Pour Projet ou dossier, cliquez sur Sélectionner et sélectionnez un autre projet ou dossier dans lequel enregistrer la tâche.
    5. Pour enregistrer la tâche pour la première fois, sélectionnez l'un des boutons suivants :
      • Créer : Crée et enregistre la tâche. Vous pouvez continuer à créer et à modifier la tâche.

      • Créer et fermer : Crée et enregistre la tâche, ferme la page et vous ramène à la liste des tâches de la page des détails du projet ou du dossier.

    6. Enregistrez périodiquement pendant que vous travaillez en sélectionnant l'un des boutons suivants :
      • Enregistrer : Valide les modifications depuis le dernier enregistrement. Vous pouvez poursuivre la modification après l'enregistrement.

      • Enregistrer et fermer : Validation des modifications, fermeture de la page et retourne à la liste des tâches de la page des détails d'un projet ou d'un dossier.

      • Enregistrer sous : Valide les modifications (depuis le dernier enregistrement) et enregistre une copie, au lieu de remplacer la tâche courante. Vous pouvez indiquer un nom pour la copie et sélectionner un autre projet ou dossier pour celle-ci, ou l'enregistrer dans le même projet ou dossier que la tâche existante.

    7. Dans la section Détails de l'API REST, sélectionnez Configurer.

      Dans la page Configurer les détails de l'API REST qui s'affiche, fournissez les détails d'exécution de l'API REST et les critères d'achèvement (condition de réussite) pour un appel REST réussi.

      1. Pour définir les détails d'exécution de l'API REST, procédez comme suit :
        1. Spécifiez la méthode HTTP et l'URL REST.
        2. (Facultatif) Configurez les paramètres d'URL.
        3. Ajoutez un en-tête de demande REST.
        4. (Facultatif) Ajoutez un paramètre de tâche pour la valeur de l'en-tête REST.
        5. Pour une méthode HTTP POST ou PUT, ajoutez le corps de la demande.
        6. (Facultatif) Ajoutez un paramètre de tâche pour l'ensemble du corps de la demande.
        7. Pour afficher l'URL REST que vous avez configurée, sélectionnez Afficher l'URL de prévisualisation.
        8. Sélectionnez Suivant.
      2. Pour spécifier les critères de réussite de l'exécution de l'API REST, modifiez la condition de réussite par défaut fournie dans la section Conditions.
      3. Si l'API REST appelle une opération de longue durée, en plus de la condition de réussite, cochez la case Configurer une condition de scrutation et d'arrêt pour un appel REST sans attente et spécifiez les détails requis pour une configuration de scrutation (comportement asynchrone). Voir Définition de critères d'achèvement à l'aide de la scrutation.
      4. Sélectionnez Configurer.

        Vous êtes retourné à la page Créer une tâche REST ou Tâche REST : <nom de tâche>.

    8. Dans la section Authentification, sélectionnez Configurer. Dans le panneau Configurer l'authentification qui s'affiche, spécifiez la méthode d'authentification pour exécuter le point d'extrémité de l'API REST. Par défaut, aucune méthode d'authentification n'est nécessaire.
    9. (Facultatif) Dans la section Paramètres, sélectionnez Configurer. Dans la page Paramètres de tâche REST qui s'affiche, consultez et modifiez les valeurs des paramètres disponibles dans la portée de cette tâche REST.
    10. (Facultatif) Dans la section Valider la tâche, sélectionnez Valider.

      S'il y a des erreurs ou des avertissements, sélectionnez Voir les messages. Résoudre les erreurs avant de publier la tâche.

    11. Lorsque vous avez terminé la configuration de la tâche REST, sélectionnez Créer et fermer ou Enregistrer et fermer.
    Publiez la tâche REST dans une application du service d'intégration de données avant d'exécuter la tâche ou de programmer son exécution. Pour plus d'informations sur la publication, voir Publication dans une application d'intégration de données.
  • Utilisez la commande oci data-integration task create-task-from-rest-task et les paramètres requis pour créer une tâche REST :

    oci data-integration task create-task-from-rest-task [OPTIONS]

    Pour la liste complète des indicateurs et des options de variable pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

  • Exécutez l'opération CreateTask avec le sous-type de ressource approprié pour créer une tâche REST.