Eigenschaften von REST - Cloud

Handbuch für Talend Cloud-Anwendungskonnektoren

Version
Cloud
Language
Deutsch
Product
Talend Cloud
Module
Talend Data Inventory
Talend Data Preparation
Talend Pipeline Designer
Content
Administration und Überwachung > Verwaltung von Verbindungen
Design und Entwicklung > Konzeption von Pipelines
Last publication date
2024-03-26

Zu konfigurierende Eigenschaften, damit HTTP-Requests an den Server gesendet und die entsprechenden Antwortinformationen vom Server empfangen werden können.

Der zugrunde liegende, vom Konnektor verwendete HTTP-Client ist der in Java eingebettete Standard-HTTP-Client.

Verbindung zu REST

Eigenschaft

Konfiguration

Selection (Auswahl) Wählen Sie REST aus bzw. geben Sie diese Auswahl ein.
Configuration (Konfiguration)
Engine Wählen Sie eine Engine in der Liste aus.
Main (Haupt) Base URL (Basis-URL) Geben Sie die URL-Adresse des aufzurufenden REST-Webservers ein.
Authentication (Authentifizierung) Wählen Sie die gewünschte Art der Authentifizierung beim Server aus:
  • Wählen Sie No authentication (Keine Authentifizierung) aus, wenn für den Zugriff auf den Server keine Authentifizierung erforderlich ist.
  • Wählen Sie Basic (Basis) aus, wenn für den Zugriff auf den Server ein Benutzername und das entsprechende Passwort eingegeben werden müssen.
  • Wählen Sie Digest aus, wenn für den Zugriff auf den Server ein Benutzername und ein Passwort in einem Digest-Algorithmus bereitgestellt werden müssen.
  • Wählen Sie Bearer Token aus, wenn die Authentifizierung beim Server anhand eines Zugriffstokens erfolgen soll.
Advanced (Erweitert) Connection timeout (ms) (Verbindungs-Timeout (ms)) Legt die maximale Anzahl an Millisekunden fest, die ein Benutzer auf eine verfügbare Verbindung warten soll. Wenn dieser Zeitraum abgelaufen und die Verbindung nach wie vor nicht verfügbar ist, wird eine Ausnahme ausgegeben.
Read timeout (ms) (Timeout für Lesevorgänge (ms)) Legt die maximale Wartezeit in Millisekunden fest, während der eine Verbindung als live eingestuft wird. Es wird eine Ausnahme ausgegeben, wenn dieser Zeitraum abläuft, bevor Daten zum Lesen verfügbar sind.
Beschreibung Geben Sie einen Anzeigenamen (obligatorisch) und eine Beschreibung (optional) für die Verbindung ein.

Datensätze in REST

Eigenschaft Konfiguration
Dataset name (Datensatzname) Geben Sie einen Anzeigenamen für den Datensatz ein. Dieser Name wird in allen Talend Cloud-Anwendungen als eindeutige Kennung für den Datensatz verwendet.
Verbindung Wählen Sie Ihre Verbindung in der Liste aus. Wenn Sie einen Datensatz basierend auf einer vorhandenen Verbindung erstellen, ist dieses Feld schreibgeschützt.
Type (Typ) Wählen Sie den Typ des zu erstellenden Datensatzes aus:
  • Batch - um einen REST-API-Dienst einmal aufzurufen. Die Pipeline, die diesen Datensatz verwendet, muss eine Batch-Pipeline sein.
  • Streaming - um alle N Millisekunden eine REST-API in einer Streaming-Pipeline aufzurufen. Die Pipeline, die diesen Datensatz verwendet, muss eine Streaming-Pipeline sein. Darüber hinaus können Sie das Abfrageintervall in Millisekunden im Feld Delay (Verzögerung) des Quelldatensatzes festlegen.
Main (Haupt) Resource (Ressource) Geben Sie die HTTP-Ressource ein, die über die REST-API verbraucht werden soll.
HTTP method (HTT) Wählen Sie eine HTTP-Request-Methode in der Liste aus.
Answer body format (Format des Antwort-Bodys) Wählen Sie das Format des Inhalts (Body) der Nachricht aus, die Sie als Antwort vom Server erhalten:
  • JSON: Wählen Sie dieses Format aus, wenn der REST-Dienst eine JSON-Nachricht zurückgibt. Dadurch wird die Payload in ordnungsgemäß geparste JSON-Datensätze übersetzt.
  • Text: Wählen Sie dieses Format aus, wenn der REST-Dienst eine Nachricht in einem anderen Format zurückgibt, z. B. XML, oder wenn Sie nicht geparste JSON-Datensätze abrufen möchten, die Sie dann in Ihrer Pipeline manuell verarbeiten können.
Abfrageparameter Geben Sie die URI-Abfrageparameter in Form von Namen-Wert-Paaren ein.
Advanced (Erweitert) Get status and headers (Status und Header abrufen) Aktivieren Sie diese Option, wenn sowohl Status als auch Header abgerufen werden sollen. Standardmäßig wird nur der Inhalt (Body) zurückgegeben.
Maximum number of redirects (Max. Anzahl Weiterleitungen) Legen Sie die maximale Anzahl der Weiterleitungen fest, die der Konnektor unterstützen soll. Wenn Sie 0 eingeben, erfolgt keine Weiterleitung. Wenn Sie -1 eingeben, wird die Einschränkung deaktiviert.
Redirect only on same host (Nur auf gleichem Host weiterleiten) Aktivieren Sie diese Option, wenn nur dann Weiterleitungen durchgeführt werden sollen, wenn derselbe Host verwendet wird.
Force GET method for 302 redirection (GET-Metode für 302-Weiterleitung forcieren) Aktivieren Sie diese Option, wenn Weiterleitungsrequests beim Weiterleitungscode 302 mit der GET-Methode gesendet werden sollen.

Lokaler Netzwerkzugriff

Standardmäßig wird die Remote Engine Gen2 konfiguriert, um zu verhindern, dass der REST-Konnektor auf Dienste in der Remote Engine Gen2 und damit auf Ihre lokalen Netzwerk-URLs zugreift.

Um einen Zugriff auf Ihr lokales Netzwerk zuzulassen, müssen Sie Folgendes durchführen:
  • Öffnen Sie folgende Datei, um sie zu bearbeiten:

    default/docker-compose.yml, wenn Sie die Engine in den Regionen AWS USA, AWS Europa, AWS Asien/Pazifik oder Azure einsetzen.

    eap/docker-compose.yml, wenn Sie die Engine im Rahmen eines Early-Adopter-Programms verwenden.

  • Suchen Sie diese Parametern in den Abschnitten livy > environment, component-server > environment und preview-runner > environment der Datei und ändern Sie den Wert zu true:
    CONNECTORS_ENABLE_LOCAL_NETWORK_ACCESS: "true"
    CONNECTORS_ENABLE_MULTICAST_NETWORK_ACCESS: "true"
  • Speichern Sie Ihre Änderungen und starten Sie die Remote Engine Gen2 neu, damit die Änderungen wirksam werden.