Propriétés REST - Cloud

Guide des connecteurs des applications Talend Cloud

Version
Cloud
Language
Français
Product
Talend Cloud
Module
Talend Data Inventory
Talend Data Preparation
Talend Pipeline Designer
Content
Administration et monitoring > Gestion des connexions
Création et développement > Création de Pipelines
Last publication date
2024-03-21

Propriétés à configurer pour pouvoir envoyer une requête HTTP au serveur et obtenir les informations de réponse correspondantes depuis le serveur.

Le client HTTP sous-jacent est le client HTTP par défaut embarqué avec Java.

Connexion REST

Propriété

Configuration

Selection (Sélection) Sélectionnez ou saisissez REST.
Configuration
Moteur Sélectionnez votre moteur dans la liste.
Principal Base URL Renseignez l'adresse URL du serveur Web REST à invoquer.
Authentification Sélectionnez la manière dont vous souhaitez authentifier le serveur :
  • Sélectionnez No authentication si vous n'avez pas besoin de vous authentifier pour accéder au serveur.
  • Sélectionnez Basic si vous devez fournir un identifiant et un mot de passe pour accéder au serveur.
  • Sélectionnez Digest si vous devez fournir un identifiant et un mot de passe au sein d'un algorithme de type Digest pour accéder au serveur.
  • Sélectionnez Bearer Token si vous devez vous authentifier pour accéder au serveur à l'aide d'un jeton d'accès.
Advanced Connection timeout (ms) Configure le temps maximal en millisecondes attendu par un utilisateur ou une utilisatrice pour une connexion disponible. Si ce temps est dépassé et que la connexion est toujours indisponible, une exception est retournée.
Read timeout (ms) Configure le temps maximal d'attente en millisecondes pour qu'une connexion soit considérée comme active. Une exception est retournée si le délai avant expiration est expiré avant que les données soient disponibles à la lecture.
Description Saisissez un nom d'affichage (obligatoire) et une description (facultative) pour la connexion.

Jeu de données REST

Propriété Configuration
Dataset name Saisissez un nom pour le jeu de données. Ce nom sera utilisé comme identifiant unique du jeu de données dans toutes les applications Talend Cloud.
Connexion Sélectionnez votre connexion dans la liste. Si vous créez un jeu de données basé sur une connexion existante, ce champ est en lecture seule.
Type Sélectionnez le type de jeu de données à créer :
  • Batch si vous souhaitez invoquer un service d'API REST une fois. Le pipeline utilisant ce jeu de données sera un pipeline de type batch.
  • Streaming si vous souhaitez invoquer une API REST toutes les N millisecondes dans un pipeline de type streaming. Le pipeline utilisant ce jeu de données sera un pipeline de type streaming et vous pourrez définir l'intervalle d'interrogation en millisecondes dans le champ Delay du jeu de données source.
Main Ressource Saisissez la ressource HTTP à consommer à partir de l'API REST.
HTTP method Sélectionnez la méthode de requête HTTP dans la liste.
Answer body format Sélectionnez le format du corps du message que vous recevez comme réponse côté serveur :
  • JSON : sélectionnez ce format si le service REST retourne un message JSON. Ainsi, le payload sera traduit en enregistrements JSON parsés.
  • Text : sélectionnez ce format si le service REST retourne un message d'un autre format, comme XML ou si vous souhaitez récupérer un JSON non parsé que vous pouvez traiter manuellement dans votre pipeline.
Paramètres de requête Spécifiez les paramètres de la requête URI sous forme de paires nom-valeur.
Advanced Get status and headers Activez cette option pour demander le statut et les en-têtes. Par défaut, seul le corps est retourné.
Maximum number of redirects Configurez le nombre maximal de redirections que doit suivre le connecteur. Si vous saisissez 0, aucune redirection n'est effectuée. Si vous saisissez -1, la restriction est désactivée.
Redirect only on same host Activez cette option si vous souhaitez que les redirections soient effectuées uniquement lors de l'utilisation du même hôte.
Force GET method for 302 redirection Activez cette option pour envoyer la requête de redirection avec la méthode GET si le code de redirection est 302.

Accès au réseau local

Par défaut le Moteur distant Gen2 est configuré pour empêcher le connecteur REST d'accéder aux services au sein du Moteur distant Gen2 et donc à vos URL du réseau local.

Pour autoriser l'accès à votre réseau local, vous devez :
  • Ouvrir ce fichier pour le modifier :

    default/docker-compose.yml si vous utilisez le moteur dans les régions AWS USA, AWS Europe, AWS Asie-Pacifique ou Azure.

    eap/docker-compose.yml si vous utilisez le moteur au sein du programme Early Adopter Program.

  • Trouver ces paramètres dans les sections livy > environment, component-server > environment et preview-runner > environment du fichier et modifier leur valeur à true :
    CONNECTORS_ENABLE_LOCAL_NETWORK_ACCESS: "true"
    CONNECTORS_ENABLE_MULTICAST_NETWORK_ACCESS: "true"
  • Sauvegarder vos modifications et redémarrer le Moteur distant Gen2 pour qu'elles soient prises en compte.