PutS3Object 2025.5.31.15¶
バンドル¶
org.apache.nifi | nifi-aws-nar
説明¶
FlowFile のコンテンツを S3 オブジェクトとして Amazon S3 バケットに書き込みます。
入力要件¶
REQUIRED
機密動的プロパティをサポート¶
false
プロパティ¶
プロパティ |
説明 |
|---|---|
AWS 認証情報 プロバイダーサービス |
AWS 認証情報プロバイダーの取得に使用するController Service。 |
バケット |
やり取りするS3バケット |
キャッシュコントロール |
関連オブジェクトのキャッシュディレクティブを示す Cache-Control HTTP ヘッダーをセットします。複数のディレクティブはコンマで区切られます。 |
通信タイムアウト |
AWS への接続を確立するため、または AWS からデータを受信するために、タイムアウトするまでの待機時間。 |
コンテンツの処分 |
Content-Disposition HTTP ヘッダーをセットします。このヘッダーは、コンテンツがインラインで表示されることを意図しているのか、あるいはダウンロードされることを意図しているのかを示します。指定できる値は 'inline' または 'attachment' です。このプロパティが指定されていない場合、オブジェクトの content-disposition は filename にセットされます。'attachment' が選択されると、 '; filename=' とオブジェクトキーが自動的に付加され、最終値 'attachment; filename="filename.jpg"'となります。 |
コンテンツタイプ |
関連オブジェクトに格納されているコンテンツのタイプを示す Content-Type HTTP ヘッダーをセットします。このヘッダーの値は、標準の MIME タイプです。 AWS S3 Javaクライアントは、コンテントタイプがまだセットされていない場合、正しいコンテントタイプを決定しようとします。ユーザーは、ストリームをアップロードする際に、適切なコンテンツタイプがセットされていることを確認する責任があります。コンテンツタイプが提供されず、ファイル名から判断できない場合、デフォルトのコンテンツタイプ「application/octet-stream」が使用されます。 |
エンドポイントオーバーライド URL |
スキーム、ホスト、ポート、パスを含む AWS デフォルトの代わりに使用するエンドポイント URL。AWS ライブラリは AWS リージョンに基づきエンドポイント URL を選択しますが、このプロパティは選択されたエンドポイント URL を上書きし、他の S3 互換エンドポイントとの使用を可能にします。 |
有効期限ルール |
|
ファイルリソースサービス |
転送されるローカルリソースへのアクセスを提供するファイルリソースサービス |
FullControl ユーザーリスト |
オブジェクトをフルコントロールするユーザーを指定する Amazon ユーザー ID のカンマ区切りのリストまたはメールアドレス |
マルチパート サイズ |
PutS3Multipart Upload API 使用時に使用するパーツサイズを指定します。フローファイルは、アップロード処理のためにこのサイズのチャンクに分割されますが、送信される最後の部分はパディングされないため、より小さくすることができます。有効範囲は 50MB から 5GB です。 |
マルチパートのしきい値 |
PutS3Object API から PutS3MultipartUpload API に切り替えるファイルサイズのしきい値を指定します。この制限を超えるフローファイルは、ステートフルマルチパートプロセスを使用して送信されます。有効範囲は 50MB から 5GB です。 |
マルチパート アップロード AgeOff 間隔 |
AWS S3内の既存のマルチパートアップロードがエージオフのために評価される間隔を指定します。プロセッサーがトリガーされると、この間隔を超えた場合にエージオフ評価を開始します。 |
マルチパート アップロードの最大エージしきい値 |
AWS S3にある既存のマルチパートアップロードの最大年齢を指定します。エージオフ処理が発生すると、この閾値より古いアップロードは中止されます。 |
オブジェクトキー |
使用するS3オブジェクトキー。これは従来のファイルシステムのファイル名に似ています。 |
所有者 |
オブジェクトの所有者に使用するAmazon ID |
ACL ユーザーリストを読む |
オブジェクトのアクセス制御リストの読み取り許可を持つべきユーザーを指定する Amazon User ID のカンマ区切りのリストまたはメールアドレス |
閲覧許可ユーザーリスト |
オブジェクトの読み取りアクセス権を持つユーザーを指定する、Amazon User ID のカンマ区切りのリスト、またはメールアドレス。 |
リージョン |
AWS 接続先のリージョン。 |
リソース移管元 |
転送されるコンテンツのソース |
SSL コンテキストサービス |
もしプロバイダーが提供されていれば、接続の作成に使われる SSL Context Service を指定します。 |
署名者の上書き |
AWS S3ライブラリはデフォルトで署名バージョン4を使用しますが、このプロパティを使用すると、古いS3互換サービスをサポートするためにバージョン2の署名者を指定したり、独自のカスタム署名者の実装をプラグインしたりすることができます。 |
ストレージクラス |
|
書き込み ACL ユーザーリスト |
オブジェクトのアクセス制御リストを変更する権限を持つユーザーを指定する Amazon User ID のカンマ区切りのリスト、またはメールアドレス。 |
書き込み許可ユーザーリスト |
オブジェクトの書き込みアクセス権を持つユーザーを指定する Amazon ユーザー ID のカンマ区切りのリストまたはメールアドレス |
canned-acl |
Amazon オブジェクトの定型文 ACL のいずれか: BucketOwnerFullControlBucketOwnerRead, LogDeliveryWrite, AuthenticatedRead, PublicReadWrite, PublicRead, Private; 他の ACL/permission/owner プロパティが指定されている場合は無視されます。 |
custom-signer-class-name |
カスタム署名者クラスの完全修飾クラス名。署名者はcom.amazonaws.auth.Signerインターフェイスを実装する必要があります。 |
custom-signer-module-location |
カスタム署名者の JAR ファイルとその依存関係 (もしあれば) を含むファイルやディレクトリへのパスをカンマ区切りにしたリスト。 |
encryption-service |
リクエストの構成に使用する暗号化サービスコントローラーを指定します。PutS3Object: 下位互換性のため、「サーバー側の暗号化」 がセットされている場合、この値は無視されます。FetchS3Object: サーバー側カスタマーキー、クライアント側 KMS 、クライアント側カスタマーキー暗号化の場合のみ構成が必要。 |
proxy-configuration-service |
ネットワークリクエストをプロキシするプロキシ構成Controller Serviceを指定します。 |
s3-object-remove-tags-prefix |
'True' にセットすると、 'Object Tags Prefix' に指定された値は属性から取り除かれ、タグ名とみなされます。例: FlowFile が tagS3country, tagS3PII という属性を持ち、プレフィックスが 'tagS3' にセットされている場合、対応するタグ値は 'country' と 'PII' となります。 |
s3-object-tags-prefix |
入ってくる FlowFile の属性に対してスキャンされるプレフィックスを指定し、一致する属性の名前と値は、それぞれS3オブジェクトのタグ名とタグ値とみなされます。例; 受信 FlowFile が tagS3country, tagS3PII の属性を持つ場合、指定するタグプレフィックスは 'tagS3' となります。 |
s3-temporary-directory-multipart |
マルチパートアップロードの場合、アップロードを完了するために提供されなければならないアップロード ID とアップロードされたパーツを追跡する状態を、プロセッサーがローカルに保存するディレクトリ。 |
server-side-encryption |
サーバー側の暗号化に使用するアルゴリズムを指定します。 |
use-chunked-encoding |
アップロードリクエストのチャンクエンコーディングを有効/無効にします。エンドポイントがチャンクアップロードをサポートしていない場合のみ、falseにセットしてください。 |
use-path-style-access |
このプロパティをtrueにセットすることで、パス形式のアクセスを強制することができます。エンドポイントが仮想ホスト形式のリクエストをサポートせず、パス形式のリクエストのみをサポートする場合は true をセットします。 |
リレーションシップ¶
名前 |
説明 |
|---|---|
failure |
プロセッサーが指定された FlowFile を処理できない場合、それはこのリレーションシップにルーティングされます。 |
success |
FlowFiles は、正常に処理された後、この Relationship にルーティングされます。 |
属性の書き込み¶
名前 |
説明 |
|---|---|
s3.url |
S3オブジェクトへのアクセスに使用できる URL。 |
s3.bucket |
オブジェクトがS3に置かれたS3バケット |
s3.key |
オブジェクトがS3に置かれたS3キー |
s3.contenttype |
S3に置かれたS3オブジェクトのS3コンテンツタイプ |
s3.version |
S3に投入されたS3オブジェクトのバージョン |
s3.exception |
プロセッサー実行中にスローされる例外のクラス名 |
s3.additionalDetails |
S3が提供する失敗した演算子の詳細 |
s3.statusCode |
失敗した操作の HTTP エラーコード（利用可能な場合）。 |
s3.errorCode |
失敗した演算子のS3名 |
s3.errorMessage |
失敗した演算子からのS3例外メッセージ |
s3.etag |
S3オブジェクトの ETag |
s3.contentdisposition |
S3に投入されたS3オブジェクトのコンテンツ処分 |
s3.cachecontrol |
S3 オブジェクトのキャッシュコントロールヘッダー。 |
s3.uploadId |
オブジェクトをS3にアップロードする際に使用するuploadId |
s3.expiration |
S3オブジェクトの有効期限がセットされている場合、その有効期限を人間が読める形で表したもの。 |
s3.sseAlgorithm |
オブジェクトのサーバー側の暗号化アルゴリズム。 |
s3.usermetadata |
S3オブジェクトのユーザーメタデータがセットされている場合、人間が読める形式。 |
s3.encryptionStrategy |
暗号化ストラテジーの名前 (もしセットされている場合) |