S3

Zweck

Das S3-Element ist ein leistungsstarkes Werkzeug zur Verwaltung von Dateien in einem Amazon Web Services (AWS) S3 Bucket. Es ermöglicht Ihnen, grundlegende Dateioperationen wie das Lesen, Schreiben und Suchen von Dateien direkt in Ihrem S3-Speicher durchzuführen.

• Dieses Element ist unerlässlich für jeden Cloud-nativen Workflow, der S3 zur Datenspeicherung verwendet (z. B. Verarbeitung von Data Lakes, Verwaltung von Anwendungs-Assets oder Speicherung generierter Berichte).

Anwendungsfälle:

• Lesen einer Datendatei aus einem S3-Bucket zur Verarbeitung.

• Schreiben eines generierten Berichts oder Datenexports direkt in einen S3-Bucket.

• Suchen nach allen .csv-Dateien in einem bestimmten S3-Präfix (Ordner), um sie zu verarbeiten.

---

Praktische Anwendungshinweise

• Berechtigungen: Stellen Sie sicher, dass die AWS-Anmeldeinformationen die erforderlichen IAM-Berechtigungen (s3:GetObject, s3:PutObject, s3:ListBucket usw.) haben, um die ausgewählten Aktionen in Ihrem Bucket durchzuführen.

• S3 ist kein Dateisystem: Denken Sie daran, dass S3 ein Objektspeicher ist. Die verwendeten Begriffe wie „Verzeichnisse“ sind technisch gesehen nur gemeinsame Präfixe in den Objektschlüsseln.

• Suchen optimieren: Die Suchen-Operation kann bei sehr großen Buckets langsam sein. Schränken Sie die Suche nach Möglichkeit ein, indem Sie einen spezifischen Verzeichnis (Präfix) angeben.

---

Konfigurationsoptionen

Die Konfiguration unterteilt sich in die S3-Verbindungsdetails und die spezifische auszuführende Aktion.

Authentifizierung (S3-Verbindungseinstellungen)

Einstellung	Beschreibung	Hinweise
Type	Die Authentifizierungsmethode: Key and Secret oder das sicherere AssumeRole.
Key / Secret	Ihr AWS Access Key und Secret Key.	Nur für den Key and Secret-Typ.
Role ARN / Role Session Name	Ihre IAM Role ARN und ein Sitzungsname.	Nur für den AssumeRole-Typ.
Bucket	Der Name des S3-Buckets, mit dem Sie sich verbinden möchten.
Region	Die AWS-Region, in der sich Ihr Bucket befindet (z. B. eu-central-1).
Root	Ein optionales Stammverzeichnis (Präfix) innerhalb des Buckets. Alle Pfade sind relativ dazu.

📌 Verbindung testen: Sie können die Schaltfläche „Verbindung testen“ verwenden, um Ihre Anmeldeinformationen zu überprüfen.

Elementkonfiguration

Typ	Beschreibung
Lesen	Liest den Inhalt eines einzelnen Objekts.
Schreiben	Erstellt ein neues Objekt oder überschreibt ein bestehendes.
Suchen	Listet alle Objekte auf, die einem bestimmten Pfad und Muster entsprechen.

Eingaben nach Typ

Aktionstyp	Erforderliche Eingaben
Für Lesen	Dateiname (Der vollständige Schlüssel des S3-Objekts).
Für Schreiben	Verzeichnis (Zielpräfix), Dateiname, Inhalt (Die Daten, die geschrieben werden sollen).
Für Suchen	Verzeichnis (Zu durchsuchendes Präfix), Suchmuster (z. B. *.json).

---

Eingabe-/Ausgabe-Erwartungen

Eingabe

Variiert je nach ausgewähltem Typ.

Ausgabe

Das Element erzeugt eine einzige Result-Variable.

Aktionstyp	Inhalt der Ausgabe Result	Format
Lesen	Der gesamte Inhalt des S3-Objekts.	String.
Schreiben	Der vollständige Schlüssel (Pfad) des Objekts, das geschrieben wurde.	String.
Suchen	Ein JSON-Array von Objekten, wobei jedes Objekt Details zu einem gefundenen S3-Objekt enthält.	JSON-Array von Objekten.

---