InvokeHTTP 2025.5.31.15¶

バンドル¶

org.apache.nifi | nifi-standard-nar

説明¶

構成可能な HTTP エンドポイントと対話できる HTTP クライアントプロセッサー。宛先 URL と HTTP メソッドは構成可能です。HTTP Methodが PUT、 POST、または PATCH の場合、 FlowFile コンテンツはリクエスト本文として含まれ、 FlowFile 属性は、構成プロパティに基づいて、オプションで HTTP ヘッダーに変換されます。

タグ¶

クライアント、http、https、rest

入力要件¶

ALLOWED

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

true

プロパティ¶

プロパティ	説明
接続タイムアウト	HTTP URL への初期ソケット接続待ちの最大時間。
HTTP メソッド	HTTP リクエストメソッド (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)。任意のメソッドもサポートしています。POST、 PUT、 PATCH 以外のメソッドは、メッセージ本文なしで送信されます。
HTTP URL	HTTP リモート URL には、http または https のスキームと、ホスト名または IP アドレス、オプションでポートとパスの要素が含まれます。URL のエンコーディングはユーザーが行う必要があります。
HTTP/2 無効	HTTP/2 プロトコルのネゴシエーションを無効にします。HTTP/2には TLS が必要です。HTTP/2 が無効の場合、 HTTP/1.1 プロトコルのサポートが必要です。
OAuth2 アクセス・トークンのリフレッシュストラテジー	OAuth2 アクセストークンのリフレッシュに使用するストラテジーを指定します。
本文有効化のリクエスト	PATCH、 POST、 PUT メソッドに対して HTTP リクエスト本文の送信を有効にします。
チャンク転送エンコード有効のリクエスト	Transfer-Encoding ヘッダをチャンクにセットした HTTP リクエストの送信を有効にし、Content-Length ヘッダーの送信を無効にします。Transfer-Encoding は、 RFC 7230 セクション3.3.1で述べられているように、 HTTP/1.1リクエストの本文に適用されます。
Content-Encodingリクエスト	HTTP 送信中にリクエスト本文に適用される Content-Encoding。リクエストの失敗を避けるために、受信側のサーバーは選択されたエンコーディングをサポートしなければなりません。
コンテンツタイプのリクエスト	HTTP PATCH, POST, PUT メソッドに対して HTTP リクエスト本文を送るときに適用される Content-Type ヘッダー。Content-Typeが構成されていない場合、デフォルトはアプリケーション/オクテットストリームです。
日付ヘッダー有効化のリクエスト	RFC 7231セクション7.1.1.2で述べられているように、 HTTP リクエストで HTTP 日付ヘッダーの送信を有効にします。
ダイジェスト認証コード有効化のリクエスト	RFC 7616 で説明されているように、ユーザー名とパスワードによる HTTP リクエストでダイジェスト認証を有効にします。
失敗ペナルティ有効化のリクエスト	ステータスコードが400から499の間の HTTP レスポンスを受信した場合に、リクエスト FlowFiles のペナルティを有効にします。
ヘッダー属性パターンのリクエスト	リクエストの HTTP ヘッダーとして送信する FlowFile 属性を定義する正規表現です。定義されていない場合、属性はヘッダーとして送信されません。動的プロパティは常にヘッダーとして送信されます。動的プロパティ名がヘッダーキーとなり、式言語として解釈される動的プロパティ値がヘッダー値となります。属性とその値は、 HTTP プロトコルの要求により、 ASCII 文字に制限されています。
マルチパートフォームデータファイル名有効化のリクエスト	multipart/form-data HTTP リクエストの Content-Disposition ヘッダーの filename パラメーターとして FlowFile filename 属性の送信を有効にします。
マルチパートフォーム-データ名のリクエスト	multipart/form-dataを使用してフォーマットされ、構成されたフォーム名を使用する HTTP リクエスト本文の送信を有効にします。
OAuth2 アクセストークンプロバイダのリクエスト	Authorization Headerを使用して HTTP リクエストに適用される OAuth2 Bearer Tokenの管理された取得を可能にします。
パスワードのリクエスト	HTTP リクエストの認証コードとして提供されるパスワード。RFC 7617 に記述されているように、 HTTP Basic Authentication 用に Base64 を使用してエンコードされています。
ユーザーエージェントのリクエスト	HTTP リクエストに適用される User-Agent ヘッダー。RFC 7231 の 5.5.3項では推奨形式について説明しています。
ユーザー名のリクエスト	HTTP リクエストの認証コードとして提供されるユーザー名。RFC 7617 に記述されているように、 HTTP Basic Authentication 用に Base64 を使用してエンコードされています。
本文属性名レスポンス	FlowFile Original リレーションシップに転送された FlowFiles の HTTP レスポンス本文を記述するために使用される属性名。
本文属性サイズレスポンス	FlowFile 属性に HTTP レスポンス本文を書き込む際に適用される、バイト単位の最大サイズ。最大値を超える属性は切り捨てられます。
無視される本文レスポンス	レスポンス関係への HTTP レスポンス FlowFiles の書き込みを無効にします。
キャッシュ有効化レスポンス	RFC 7234 で説明されている HTTP レスポンスキャッシュを有効にします。レスポンスのキャッシュでは、 ETag およびその他のヘッダーを考慮します。
キャッシュサイズレスポンス	HTTP レスポンスキャッシュの最大サイズ（バイト）。レスポンスのキャッシュでは、 ETag およびその他のヘッダーを考慮します。
クッキーストラテジーレスポンス	HTTP クッキーを受け入れ、永続化するためのストラテジー。クッキーを受け入れることで、複数のリクエストにまたがる永続性が可能になります。
FlowFile ネーミングストラテジーレスポンス	レスポンス関係に転送された FlowFiles の filename 属性のセットに使用されるストラテジーを決定します。
必要なジェネレーションレスポンス	HTTP レスポンスの受信にかかわらず、レスポンス関係への FlowFile の生成と転送を有効にします。
ヘッダーリクエスト属性有効化レスポンス	Original、Retry、または No Retry のリレーションシップに転送された FlowFiles に、 HTTP レスポンスヘッダーを属性として追加できるようにします。
ヘッダリクエスト属性プレフィックスレスポンス	Original、Retry、または No Retry リレーションシップに転送された FlowFiles の属性として含まれる場合、 HTTP レスポンスヘッダーのプレフィックス。「.」や「-」のような区切り文字で終わることをお勧めします。
リダイレクトの有効化レスポンス	RFC 7231セクション6.4で説明されているように、 HTTP 300シリーズレスポンスで送信される以下の HTTP リダイレクトを有効にします。
SSL コンテキストサービス	SSL Context Serviceは、 TLS の通信に信頼できる証明書とクライアント証明書をプロバイダーとして提供します。
ソケットアイドル接続	HTTP URL への最大アイドル接続数。
ソケットアイドルタイムアウト	HTTP URL へのアイドル接続を閉じるまでの最大待機時間。
ソケット読み取りタイムアウト	HTTP URL へのソケット接続から応答を受信するまでの最大待ち時間。
ソケット書き込みタイムアウト	ソケット接続から HTTP URL にリクエストを送信している間、書き込み操作の待ち時間の最大値。
proxy-configuration-service	ネットワークリクエストをプロキシするプロキシ構成Controller Serviceを指定します。SOCKS の場合、選択された SOCKS バージョンがプロセッサーで使用されることは保証されません。

