HandleHttpRequest 2025.5.31.15¶

バンドル¶

org.apache.nifi | nifi-standard-nar

説明¶

HTTP サーバーを起動し、 HTTP リクエストをリッスンします。各リクエストに対して、 FlowFile を作成し、 'success' に転送します。このプロセッサーは、ウェブサービスを作成するために、 HandleHttpResponse プロセッサーと組み合わせて使用するように設計されています。マルチパートリクエストの場合、 FlowFile は各パートに対して一つずつ生成されます。

タグ¶

http、https、イングレス、リッスン、リクエスト、ウェブサービス

入力要件¶

FORBIDDEN

機密動的プロパティをサポート¶

false

プロパティ¶

プロパティ	説明
追加 HTTP メソッド	カンマで区切られた、許可されるべき非標準の HTTP メソッドのリスト。
DELETE を許可する	HTTP DELETE 方法を許可する
GET を許可する	HTTP GET 方法を許可する
HEAD を許可する	HTTP HEAD 方法を許可する
OPTIONS を許可する	HTTP OPTIONS 方法を許可する
POST を許可する	HTTP POST 方法を許可する
PUT を許可する	HTTP PUT 方法を許可する
許可されたパス	受信する URL リクエストで許可される有効な HTTP パスを指定する正規表現。この値が指定されていて、 HTTP リクエストのパスがこの正規表現にマッチしない場合、プロセッサーは 404 で応答します: NotFound
クライアント認証コード	Processor がクライアントを認証コードで認証するかどうかを指定します。この値は、 <SSL コンテキストサービス> プロパティが指定されていない場合、または提供される SSL コンテキストが KeyStore のみを使用し、 TrustStore を使用しない場合は、無視されます。
デフォルト URL 文字セット	HTTP リクエストが URL パラメーターをデコードするために使用する文字セット
HTTP コンテクストマッピング	HTTP リクエスト情報のキャッシュに使用する HTTP コンテキストマップController Service。
HTTP プロトコル	TLS と HTTP アプリケーション・レイヤー・プロトコル・ネゴシエーションでサポートされるプロトコル。
ホスト名	バインド先のホスト名。指定しない場合は、すべてのホストにバインドします。
リスニングポート	HTTP リクエストをリッスンするポート。
最大スレッド	組み込みの HTTP サーバーがリクエスト処理に使用するスレッドの最大数。
リクエストヘッダーの最大サイズ	このプロセッサに送信されるリクエストでサポートされる HTTP ヘッダーの最大サイズ
SSL コンテキストサービス	サーバーをセキュリティで保護するために使用する SSL コンテキストサービス。指定された場合、サーバーは HTTPS リクエストのみを受け付けます。指定されなかった場合、サーバーは HTTP リクエストのみを受け付けます。
container-queue-size	Http リクエストコンテナーのキューのサイズ。
multipart-read-buffer-size	受信ファイルの内容がディスクに書き込まれる閾値サイズ。Content-Type: multipart/form-data のリクエストにのみ適用されます。これは、サービス拒否タイプの攻撃を防止したり、Heapやディスク容量がいっぱいになるのを防ぐために使用されます。
multipart-request-max-size	リクエストの最大サイズ。Content-Type: multipart/form-dataを持つリクエストにのみ適用され、サービス拒否タイプの攻撃を防止したり、Heapやディスク容量がいっぱいになるのを防ぐために使用されます。
parameters-to-attributes	属性として出力する HTTP パラメーターまたはフォームデータのカンマ区切りリスト。

リレーションシップ¶

名前	説明
success	受信したコンテンツはすべて「成功」関係にルーティングされます。

属性の書き込み¶

名前	説明
http.context.identifier	HandleHttpRequest と HandleHttpResponse が、どの FlowFile がどの HTTP リクエスト/レスポンスに属するかを調整できる識別子。
mime.type	HTTP ヘッダーの "Content-Type" に従った、データの MIME タイプ。
http.servlet.path	リクエスト URL のうちサーブレットパスとみなされる部分
http.context.path	リクエストの URL、コンテキストパスとみなされる部分。
http.method	GET や POST のような HTTP リクエストに使用されたメソッド。
http.local.name	IP サーバーのアドレス/ホスト名
http.server.port	サーバーのリスニングポート
http.query.string	リクエスト URL のクエリ文字列部分
http.remote.host	リクエスト元のホスト名
http.remote.addr	リクエスト元のホスト名: ポートの組み合わせ
http.remote.user	リクエスト元のユーザー名
http.protocol	通信に使用されるプロトコル
http.request.uri	フルリクエスト URL
http.auth.type	使用される HTTP 認可のタイプ
http.principal.name	リクエストを行う認証コードのユーザー名
http.query.param.XXX	リクエストのクエリパラメーターは、 "http.query.param." というプレフィックス付きの属性として追加されます。
http.param.XXX	「属性リストへのパラメータ」で構成されたリクエストのフォームパラメータは、 "http.param." をプレフィックスとして属性として追加されます。大容量のフォームパラメーターを置くことは推奨されません。
http.subject.dn	リクエスト元の識別名。プロセッサーが SSLContext サービスを使用するように構成されていない限り、この値は入力されません。
http.issuer.dn	Subject の証明書を発行したエンティティの識別名。プロセッサーが SSLContext サービスを使用するように構成されていない限り、この値は入力されません。
http.certificate.sans.N.name	相互認証 (TLS) による X.509 クライアント証明書サブジェクト代替名の値。属性名は、クライアント証明書のコンテンツに従ってゼロベースで並べられたインデックスを持ちます。
http.certificate.sans.N.nameType	X.509 クライアント証明書のサブジェクト代替名のタイプは、相互認証 (TLS) から。属性名は、クライアント証明書のコンテンツに従ってゼロベースで並べられたインデックスを持ちます。属性値は、 RFC 3280 セクション 4.1.2.7 の General Names の一つ
http.headers.XXX	リクエストで受け取った HTTP Headers のそれぞれは、 "http.headers" をプレフィックスとする属性として追加されます。例えば、リクエストが "x-my-header" という HTTP ヘッダーを含んでいれば、その値は "http.headers.x-my-header" という属性に追加されます。
http.headers.multipart.XXX	マルチパートリクエストで受け取った HTTP Headers のそれぞれは、 "http.headers.multipart" というプレフィックスを持つ属性として追加されます。例えば、マルチパートリクエストが "content-disposition" という名前の HTTP ヘッダーを含んでいる場合、その値は "http.headers.multipart.content-disposition" という名前の属性に追加されます。
http.multipart.size	Content-Type "multipart/form-data" のリクエストでは、パートのコンテンツサイズはこの属性に記録されます。
http.multipart.content.type	Content-Type "multipart/form-data" のリクエストでは、パートのコンテントタイプはこの属性に記録されます。
http.multipart.name	Content-Typeが "multipart/form-data" のリクエストでは、パート名はこの属性に記録されます。
http.multipart.filename	Content-Type "multipart/form-data" のリクエストでは、パートがアップロードされたファイルを含むとき、ファイル名はこの属性に記録されます。ファイルは、 "java.io.File" Java Docs)で指定されたデフォルトの仮ファイル・ディレクトリに一時的に保存されます。
http.multipart.fragments.sequence.number	Content-Type "multipart/form-data" のリクエストでは、パートのインデックスがこの属性に記録されます。インデックスは1から始まります。
http.multipart.fragments.total.number	Content-Type "multipart/form-data" のリクエストでは、すべてのパートのカウントがこの属性に記録されます。

こちらもご覧ください¶

org.apache.nifi.processors.standard.HandleHttpResponse