InvokeHTTP 2025.5.31.15¶

Bundle¶

org.apache.nifi | nifi-standard-nar

Beschreibung¶

Ein HTTP-Client-Prozessor, der mit einem konfigurierbaren HTTP-Endpunkt interagieren kann. Die Ziel-URL und HTTP-Methode sind konfigurierbar. Wenn die Methode HTTP PUT, POST oder PATCH lautet, wird der Inhalt des FlowFile in den Body der Anfrage aufgenommen und die Attribute des FlowFile werden in HTTP-Header umgewandelt, optional basierend auf den Konfigurationseigenschaften.

Tags¶

client, http, https, rest

Eingabeanforderung¶

ALLOWED

Unterstützt sensible dynamische Eigenschaften¶

true

Eigenschaften¶

Eigenschaft	Beschreibung
Connection Timeout	Maximale Wartezeit für die erste Socket-Verbindung zur HTTP URL.
HTTP-Methode	HTTP Anfragemethode (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS). Beliebige Methoden werden ebenfalls unterstützt. Andere Methoden als POST, PUT und PATCH werden ohne einen Meldungstext gesendet.
HTTP URL	HTTP-Remote-URL mit einem http- oder https-Schema sowie einem Hostnamen oder einer IP-Adresse mit optionalen Port- und Pfadelementen. Die Verschlüsselung der URL muss vom Benutzer selbst vorgenommen werden.
HTTP/2 Deaktiviert	Deaktiviert die Aushandlung des HTTP/2 Protokolls. HTTP/2 erfordert TLS. Wenn HTTP/2 deaktiviert ist, muss das HTTP/1.1-Protokoll unterstützt werden.
OAuth2 Access Token Refresh Strategy	Gibt an, welche Strategie für die Aktualisierung des OAuth2 Access-Token verwendet werden soll.
Request Body Enabled	Aktiviert das Senden des HTTP-Anfrage-Bodys für die Methoden PATCH, POST oder PUT.
Chunked Transfer-Encoding bei Anfrage aktiviert	Aktiviert das Senden von HTTP-Anfragen mit dem Transfer-Encoding-Header auf „chunked“ gesetzt und deaktiviert das Senden des „Content Length Headers“. Transfer-Encoding gilt für den Body in HTTP/1.1 Anfragen wie in RFC 7230 Abschnitt 3.3.1 beschrieben
Request Content-Encoding	HTTP-Inhaltscodierung, die während der Übertragung auf den Anfrage-Body angewendet wird. Der empfangende Server muss die gewählte Codierung unterstützen, damit die Anfrage nicht fehlschlägt.
Request Content-Type	HTTP Content-Type Header, der verwendet wird, wenn ein HTTP-Anfragebody für die Methoden PATCH, POST oder PUT gesendet wird. Der Content-Type ist standardmäßig auf „application/octet-stream“ gesetzt, wenn keine Konfiguration vorgenommen wurde.
Request Date Header Enabled	Aktivieren Sie das Senden von HTTP-Datums-Headern bei HTTP-Anfragen wie in RFC Abschnitt 7.1.1.2 beschrieben.
Request Digest Authentication Enabled	Aktivieren Sie die Digest-Authentifizierung für HTTP-Anfragen mit Benutzername und Kennwort gemäß RFC 7616.
Request Failure Penalization Enabled	Aktiviert die Zurückstellung der Anfrage-FlowFiles, wenn Sie eine HTTP-Antwort mit einem Statuscode zwischen 400 und 499 erhalten.
Request Header Attributes Pattern	Regulärer Ausdruck, der definiert, welche FlowFile-Attribute als HTTP-Header in der Anfrage gesendet werden sollen. Wenn nicht definiert, werden keine Attribute als Header gesendet. Dynamische Eigenschaften werden immer als Header gesendet. Der dynamische Eigenschaftsname wird zum Header-Schlüssel und der dynamische Eigenschaftswert, interpretiert als Ausdruckssprache, wird zum Header-Wert. Attribute und ihre Werte sind aufgrund der Anforderungen des HTTP-Protokolls auf ASCII-Zeichen beschränkt.
Request Multipart Form-Data Filename Enabled	Aktiviert das Senden des FlowFile-Dateinamenattributs als Dateinamenparameter im Content-Disposition-Header für multipart/form-data-HTTP-Anfragen.
Request Multipart Form-Data Name	Aktiviert das Senden von HTTP-Anfrage-Bodys, die mit „multipart/form-data“ formatiert sind und den konfigurierten Formularnamen verwenden.
Request OAuth2 Access Token Provider	Ermöglicht den verwalteten Abruf des „OAuth2 Bearer Token“, das auf HTTP-Anfragen mit dem Authorization Header angewendet wird.
Request Password	Das Kennwort für die Authentifizierung von HTTP-Anfragen. Codiert mit Base64 für HTTP Basic Authentication wie in RFC 7617 beschrieben.
Request User-Agent	HTTP-User-Agent-Header, der auf Anfragen angewendet wird. RFC 7231 Abschnitt 5.5.3 beschreibt die empfohlene Formatierung.
Request Username	Der Benutzername für die Authentifizierung von HTTP-Anfragen. Codiert mit Base64 für HTTP Basic Authentication wie in RFC 7617 beschrieben.
Response Body Attribute Name	FlowFile-Attributname, der verwendet wird, um einen HTTP-Antwort-Body für FlowFiles zu schreiben, die an die Beziehung „original“ übertragen werden.
Response Body Attribute Size	Maximale Größe in Bytes, wenn ein HTTP-Antwort-Bodyi n ein FlowFile-Attribut geschrieben wird. Attribute, die das Maximum überschreiten, werden abgeschnitten.
Response Body Ignored	Deaktiviert das Schreiben von HTTP-Antwort-FlowFiles an die Beziehung „response“.
Response Cache Enabled	Aktiviert die in RFC 7234 beschriebene Zwischenspeicherung von HTTP-Antworten. Das Zwischenspeichern von Antworten berücksichtigt ETag und andere Header.
Response Cache Size	Maximale Größe des HTTP-Antwort-Caches in Bytes. Das Zwischenspeichern von Antworten berücksichtigt ETag und andere Header.
Response Cookie Strategy	Strategie für das Akzeptieren und Beibehalten von HTTP-Cookies. Die Annahme von Cookies ermöglicht die Persistenz über mehrere Anfragen hinweg.
Response FlowFile Naming Strategy	Legt die Strategie für die Festlegung des Dateinamenattributs von FlowFiles fest, die an die Beziehung „response“ übertragen werden.
Response Generation Required	Ermöglicht die Erstellung und Übertragung eines FlowFile an die Beziehung „response“, unabhängig von der empfangenen HTTP-Antwort.
Response Header Request Attributes Enabled	Aktiviert das Hinzufügen von HTTP-Antwort-Headern als Attribute zu FlowFiles, die an die Beziehungen „original“, „retry“ oder „no retry“ übertragen werden.
Response Header Request Attributes Prefix	Präfix für HTTP-Antwort-Header, wenn diese als Attribute zu FlowFiles enthalten sind, die an die Beziehungen „original“, „retry“ oder „no retry“ übertragen werden. Es wird empfohlen, mit einem Trennzeichen wie „.“ oder „-“ zu enden.
Response Redirects Enabled	Aktiviert die Weiterleitung von HTTP-Umleitungen, die mit HTTP-Antworten der Serie 300 gesendet werden, wie in RFC 7231 Abschnitt 6.4 beschrieben.
SSL Context Service	SSL Context Service bietet vertrauenswürdige Zertifikate und Client-Zertifikate für die TLS-Kommunikation.
Socket Idle Connections	Maximale Anzahl von Leerlaufverbindungen zur HTTP URL.
Socket Idle Timeout	Maximale Wartezeit vor dem Schließen von Leerlaufverbindungen zur HTTP URL.
Socket Read Timeout	Maximale Wartezeit für den Empfang von Antworten von einer Socket-Verbindung zur HTTP-URL.
Socket Write Timeout	Maximale Wartezeit für Schreiboperationen beim Senden von Anfragen von einer Socket-Verbindung an die HTTP URL.
proxy-configuration-service	Gibt den Proxy-Konfigurations-Controller Service an für die Weiterleitung von Netzwerkanforderungen festl. Im Falle von SOCKS ist nicht garantiert, dass die ausgewählte SOCKS-Version vom Prozessor verwendet wird.

