PutS3Object 2025.10.2.19¶
Bundle¶
org.apache.nifi | nifi-aws-nar
Beschreibung¶
Schreibt den Inhalt eines FlowFile als S3-Objekt in einen Amazon S3 Bucket.
Eingabeanforderung¶
REQUIRED
Unterstützt sensible dynamische Eigenschaften¶
false
Eigenschaften¶
Eigenschaft |
Beschreibung |
|---|---|
AWS-Anmeldeinformationen-Anbieterdienst |
Der Controller Service, der verwendet wird, um AWS-Anmeldeinformationsanbieter zu erhalten |
Bucket |
Der S3-Bucket, mit dem interagiert werden soll |
Cache Control |
Legt den Cache-ControlHTTP-Header fest, der die Caching-Richtlinien des zugehörigen Objekts angibt. Mehrere Richtlinien werden durch Komma getrennt. |
Canned ACL |
Amazon Canned ACL für ein Objekt, entweder: BucketOwnerFullControl, BucketOwnerRead, LogDeliveryWrite, AuthenticatedRead, PublicReadWrite, PublicRead, Private; wird ignoriert, wenn eine andere ACL-Berechtigungs-/Eigentümer-Eigenschaft angegeben ist |
Communications Timeout |
Die Zeitspanne, die gewartet wird, um eine Verbindung zu AWS herzustellen oder Daten von AWS zu empfangen, bevor es zu einem Timeout kommt. |
Content Disposition |
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“‘. |
Content Type |
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 |
Durch Kommas getrennte Liste von Pfaden zu Dateien und/oder Verzeichnissen, die die JAR-Datei des benutzerdefinierten Signierers und deren Abhängigkeiten (falls vorhanden) enthalten. |
Encryption Service |
Gibt den Verschlüsselungsdienst-Controller an, der zur Konfiguration von Anfragen verwendet wird. PutS3Object: Aus Gründen der Abwärtskompatibilität wird dieser Wert ignoriert, wenn „Server Side Encryption“ eingestellt ist. FetchS3Object: Muss nur bei serverseitiger Kundenschlüssel-, clientseitiger KMS- und clientseitiger Kundenschlüsselverschlüsselung konfiguriert werden. |
Endpoint Override URL |
Endpunkt-URL, die anstelle des AWS Standardwerts verwendet werden soll, einschließlich Schema, Host, Port und Pfad. Die AWS-Bibliotheken wählen eine Endpunkt-URL auf der Grundlage der AWS-Region aus, aber diese Eigenschaft überschreibt die ausgewählten Endpunkt-URL und ermöglicht die Verwendung mit anderen S3-kompatiblen Endpunkten. |
Expiration Time Rule |
|
File Resource Service |
Dateiressourcendienst, der den Zugriff auf die zu übertragende lokale Ressource ermöglicht |
FullControl User List |
Eine durch Kommas getrennte Liste von IDs oder E-Mail-Adressen von Amazon-Benutzern, die angibt, wer volle Kontrolle über ein Objekt haben soll |
Multipart Part Size |
Gibt die Teilegröße an, die bei Verwendung der PutS3Multipart Upload-API verwendet wird. FlowFiles werden für den Upload in Blöcke dieser Größe aufgeteilt, aber der letzte gesendete Teil kann kleiner sein, da er nicht aufgefüllt wird. Der gültige Bereich ist 50MB bis 5GB. |
Multipart Threshold |
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. |
Multipart Upload AgeOff Interval |
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. |
Multipart Upload Max Age Threshold |
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. |
Object Key |
Der zu verwendende S3-Objektschlüssel. Dies entspricht einem Dateinamen in herkömmlichen Dateisystemen. |
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‘ |
Eigentümer |
Die Amazon-ID, die für den Eigentümer des Objekts verwendet werden soll |
Read ACL User List |
Eine durch Kommas getrennte Liste von IDs oder E-Mail-Adressen von Amazon-Benutzern, die angibt, wer die Berechtigung haben soll, die Zugriffssteuerungsliste für ein Objekt zu lesen |
Read Permission User List |
Eine durch Kommas getrennte Liste von IDs oder E-Mail-Adressen von Amazon-Benutzern, die angibt, wer Lesezugriff auf ein Objekt haben soll |
Region |
Die AWS-Region, mit der Sie sich verbinden möchten. |
Remove Tag Prefix |
Wenn diese Einstellung auf „true“ gesetzt ist,, wird der für „Object Tags Prefix“ angegebene Wert aus dem/den Attribut(en) entfernt und als Tag-Name verwendet. Beispiel: Wenn das eingehende FlowFile die Attribute tagS3country, tagS3PII trägt und das Präfix auf „tagS3“ gesetzt ist, dann sind die entsprechenden Tag-Werte „country“ und „PII“ |
Resource Transfer Source |
Die Quelle des zu übertragenden Inhalts |
SSL Context Service |
Gibt einen optionalen SSL Context Service an, der, falls vorhanden, zum Erstellen von Verbindungen verwendet wird |
Server Side Encryption |
Gibt den für die serverseitige Verschlüsselung verwendeten Algorithmus an. |
Signer Override |
Die AWS-S3-Bibliothek verwendet standardmäßig die Signaturversion 4, aber mit dieser Eigenschaft können Sie den Signierer der Version 2 angeben, um ältere S3-kompatible Dienste zu unterstützen oder sogar Ihre eigene benutzerdefinierte Signierer-Implementierung einzubinden. |
Storage Class |
|
Temporary Directory Multipart State |
Verzeichnis, in dem der Prozessor bei mehrteiligen Uploads lokal den Status speichert, der die Upload-ID und die hochgeladenen Teile verfolgt, die beide bereitgestellt werden müssen, um den Upload abzuschließen. |
Use Chunked Encoding |
Aktiviert/deaktiviert Chunked-Encoding für Upload-Anfragen. Setzen Sie ihn nur dann auf „false“, wenn Ihr Endpunkt das Hochladen in Blöcken nicht unterstützt. |
Use Path Style Access |
Der Zugriff auf den Pfad kann erzwungen werden, indem Sie diese Eigenschaft auf „true“ setzen. Setzen Sie die Einstellung auf „true“, wenn Ihr Endpunkt keine Anfragen im Virtual-Host-Stil unterstützt, sondern nur Anfragen im Pfadstil. |
Write ACL User List |
Eine durch Kommas getrennte Liste von IDs oder E-Mail-Adressen von Amazon-Benutzern, die angibt, wer die Berechtigung haben soll, die Zugriffssteuerungsliste für ein Objekt zu ändern |
Write Permission User List |
Eine durch Kommas getrennte Liste von IDs oder E-Mail-Adressen on Amazon-Benutzern, die angibt, wer Schreibzugriff für ein Objekt haben soll |
proxy-configuration-service |
Gibt den Proxy-Konfigurations-Controller Service an für die Weiterleitung von Netzwerkanforderungen festl. |
Beziehungen¶
Name |
Beschreibung |
|---|---|
failure |
Wenn der Prozessor nicht in der Lage ist, ein bestimmtes FlowFile zu verarbeiten, wird es an diese Beziehung weitergeleitet. |
success |
FlowFiles werden nach erfolgreicher Bearbeitung an diese Beziehung weitergeleitet. |
Schreibt Attribute¶
Name |
Beschreibung |
|---|---|
s3.url |
Die URL, die für den Zugriff auf das S3-Objekt verwendet werden kann |
s3.bucket |
Der S3 Bucket, in dem das Objekt in S3 abgelegt wurde |
s3.key |
Der S3-Schlüssel, unter dem das Objekt in S3 abgelegt wurde |
s3.contenttype |
Der S3-Inhaltstyp des S3-Objekts, das in S3 abgelegt wurde |
s3.version |
Die Version des S3-Objekts, die an S3 übergeben wurde |
s3.exception |
Der Klassenname der Ausnahme, die während der Ausführung des Prozessors ausgelöst wird |
s3.additionalDetails |
Die von S3 gelieferten Details der fehlgeschlagenen Operation |
s3.statusCode |
Der HTTP-Fehlercode (falls verfügbar) der fehlgeschlagenen Operation |
s3.errorCode |
Der S3-Bezeichner der fehlgeschlagenen Operation |
s3.errorMessage |
Die S3-Ausnahmemeldung der fehlgeschlagenen Operation |
s3.etag |
Das ETag des S3-Objekts |
s3.contentdisposition |
Die Inhaltsdisposition des S3-Objekts, das in S3 abgelegt wurde |
s3.cachecontrol |
Der Cache-Control-Header des S3-Objekts |
s3.uploadId |
Die uploadId, die zum Hochladen des Objekts in S3 verwendet wird |
s3.expiration |
Eine für Menschen lesbare Form des Ablaufdatums des S3-Objekts, sofern eines festgelegt ist. |
s3.sseAlgorithmus |
Der serverseitige Verschlüsselungsalgorithmus des Objekts |
s3.usermetadaten |
Eine für Menschen lesbare Form der Benutzermetadaten des S3-Objekts, sofern vorhanden. |
s3.encryptionStrategy |
Der Name der Verschlüsselungsstrategie, falls eine solche festgelegt wurde |