Amazon S3-Bucket

Der Trigger "Amazon S3" (Simple Storage Service) fragt Aktivitäten in einem Amazon S3-Bucket ab und sendet JSON-Nachrichten zu dieser Aktivität, z. B. wenn Dateien hinzugefügt, geändert und gelöscht werden.

Der Trigger "Amazon S3" verfügt über zwei Ausgabe-Ports. Der Success-Port (✔) kann eine Nachricht senden, wenn der Trigger erfolgreich abgefragt hat. Der Failure-Port (x) kann eine Nachricht senden, wenn der Trigger beim Abfragen fehlschlägt.

Hinweis  Wenn ein Trigger "Amazon S3" aufgesetzt wird, können Sie festlegen, wie häufig ein S3-Bucket abgefragt wird. Beachten Sie dabei, dass es sich bei Amazon S3 um einen Pay-Per-Use-Service handelt. Bei jeder Abfrage handelt es sich um einen kostenpflichtigen Abruf dieses Dienstes.

Parameter

Hinweis  Siehe auch Arbeiten mit Parametern in Automatisierungs-Workflows.
Tipp  Um zu testen, ob Ihre Parameter wie erwartet funktionieren, klicken Sie auf Validieren.
  • Zu überwachendes Bucket: Der Name des Amazon S3-Buckets unter Berücksichtigung der Groß- / Kleinschreibung.
    • Hinweis  Weitere Informationen zum Suchen von Buckets in der Amazon S3 Console finden Sie unter Support for Viewing Data im Console User Guide.
  • AWS-Zugriffsschlüssel-ID und AWS Geheimer Zugriffsschlüssel: Geben Sie Ihre AWS-Sicherheitsanmeldeinformationen an. Für weitere Informationen, siehe AWS-Sicherheitsanmeldeinformationen.
  • Region: Die Region des angegebenen Buckets. Dieses Feld ist optional; in manchen Fällen kann der Trigger "Amazon S3" den Bucket jedoch ohne dieses Feld nicht validieren.
  • Zu überwachender Pfad (Optional): Geben Sie einen Ordner im angegebenen Bucket mithilfe von Schrägstrichen an.
    • Warnhinweis  Stellen Sie sicher, dass der angegebene Pfad gültig ist. Der S3 Watch Publisher führt zurzeit keine Überprüfung durch, dass der Pfad vorhanden ist. Wenn dies nicht der Fall ist, kann die Abfrageaktivität zu falsch positiven Ergebnissen führen.

    Folgende Eingaben werden akzeptiert:

    • myfolders/testfolder
    • /myfolders/testfolder
    • //myfolders/testfolder
    • myfolders/testfolder/
    • /myfolders/testfolder/

    Wenn keine Eingabe erfolgt, beobachtet der Trigger alles im Bucket. Wenn der Pfad nicht existiert, wird der Publisher nicht gestartet.

    Hinweis  Weitere Informationen zum Suchen von Ordnern in der Amazon S3 Console finden Sie unter Support for Folders im Console User Guide.
  • Unterverzeichnisse überwachen: Um Aktivitäten im ausgewählten Verzeichnis und allen Unterverzeichnissen zu überwachen, geben Sie "Ja" an. Um Aktivitäten nur im ausgewählten Verzeichnis und nicht in dessen Unterverzeichnissen anzuzeigen, geben Sie "Nein" an.
  • Abfrageintervall: Geben Sie an, wie oft vom S3-Bucket abgefragt wird.
    • Hinweis  Amazon S3 ist ein Pay-per-Use-Dienst. Bei jeder Abfrage handelt es sich um einen kostenpflichtigen Abruf dieses Dienstes.
  • Filter: Standardmäßig werden alle Aktionen im angegebenen Verzeichnis überwacht, einschließlich Hinzufügen (CREATE), Ändern (MODIFY) und Löschen (DELETE) von Dateien (und ggf. von Ordnern). Um nur eine oder zwei dieser Aktionen zu überwachen, klicken Sie auf das "x" neben der Aktion, die Sie nicht überwachen möchten, um sie zu entfernen. Um nach dem Entfernen eine Aktion hinzuzufügen, klicken Sie in die Dropbox und wählen Sie diese aus.
    • Hinweis  Ereignisse werden auf der Grundlage von Änderungen des Entitäts-Tags (ETag) ausgelöst, worüber eine Repräsentation des Dateiinhalts erfolgt. Es wird keine Meldung ausgelöst, wenn eine Änderung an einer bestehenden Datei den ETag nicht aktualisiert. Wenn eine Datei überschrieben wird und sich der ETag-Wert ändert, wird ein MODIFY-Ereignis ausgelöst.

Attribute der Ausgabe

Siehe auch

Attribut Beschreibung
time

Ereigniszeit
source Ereignistyp
error.type

(nur Failure-Port) Fehlertyp:

  • InvalidMessage: Beim Konfigurieren dieser Komponente ist ein Fehler aufgetreten, z. B. fehlende oder fehlerhafte Werte.
  • DeadLetter: Bei der Verbindung mit einer externen Ressource ist ein Fehler aufgetreten. Beispiele können Verbindungsprobleme, ungültige Anmeldeinformationen oder allgemeine Ausnahmen für externe Ressourcen sein.
error.message (nur Failure-Port) Fehlermeldung
file.event (nur Success-Port) Datei-Aktion (Create/Modify/Delete)
file.path (nur Success-Port) Dateipfad
file.rootName

(nur Success-Port) Datei-Root-Name
s3.bucket (nur Success-Port) Bucket