ListenHTTP 2025.5.31.15¶
バンドル¶
org.apache.nifi | nifi-standard-nar
説明¶
HTTP サーバーを起動し、指定されたベースパスでリッスンして、入ってくるリクエストを FlowFiles に変換します。サービスのデフォルト URI は http://{hostname}:{port}/contentListener となります。HEAD、 POST のリクエストのみがサポートされています。GET, PUT, DELETE, OPTIONS and TRACE はエラーとなり、 HTTP レスポンス ステータス コード 405 となります。 CONNECT もエラーとなり、 HTTP レスポンス ステータス コード 400 となります。GET は以下でサポートされています。 <service_URI>/healthcheckサービスが利用可能であれば、 "200 OK" を返し、その内容は "OK" です。ヘルスチェック関数は、別のポートからアクセスできるように構成できます。詳細については、「ヘルスチェックリクエストのリスニングポート」プロパティのドキュメントを参照してください。プロセッサーでRecord ReaderとRecord Writerのプロパティを有効にすると、着信リクエストを記録として処理できます。記録処理は、マルチパートリクエストおよび FlowFileV3 形式(minifi)のリクエストでは許可されません。
入力要件¶
FORBIDDEN
機密動的プロパティをサポート¶
false
プロパティ¶
プロパティ |
説明 |
|---|---|
認証済 DN パターン |
受信接続の Subject 識別名に適用する正規表現。パターンがサブジェクト DN にマッチしない場合、プロセッサはステータス HTTP 403 Forbiddenで応答します。 |
ベースパス |
受信接続のベースパス |
HTTP 属性 (Regex) として受け取るヘッダー |
FlowFile 属性として渡されるべき HTTP ヘッダーの名前を決定する正規表現を指定します。 |
HTTP プロトコル |
TLS と HTTP アプリケーション・レイヤー・プロトコル・ネゴシエーションでサポートされるプロトコル。 |
リスニングポート |
接続をリッスンするポート。 |
最大未確認フローファイル時間 |
FlowFile がキャッシュから削除されるまでの確認待ちの最大時間。 |
リクエストヘッダーの最大サイズ |
このプロセッサに送信されるリクエストでサポートされる HTTP ヘッダーの最大サイズ |
リターンコード |
HTTP を呼び出すたびに返される HTTP のリターンコード |
SSL コンテキストサービス |
SSL コンテキストサービスは、 HTTPS のサポートを可能にします。 |
authorized-issuer-dn-pattern |
受信接続の発行者識別名に適用する正規表現。パターンが発行者 DN と一致しない場合、プロセッサーはステータス HTTP 403 Forbidden で応答します。 |
client-authentication |
TLS 接続のクライアント認証コードポリシー。SSL コンテキストサービスが構成されている場合に必要です。 |
health-check-port |
ヘルスチェックリクエストをリッスンするポート。セットされている場合は、リスニング・ポートと異なる必要があります。プロセッサーが双方向 SSL を使用するようにセットされていて、ヘルスチェックリクエストのクライアント認証をサポートしないロードバランサーを使用する場合は、このポートを構成します。<base_path>/healthcheckサービスのみがこのポート経由で可用性で、 GET と HEAD リクエストのみがサポートされています。プロセッサーが SSL を使用しないようにセットされている場合、 SSL もこのポートでは使用されません。プロセッサーが一方向 SSL を使用するようにセットされている場合、このポートでは一方向 SSL が使用されます。プロセッサが双方向 SSL を使用するようにセットされている場合、このポートでは一方向 SSL が使用されます（クライアント認証は必要ありません）。 |
max-thread-pool-size |
組み込み Jetty サーバーが使用するスレッドの最大数。値は8～1000の間でセットできます。このプロパティの値は、フローとオペレーティングシステムのパフォーマンスに影響するため、デフォルト値は正当な場合にのみ変更する必要があります。サーバーに接続する HTTP クライアントの数が少ない場合は、デフォルト値より小さい値が適している場合があります。多数の HTTP クライアントが同時にサーバーにリクエストすることが予想される場合は、より大きな値が適しているかもしれません。 |
multipart-read-buffer-size |
受信ファイルの内容がディスクに書き込まれる閾値サイズ。Content-Type: multipart/form-data のリクエストにのみ適用されます。これは、サービス拒否タイプの攻撃を防止したり、Heapやディスク容量がいっぱいになるのを防ぐために使用されます。 |
multipart-request-max-size |
リクエストの最大サイズ。Content-Type: multipart/form-dataを持つリクエストにのみ適用され、サービス拒否タイプの攻撃を防止したり、Heapやディスク容量がいっぱいになるのを防ぐために使用されます。 |
record-reader |
入力された FlowFile を記録にパースするために使用するRecord Reader。 |
record-writer |
変換後の記録をシリアライズするために使用するRecord Writer。 |
リレーションシップ¶
名前 |
説明 |
|---|---|
success |
正常に受信した FlowFiles の場合のリレーションシップ |
ユースケース¶
POST で受信した FlowFileV3 コンテンツを解凍します。 |
他のコンポーネントを含むユースケース¶
受付可能な日付流量の制限 |