PutS3Object 2025.5.31.15¶
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. |
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 HTTPHTTP-Header „Content-Disposition“ fest, der angibt, ob der Inhalt inline angezeigt oder heruntergeladen werden soll. Mögliche Werte sind „inline“ oder „attachment“. Wenn diese Eigenschaft nicht angegeben ist, wird die Content Disposition des Objekts auf „Dateiname“ gesetzt. Wenn „attachment“ ausgewählt ist, wird automatisch „; filename=“ zusammen mit dem Objektschlüssel angehängt, sodass der endgültige Wert ‚attachment; filename=“filename.jpg“‘ entsteht. |
Content Type |
Legt den HTTP-Header Content-Type fest, der den Typ des Inhalts im zugehörigen Objekt angibt. Der Wert dieses Headers ist ein Standard-MIME-Typ. Der AWS-S3 Java-Client versucht, den richtigen Inhaltstyp zu ermitteln, wenn noch keiner festgelegt wurde. Benutzer sind dafür verantwortlich, dass beim Hochladen von Streams ein geeigneter Inhaltstyp eingestellt ist. Wird kein Inhaltstyp angegeben und kann dieser auch nicht anhand des Dateinamens ermittelt werden, wird der Standardinhaltstyp „application/octet-stream“ verwendet. |
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 |
Legt den Schwellenwert der Dateigröße für den Wechsel von der PutS3Object-API zur PutS3MultipartUpload-API fest. FlowFiles, die diese Grenze überschreiten, werden mit dem zustandsabhängigen Multipart-Verfahren gesendet. Der gültige Bereich ist 50MB bis 5GB. |
Multipart Upload AgeOff Interval |
Legt das Intervall fest, in dem vorhandene Multipart-Uploads in AWS S3 auf Verfallskriterien (Age-Off) geprüft werden. Wenn der Prozessor ausgelöst wird, initiiert er die Ageoff-Auswertung, wenn dieses Intervall überschritten wurde. |
Multipart Upload Max Age Threshold |
Gibt das maximale Alter für bestehende Multipart-Uploads in AWS S3 an. Wenn der Alterungsprozess stattfindet, werden alle Uploads, die älter als dieser Schwellenwert sind, abgebrochen. |
Object Key |
Der zu verwendende S3-Objektschlüssel. Dies entspricht einem Dateinamen in herkömmlichen Dateisystemen. |
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. |
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 |
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 |
|
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 |
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 |
custom-signer-class-name |
Vollständig qualifizierter Klassenname der benutzerdefinierten Signaturklasse. Der Signierer muss die Schnittstelle „com.amazonaws.auth.Signer“ implementieren. |
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. |
proxy-configuration-service |
Gibt den Proxy-Konfigurations-Controller Service an für die Weiterleitung von Netzwerkanforderungen festl. |
s3-object-remove-tags-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“ |
s3-object-tags-prefix |
Gibt das Präfix an, das mit den eingehenden Attributen des FlowFile abgeglichen wird. Der Name und der Wert des übereinstimmenden Attributs werden als Tag-Name bzw. Tag-Wert des ausgehenden S3-Objekts betrachtet. Beispiel: Wenn das eingehende FlowFile die Attribute „tagS3country“, tagS3PII enthält, lautet das anzugebende Tag-Präfix „tagS3“. |
s3-temporary-directory-multipart |
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. |
server-side-encryption |
Gibt den für die serverseitige Verschlüsselung verwendeten Algorithmus an. |
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. |
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 |