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

Propriétés REST

Availability-noteDéprécié·e

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

Sélectionnez REST dans la liste et configurez la connexion.

Configuration

Sélectionnez votre moteur dans la liste et configurez les paramètres principaux et avancés.

Paramètres principaux
Propriété Configuration
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 settings
Propriété Configuration
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.
Connection 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.

Après avoir configuré la connexion, donnez-lui un nom à afficher (obligatoire) et une description (facultative).

Jeu de données REST

Configuration du jeu de données
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.
Paramètres principaux
Propriété Configuration
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 settings
Propriété Configuration
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.

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.