ListenHTTP 2025.5.31.15¶
Bundle¶
org.apache.nifi | nifi-standard-nar
Beschreibung¶
Startet einen HTTP-Server und lauscht auf einem bestimmten Basispfad, um eingehende Anfragen in FlowFiles umzuwandeln. Die Standard-URI des Dienstes lautet http://{hostname}:{port}/contentListener. Es werden nur HEAD- und POST-Anfragen unterstützt. GET, PUT, DELETE, OPTIONS und TRACE führen zu einem Fehler und dem HTTP-Antwortstatuscode 405; CONNECT führt ebenfalls zu einem Fehler und dem 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 Health Check-Funktionalität kann so konfiguriert werden, dass sie über einen anderen Port zugänglich ist. Einzelheiten finden Sie in der Dokumentation der Eigenschaft „Listening Port for health check requests“. Die Eigenschaften Record Reader und Record Writer können auf dem Prozessor aktiviert werden, um eingehende Anfragen als Datensätze zu verarbeiten. Die Verarbeitung von Datensätzen ist für mehrteilige Anfragen und Anfragen im Format FlowFileV3 (minifi) nicht zulässig.
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 |