ListenHTTP 2025.10.2.19¶
Bundle¶
org.apache.nifi | nifi-standard-nar
Beschreibung¶
Startet einen HTTP-Server und überwacht einen bestimmten Basispfad, um eingehende Anforderungen in FlowFiles umzuwandeln. Die Standard-URI des Dienstes ist http://{hostname}:{port}/contentListener. Nur HEAD- und POST-Anforderungen werden unterstützt. GET, PUT, DELETE, OPTIONS und TRACE führt zu einem Fehler und dem HTTP-Antwortstatuscode 405; CONNECT führt ebenfalls zu einem Fehler und HTTP-Antwortstatuscode 400. GET wird für <service_URI>/healthcheck unterstützt. Wenn der Dienst verfügbar ist, wird „200 OK„ mit dem Inhalt „OK“ zurückgegeben. Die Healthcheck-Funktionalität kann so konfiguriert werden, dass sie über einen anderen Port zugänglich ist. Weitere Informationen dazu finden Sie in der Dokumentation zur Eigenschaft „Überwachungsport für Healthcheck-Anforderungen“. Auf dem Prozessor können die Eigenschaften für Record Reader und Record Writer aktiviert werden, um eingehende Anforderungen als Datensätze zu verarbeiten. Die Datensatzverarbeitung ist für mehrteilige Anforderungen und Anforderungen im FlowFileV3-Format (minifi) nicht zulässig. Wenn die eingehende Anforderung ein FlowFileV3-Paketformat enthält, werden die Daten automatisch in einzelne FlowFile(s) entpackt, die im Paket enthalten sind; die ursprünglichen FlowFile-Namen werden wiederhergestellt.
Eingabeanforderung¶
FORBIDDEN
Unterstützt sensible dynamische Eigenschaften¶
false
Eigenschaften¶
Eigenschaft |
Beschreibung |
|---|---|
Authorized DN Pattern |
Ein regulärer Ausdruck, der auf den Distinguished Name des Subjekts eingehender Verbindungen angewendet wird. Wenn das Muster nicht mit dem Subject DN übereinstimmt, antwortet der Prozessor mit dem Status HTTP 403 Forbidden. |
Base Path |
Basispfad für eingehende Verbindungen |
HTTP-Header, die als Attribute empfangen werden (Regex) |
Gibt den regulären Ausdruck an, der die Namen der HTTP-Header bestimmt, die als FlowFile-Attribute weitergegeben werden sollen |
HTTP Protocols |
Unterstützte HTTP-Protokolle für Application Layer Protocol Negotiation mit TLS |
Listening Port |
Der Port, auf dem eingehende Verbindungen abgehört werden sollen |
Max Unconfirmed Flowfile Time |
Die maximale Zeitspanne, die gewartet wird, bis ein FlowFile bestätigt wird, bevor es aus dem Cache entfernt wird |
Request Header Maximum Size |
Die maximal unterstützte Größe der HTTP-Header in Anfragen, die an diesen Prozessor gesendet werden. |
Rückgabecode |
Der HTTP-Rückgabecode, der nach jedem HTTP-Aufruf zurückgegeben wird |
SSL Context Service |
SSL Context Service bietet Unterstützung für HTTPS |
authorized-issuer-dn-pattern |
Ein regulärer Ausdruck, der auf den Distinguished Name des Ausstellers eingehender Verbindungen angewendet wird. Wenn das Muster nicht mit dem Emittenten-DN übereinstimmt, antwortet der Prozessor mit dem Status HTTP 403 Forbidden. |
client-authentication |
Client-Authentifizierungsrichtlinie für TLS-Verbindungen. Erforderlich, wenn SSL Context Service konfiguriert ist. |
health-check-port |
Der Port, auf dem eingehende Health Check-Anfragen abgehört werden sollen. Wenn festgelegt, muss er sich vom Listening Port unterscheiden. Konfigurieren Sie diesen Port, wenn der Prozessor auf die Verwendung von Zwei-Wege-SSL eingestellt ist und ein Load Balancer verwendet wird, der keine Client-Authentifizierung für Health Check-Anfragen unterstützt. Über diesen Port ist nur der Dienst /<base_path>/healthcheck verfügbar und es werden nur die Anfragen GET und HEAD unterstützt. Wenn der Prozessor so eingestellt ist, dass er SSL nicht verwendet, wird SSL auch an diesem Port nicht verwendet. Wenn der Prozessor so eingestellt ist, dass er einseitig SSL verwendet, wird auf diesem Port einseitig SSL verwendet. Wenn der Prozessor auf die Verwendung von Zwei-Wege-SSL eingestellt ist, wird auf diesem Port SSL verwendet (Client-Authentifizierung nicht erforderlich). |
max-thread-pool-size |
Die maximale Anzahl von Threads, die vom eingebetteten Jetty-Server verwendet werden sollen. Der Wert kann zwischen 8 und 1000 festgelegt werden. Der Wert dieser Eigenschaft beeinflusst die Leistung der Datenflüsse und des Betriebssystems. Daher sollte der Standardwert nur in begründeten Fällen geändert werden. Ein Wert, der unter dem Standardwert liegt, kann geeignet sein, wenn sich nur eine kleine Anzahl von HTTP-Clients mit dem Server verbindet. Ein größerer Wert kann sinnvoll sein, wenn eine große Anzahl von HTTP-Clients gleichzeitig Anfragen an den Server stellen soll. |
multipart-read-buffer-size |
Die Schwellengröße, bei der der Inhalt einer eingehenden Datei auf die Festplatte geschrieben wird. Gilt nur für Anfragen mit Content-Type: multipart/form-data. Es wird verwendet, um Denial-of-Service-Angriffe zu verhindern und zu verhindern, dass der Heap oder der Speicherplatz auf der Festplatte voll wird. |
multipart-request-max-size |
Die maximale Größe der Anfrage. Gilt nur für Anfragen mit Content-Type: multipart/form-data und wird verwendet, um Denial-of-Service-Angriffe zu verhindern und eine Überfüllung des Heaps oder des Festplattenspeichers zu verhindern. |
record-reader |
Der Record Reader zum Parsen des eingehenden FlowFile in Datensätze. |
record-writer |
Der Record Writer, der für die Serialisierung von Datensätzen nach deren Transformation verwendet wird |
Beziehungen¶
Name |
Beschreibung |
|---|---|
success |
Beziehung für für erfolgreich empfangene FlowFiles |
Anwendungsfälle¶
FlowFileV3 Inhalte, die Sie in einem POST entpacken |
Anwendungsfälle mit anderen Komponenten¶
Begrenzt die zulässige Datenflussrate |