Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

Eigenschaften von REST

Availability-noteVeraltet

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

Wählen Sie in der Liste REST aus und konfigurieren Sie die Verbindung.

Konfiguration

Wählen Sie Ihre Engine aus der Liste aus und richten Sie die Haupt- und erweiterten Einstellungen ein.

Haupteinstelllungen
Eigenschaft Konfiguration
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.
Erweiterte Einstellungen
Eigenschaft Konfiguration
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.
Connection timeout (ms) (Verbindungs-Timeout (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.

Geben Sie nach dem Konfigurieren der Verbindung einen Anzeigenamen (obligatorisch) und eine Beschreibung (optional) ein.

Datensätze in REST

Datensatzkonfiguration
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.
Haupteinstelllungen
Eigenschaft Konfiguration
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.
Query parameters (Abfrageparameter) Geben Sie die URI-Abfrageparameter in Form von Namen-Wert-Paaren ein.
Erweiterte Einstellungen
Eigenschaft Konfiguration
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.

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!