Beziehungen¶

Name	Beschreibung
Failure	Fordern Sie FlowFiles an, die bei Socket-Kommunikationsfehlern übertragen wurden.
No Retry	Anfrage-FlowFiles, die beim Empfang von HTTP-Antworten mit einem Statuscode zwischen 400 und 499 übertragen werden.
Original	Anfrage-FlowFiles, die beim Empfang von HTTP-Antworten mit einem Statuscode zwischen 200 und 299 übertragen werden.
Antwort	Antwort-FlowFiles, die beim Empfang von HTTP-Antworten mit einem Statuscode zwischen 200 und 299 übertragen werden.
Retry	Anfrage-FlowFiles, die beim Empfang von HTTP-Antworten mit einem Statuscode zwischen 500 und 599 übertragen werden.

Schreibt Attribute¶

Name	Beschreibung
invokehttp.status.code	Der Statuscode, der zurückgegeben wird
invokehttp.status.message	Die Statusmeldung, die zurückgegeben wird
invokehttp.response.body	Wenn der empfangene Statuscode kein Erfolg ist (2xx), wird der Antwortkörper in das Attribut „invokehttp.response.body“ des Anfrage-FlowFile eingetragen.
invokehttp.request.url	Der ursprüngliche Anfrage-URL
invokehttp.request.duration	Dauer (in Millisekunden) des HTTP-Aufrufs an den externen Endpunkt
invokehttp.response.url	Die URL, die letztendlich angefordert wurde, nachdem alle Umleitungen befolgt wurden
invokehttp.tx.id	Die Transaktions-ID, die nach dem Lesen der Antwort zurückgegeben wird
invokehttp.remote.dn	Die DN des Remote-Servers
invokehttp.java.exception.class	Die Java-Ausnahmeklasse, die ausgelöst wird, wenn der Prozessor ausfällt
invokehttp.java.exception.message	Die Java-Ausnahmemeldung, die angezeigt wird, wenn der Prozessor ausfällt.
user-defined	Wenn die Eigenschaft „Put Response Body In Attribute“ aktiviert ist, wird der eingegebene Wert zum Attributschlüssel und der Wert zum Textkörper der HTTP-Antwort.