PutS3Object 2025.10.2.19¶
バンドル¶
org.apache.nifi | nifi-aws-nar
説明¶
FlowFile のコンテンツを S3 オブジェクトとして Amazon S3 バケットに書き込みます。
入力要件¶
REQUIRED
機密動的プロパティをサポート¶
false
プロパティ¶
プロパティ |
説明 |
|---|---|
AWS 認証情報 プロバイダーサービス |
AWS 認証情報プロバイダーの取得に使用するController Service。 |
バケット |
やり取りするS3バケット |
キャッシュコントロール |
関連オブジェクトのキャッシュディレクティブを示す Cache-Control HTTP ヘッダーをセットします。複数のディレクティブはコンマで区切られます。 |
Canned ACL |
Amazon オブジェクトの定型文 ACL のいずれか: BucketOwnerFullControlBucketOwnerRead, LogDeliveryWrite, AuthenticatedRead, PublicReadWrite, PublicRead, Private; 他の ACL/permission/owner プロパティが指定されている場合は無視されます。 |
通信タイムアウト |
AWS への接続を確立するため、または AWS からデータを受信するために、タイムアウトするまでの待機時間。 |
コンテンツの処分 |
Sets the Content-Disposition HTTP header indicating if the content is intended to be displayed inline or should be downloaded. Possible values are 'inline' or 'attachment'. If this property is not specified, object 's content-disposition will be set to filename. When' attachment 'is selected,'; filename='plus object key are automatically appended to form final value' attachment; filename="filename.jpg"'. |
コンテンツタイプ |
Sets the Content-Type HTTP header indicating the type of content stored in the associated object. The value of this header is a standard MIME type. AWS S3 Java client will attempt to determine the correct content type if one hasn't been set yet. Users are responsible for ensuring a suitable content type is set when uploading streams. If no content type is provided and cannot be determined by the filename, the default content type "application/octet-stream" will be used. |
Custom Signer Class Name |
Fully qualified class name of the custom signer class. The signer must implement com.amazonaws.auth. Signer interface. |
Custom Signer Module Location |
カスタム署名者の JAR ファイルとその依存関係 (もしあれば) を含むファイルやディレクトリへのパスをカンマ区切りにしたリスト。 |
Encryption Service |
リクエストの構成に使用する暗号化サービスコントローラーを指定します。PutS3Object: 下位互換性のため、「サーバー側の暗号化」 がセットされている場合、この値は無視されます。FetchS3Object: サーバー側カスタマーキー、クライアント側 KMS 、クライアント側カスタマーキー暗号化の場合のみ構成が必要。 |
エンドポイントオーバーライド URL |
スキーム、ホスト、ポート、パスを含む AWS デフォルトの代わりに使用するエンドポイント URL。AWS ライブラリは AWS リージョンに基づきエンドポイント URL を選択しますが、このプロパティは選択されたエンドポイント URL を上書きし、他の S3 互換エンドポイントとの使用を可能にします。 |
有効期限ルール |
|
ファイルリソースサービス |
転送されるローカルリソースへのアクセスを提供するファイルリソースサービス |
FullControl ユーザーリスト |
オブジェクトをフルコントロールするユーザーを指定する Amazon ユーザー ID のカンマ区切りのリストまたはメールアドレス |
マルチパート サイズ |
PutS3Multipart Upload API 使用時に使用するパーツサイズを指定します。フローファイルは、アップロード処理のためにこのサイズのチャンクに分割されますが、送信される最後の部分はパディングされないため、より小さくすることができます。有効範囲は 50MB から 5GB です。 |
マルチパートのしきい値 |
Specifies the file size threshold for switch from the PutS3Object API to the PutS3MultipartUpload API. Flow files bigger than this limit will be sent using the stateful multipart process. The valid range is 50MB to 5GB. |
マルチパート アップロード AgeOff 間隔 |
Specifies the interval at which existing multipart uploads in AWS S3 will be evaluated for ageoff. When processor is triggered it will initiate the ageoff evaluation if this interval has been exceeded. |
マルチパート アップロードの最大エージしきい値 |
Specifies the maximum age for existing multipart uploads in AWS S3. When the ageoff process occurs, any upload older than this threshold will be aborted. |
オブジェクトキー |
使用するS3オブジェクトキー。これは従来のファイルシステムのファイル名に似ています。 |
Object Tags Prefix |
Specifies the prefix which would be scanned against the incoming FlowFile 's attributes and the matching attribute's name and value would be considered as the outgoing S3 object 's Tag name and Tag value respectively. For Ex: If the incoming FlowFile carries the attributes tagS3country, tagS3PII, the tag prefix to be specified would be' tagS3' |
所有者 |
オブジェクトの所有者に使用するAmazon ID |
ACL ユーザーリストを読む |
オブジェクトのアクセス制御リストの読み取り許可を持つべきユーザーを指定する Amazon User ID のカンマ区切りのリストまたはメールアドレス |
閲覧許可ユーザーリスト |
オブジェクトの読み取りアクセス権を持つユーザーを指定する、Amazon User ID のカンマ区切りのリスト、またはメールアドレス。 |
リージョン |
AWS 接続先のリージョン。 |
Remove Tag Prefix |
'True' にセットすると、 'Object Tags Prefix' に指定された値は属性から取り除かれ、タグ名とみなされます。例: FlowFile が tagS3country, tagS3PII という属性を持ち、プレフィックスが 'tagS3' にセットされている場合、対応するタグ値は 'country' と 'PII' となります。 |
リソース移管元 |
転送されるコンテンツのソース |
SSL コンテキストサービス |
もしプロバイダーが提供されていれば、接続の作成に使われる SSL Context Service を指定します。 |
Server Side Encryption |
サーバー側の暗号化に使用するアルゴリズムを指定します。 |
署名者の上書き |
AWS S3ライブラリはデフォルトで署名バージョン4を使用しますが、このプロパティを使用すると、古いS3互換サービスをサポートするためにバージョン2の署名者を指定したり、独自のカスタム署名者の実装をプラグインしたりすることができます。 |
ストレージクラス |
|
Temporary Directory Multipart State |
マルチパートアップロードの場合、アップロードを完了するために提供されなければならないアップロード ID とアップロードされたパーツを追跡する状態を、プロセッサーがローカルに保存するディレクトリ。 |
Use Chunked Encoding |
アップロードリクエストのチャンクエンコーディングを有効/無効にします。エンドポイントがチャンクアップロードをサポートしていない場合のみ、falseにセットしてください。 |
Use Path Style Access |
このプロパティをtrueにセットすることで、パス形式のアクセスを強制することができます。エンドポイントが仮想ホスト形式のリクエストをサポートせず、パス形式のリクエストのみをサポートする場合は true をセットします。 |
書き込み ACL ユーザーリスト |
オブジェクトのアクセス制御リストを変更する権限を持つユーザーを指定する Amazon User ID のカンマ区切りのリスト、またはメールアドレス。 |
書き込み許可ユーザーリスト |
オブジェクトの書き込みアクセス権を持つユーザーを指定する Amazon ユーザー ID のカンマ区切りのリストまたはメールアドレス |
proxy-configuration-service |
ネットワークリクエストをプロキシするプロキシ構成Controller Serviceを指定します。 |
リレーションシップ¶
名前 |
説明 |
|---|---|
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 |
暗号化ストラテジーの名前 (もしセットされている場合) |