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 |
Legt den Content-Disposition HTTP-Header fest, der angibt, ob der Inhalt inline angezeigt werden soll oder heruntergeladen werden soll. Mögliche Werte sind ‚inline‘ oder ‚attachment‘. Wenn diese Eigenschaft nicht angegeben ist, wird die Content-Disposition des Objekts auf den Dateinamen gesetzt. Wenn ‚attachment‘ ausgewählt ist, wird automatisch ‚; filename=‘ plus Objektschlüssel angehängt, um den endgültigen Wert zu bilden: ‚attachment; filename=“filename.jpg“‘. |
Content Type |
Legt den Inhaltstyp HTTP-Header fest, der den Typ des im zugehörigen Objekt gespeicherten Inhalts angibt. Der Wert dieses Headers ist ein Standard-MIME-Typ. Der AWS S3-Java-Client versucht, den korrekten Inhaltstyp zu ermitteln, wenn er noch nicht eingestellt wurde. Die Benutzer sind dafür verantwortlich, dass beim Hochladen der Streams ein geeigneter Inhaltstyp eingestellt wird. Wenn kein Inhaltstyp angegeben ist und durch den Dateinamen nicht bestimmt werden kann, wird der Standard-Inhaltstyp „application/octet-stream“ verwendet. |
Name der kundenspezifischen Signer-Klasse |
Vollqualifizierter Klassenname der kundenspezifischen Signer-Klasse. Der Signer muss die Signer-Schnittstelle com.amazonaws.auth implementieren. |
Speicherort des kundenspezifischen Signer-Moduls |
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. |
Verschlüsselungsdienst |
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 |
Gibt den Schwellenwert der Dateigröße für den Wechsel von der PutS3Object API zur PutS3MultipartUpload API an. Workflow-Dateien, die größer als diese Beschränkung sind, werden mit dem zustandsabhängigen mehrteiligen Prozess gesendet. Der gültige Bereich ist 50MB bis 5GB |
Multipart Upload AgeOff Interval |
Gibt das Intervall an, in dem bestehende mehrteilige Uploads in AWS S3 auf Überalterung (AgeOff) ausgewertet werden. Wenn der Prozessor ausgelöst wird, leitet er die AgeOff-Auswertung ein, falls dieses Intervall überschritten wurde. |
Multipart Upload Max Age Threshold |
Gibt das maximale Alter für bestehende mehrteilige Uploads in AWS S3 an. Wenn der AgeOff-Prozess stattfindet, wird jeder Upload, der älter als dieser Schwellenwert ist, abgebrochen. |
Object Key |
Der zu verwendende S3-Objektschlüssel. Dies entspricht einem Dateinamen in herkömmlichen Dateisystemen. |
Präfix für Objekt-Tags |
Gibt das Präfix an, das anhand der Attribute des eingehenden FlowFile gescannt werden soll, wobei der Name und der Wert des übereinstimmenden Attributs als Tag-Name bzw. Tag-Wert des ausgehenden S3-Objekts betrachtet werden. Beispiel: Wenn das eingehende FlowFile die Attribute tagS3country, tagS3PII aufweist, würde das anzugebende Tag-Präfix‘ tagS3‘ lauten. |
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. |
Tag-Präfix entfernen |
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 |
Serverseitige Verschlüsselung |
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 |