リレーションシップ¶

名前	説明
失敗	ソケット通信エラー受信時に転送されるリクエスト FlowFiles。
リトライなし	ステータスコードが400から499の間の HTTP レスポンスを受信した場合に転送されるリクエスト FlowFiles。
オリジナル	ステータスコード200から299の間の HTTP レスポンスを受信したときに転送されるリクエスト FlowFiles。
応答	ステータスコードが200から299の間の HTTP レスポンスを受信したときに転送されるレスポンス FlowFiles。
再試行	ステータスコード500から599の間の HTTP レスポンスを受信した場合に転送されるリクエスト FlowFiles。

属性の書き込み¶

名前	説明
invokehttp.status.code	返されるステータスコード
invokehttp.status.message	返されるステータスメッセージ
invokehttp.response.body	受信したステータスコードが成功 (2xx) でない場合、レスポンス本文はリクエスト FlowFile の 'invokehttp.response.body' 属性に格納されます。
invokehttp.request.url	当初のリクエスト URL
invokehttp.request.duration	外部エンドポイントへの HTTP 呼び出しの継続時間（ミリ秒）。
invokehttp.response.url	リダイレクトを経て最終的にリクエストされた URL
invokehttp.tx.id	レスポンスを読んだ後に返されるトランザクション ID
invokehttp.remote.dn	リモートサーバーの DN
invokehttp.java.exception.class	プロセッサーが失敗したときに発生するJava例外クラス
invokehttp.java.exception.message	プロセッサーが失敗したときに発生するJava例外メッセージ
user-defined	もし 'Put Response Body In Attribute' プロパティがセットされていれば、それが属性キーになり、値は HTTP レスポンスの本文になります。