FetchS3Object 2025.5.31.15

Bundle

org.apache.nifi | nifi-aws-nar

Beschreibung

Ruft den Inhalt eines S3-Objekts ab und schreibt ihn in den Inhalt eines FlowFile

Tags

AWS, Amazon, abrufen, holen, 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

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.

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.

Object Key

Der zu verwendende S3-Objektschlüssel. Dies entspricht einem Dateinamen in herkömmlichen Dateisystemen.

Region

Die AWS-Region, mit der Sie sich verbinden möchten.

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.

Version

Die Version des Objekts zum Herunterladen

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.

range-length

Die Anzahl der Bytes, die vom Objekt heruntergeladen werden sollen, beginnend mit dem „Range Start“. Ein leerer Wert oder ein Wert, der über das Ende des Objekts hinausgeht, wird bis zum Ende des Objekts gelesen.

range-start

Die Byte-Position, an der das Lesen aus dem Objekt beginnen soll. Bei einem leeren Wert oder einem Wert von Null beginnt das Lesen am Anfang des Objekts.

requester-pays

Bei „true“ bedeutet dies, dass der Anfragende zustimmt, alle mit dem Abruf von Objekten aus dem S3-Bucket verbundenen Gebühren zu zahlen. Dies setzt den Header „x-amz-request-payer“ auf „requester“.

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 Name des S3-Buckets

Pfad

Der Pfad der Datei

absolute.path

Der Pfad der Datei

filename

Der Name der Datei

hash.value

Die MD5-Summe der Datei

hash.algorithm

MD5

mime.type

Wenn S3 den Inhaltstyp/MIME-Typ bereitstellt, enthält dieses Attribut diese Datei.

s3.etag

Das ETag, das verwendet werden kann, um zu sehen, ob sich die Datei geändert hat

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.expirationTime

Wenn die Datei ein Verfallsdatum hat, wird dieses Attribut gesetzt, das die Millisekunden seit Epoche in UTC-Zeit enthält.

s3.expirationTimeRuleId

Die ID der Regel, die die Ablaufzeit dieses Objekts vorgibt

s3.sseAlgorithmus

Der serverseitige Verschlüsselungsalgorithmus des Objekts

s3.version

Die Version des S3-Objekts

s3.encryptionStrategy

Der Name der Verschlüsselungsstrategie, die zum Speichern des S3-Objekts verwendet wurde (falls es verschlüsselt ist)

Anwendungsfälle

Abrufen einer bestimmte Datei aus S3

Anwendungsfälle mit anderen Komponenten

Abrufen aller Dateien in einem S3-Bucket

Nur Dateien aus S3 abrufen, die bestimmte Kriterien erfüllen

Neue Dateien abrufen, sobald sie in einem S3-Bucket eintreffen.

Siehe auch: