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.

Tags

AWS, Amazon, Archiv, ablegen, S3

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

Siehe auch: