View a markdown version of this page

Verwalten Transfer Family Ereignisse mit Amazon EventBridge - AWS Transfer Family

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwalten Transfer Family Ereignisse mit Amazon EventBridge

Amazon EventBridge ist ein serverloser Dienst, der Ereignisse verwendet, um Anwendungskomponenten miteinander zu verbinden. Dies kann Ihnen das Erstellen skalierbarer ereignisgesteuerter Anwendungen erleichtern. Event-driven Architektur ist ein Stil, bei dem lose gekoppelte Softwaresysteme erstellt werden, die zusammenarbeiten, indem sie Ereignisse aussenden und darauf reagieren. Ereignisse stellen eine Veränderung in einer Ressource oder Umgebung dar.

Transfer Family Generiert wie bei vielen AWS Diensten Ereignisse und sendet sie an den EventBridge Standard-Event-Bus. Beachten Sie, dass der Standard-Event-Bus automatisch in jedem AWS Konto bereitgestellt wird. Ein Event Bus ist ein Router, der Ereignisse empfängt und sie an null oder mehr Ziele weiterleitet. Sie geben Regeln für den Event-Bus an, der Ereignisse auswertet, sobald sie eintreffen. Jede Regel prüft, ob ein Ereignis dem Ereignismuster der Regelentspricht. Wenn das Ereignis zutrifft, sendet der Event-Bus das Ereignis an ein oder mehrere angegebene Ziele.

AWS Dienste senden Ereignisse an den EventBridge Standard-Event-Bus. Wenn das Ereignis dem Ereignismuster einer Regel entspricht, wird das Ereignis an die für diese Regel angegebenen Ziele EventBridge gesendet.

Transfer Family Veranstaltungen

Transfer Family sendet Ereignisse automatisch an den EventBridge Standard-Event-Bus. Sie können Regeln auf dem Event-Bus erstellen, wobei jede Regel ein Ereignismuster und ein oder mehrere Ziele enthält.

Ereignisse, die dem Ereignismuster einer Regel entsprechen, werden entweder nach bestem Bemühen oder dauerhaft an die angegebenen Ziele gesendet (beachten Sie, dass einige Ereignisse möglicherweise nicht in der richtigen Reihenfolge zugestellt werden). Diese Lieferstufen werden in der Amazon Events Reference unter Versandstufe für AWS EventBridge Serviceereignisse beschrieben.

  • Server-level Ereignisse für SFTP-, FTPS- und FTP-Server werden nach bestem Wissen und Gewissen bereitgestellt.

  • Die SFTP-Connector-Ereignisse werden dauerhaft bereitgestellt.

  • Die AS2-Ereignisse werden dauerhaft bereitgestellt.

Die folgenden Ereignisse werden von Transfer Family generiert. Weitere Informationen finden Sie unter EventBridge Ereignisse im Amazon EventBridge Benutzerhandbuch.

SFTP-, FTPS- und FTP-Serverereignisse

In den folgenden Tabellen sind die Ereignisse für SFTP-, FTPS- und FTP-Server nach Ereignistyp geordnet aufgeführt.

Ereignisse zum Hoch- und Herunterladen von Dateien

Ereignisdetailtyp Description

Das Herunterladen der FTP-Serverdatei ist abgeschlossen

Eine Datei für das FTP-Protokoll wurde erfolgreich heruntergeladen.

Das Herunterladen der FTP-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei für das FTP-Protokoll herunterzuladen, ist fehlgeschlagen.

Das Hochladen der FTP-Serverdatei ist abgeschlossen

Eine Datei wurde erfolgreich für das FTP-Protokoll hochgeladen.

Das Hochladen der FTP-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei hochzuladen, ist für das FTP-Protokoll fehlgeschlagen.

Das Herunterladen der FTPS-Serverdatei ist abgeschlossen

Eine Datei für das FTPS-Protokoll wurde erfolgreich heruntergeladen.

Das Herunterladen der FTPS-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei für das FTPS-Protokoll herunterzuladen, ist fehlgeschlagen.

Das Hochladen der FTPS-Serverdatei ist abgeschlossen

Eine Datei wurde erfolgreich für das FTPS-Protokoll hochgeladen.

Das Hochladen der FTPS-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei hochzuladen, ist für das FTPS-Protokoll fehlgeschlagen.

Das Herunterladen der SFTP-Serverdatei ist abgeschlossen

Eine Datei für das SFTP-Protokoll wurde erfolgreich heruntergeladen.

Das Herunterladen der SFTP-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei für das SFTP-Protokoll herunterzuladen, ist fehlgeschlagen.

Das Hochladen der Datei auf dem SFTP-Server ist abgeschlossen

Eine Datei wurde erfolgreich für das SFTP-Protokoll hochgeladen.

Das Hochladen der Datei auf dem SFTP-Server ist fehlgeschlagen

Ein Versuch, eine Datei hochzuladen, ist für das SFTP-Protokoll fehlgeschlagen.

Andere Ereignisse im Zusammenhang mit Dateioperationen

Ereignisdetailtyp Description

Das Erstellen des FTP-Serververzeichnisses ist abgeschlossen

Ein Verzeichnis wurde erfolgreich für das FTP-Protokoll erstellt.

Das Erstellen des FTP-Serververzeichnisses ist fehlgeschlagen

Der Versuch, ein Verzeichnis für das FTP-Protokoll zu erstellen, ist fehlgeschlagen.

Das Löschen des FTP-Serververzeichnisses ist abgeschlossen

Ein Verzeichnis für das FTP-Protokoll wurde erfolgreich gelöscht.

Das Löschen des FTP-Serververzeichnisses ist fehlgeschlagen

Ein Versuch, ein Verzeichnis für das FTP-Protokoll zu löschen, ist fehlgeschlagen.

Das Löschen der FTP-Serverdatei ist abgeschlossen

Eine Datei für das FTP-Protokoll wurde erfolgreich gelöscht.

Das Löschen der FTP-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei für das FTP-Protokoll zu löschen, ist fehlgeschlagen.

Umbenennung der FTP-Serverdatei abgeschlossen

Eine Datei wurde erfolgreich für das FTP-Protokoll umbenannt.

Das Umbenennen der FTP-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei für das FTP-Protokoll umzubenennen, ist fehlgeschlagen.

Die Erstellung des FTPS-Serververzeichnisses ist abgeschlossen

Ein Verzeichnis wurde erfolgreich für das FTPS-Protokoll erstellt.

Das Erstellen des FTPS-Serververzeichnisses ist fehlgeschlagen

Ein Versuch, ein Verzeichnis für das FTPS-Protokoll zu erstellen, ist fehlgeschlagen.

Das Löschen des FTPS-Serververzeichnisses ist abgeschlossen

Ein Verzeichnis für das FTPS-Protokoll wurde erfolgreich gelöscht.

Das Löschen des FTPS-Serververzeichnisses ist fehlgeschlagen

Ein Versuch, ein Verzeichnis für das FTPS-Protokoll zu löschen, ist fehlgeschlagen.

Das Löschen der FTPS-Serverdatei ist abgeschlossen

Eine Datei für das FTPS-Protokoll wurde erfolgreich gelöscht.

Das Löschen der FTPS-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei für das FTPS-Protokoll zu löschen, ist fehlgeschlagen.

Die Umbenennung der FTPS-Serverdatei ist abgeschlossen

Eine Datei wurde erfolgreich für das FTPS-Protokoll umbenannt.

Das Umbenennen der FTPS-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei umzubenennen, ist für das FTPS-Protokoll fehlgeschlagen.

Das Erstellen des SFTP-Serververzeichnisses ist abgeschlossen

Ein Verzeichnis wurde erfolgreich für das SFTP-Protokoll erstellt.

Das Erstellen des SFTP-Serververzeichnisses ist fehlgeschlagen

Ein Versuch, ein Verzeichnis für das SFTP-Protokoll zu erstellen, ist fehlgeschlagen.

Das Löschen des SFTP-Serververzeichnisses ist abgeschlossen

Ein Verzeichnis für das SFTP-Protokoll wurde erfolgreich gelöscht.

Das Löschen des SFTP-Serververzeichnisses ist fehlgeschlagen

Ein Versuch, ein Verzeichnis für das SFTP-Protokoll zu löschen, ist fehlgeschlagen.

Das Löschen der SFTP-Serverdatei ist abgeschlossen

Eine Datei für das SFTP-Protokoll wurde erfolgreich gelöscht.

Das Löschen der SFTP-Serverdatei ist fehlgeschlagen

Ein Versuch, eine Datei für das SFTP-Protokoll zu löschen, ist fehlgeschlagen.

Das Umbenennen der Datei auf dem SFTP-Server ist abgeschlossen

Eine Datei wurde erfolgreich für das SFTP-Protokoll umbenannt.

Das Umbenennen der Datei auf dem SFTP-Server ist fehlgeschlagen

Ein Versuch, eine Datei umzubenennen, ist für das SFTP-Protokoll fehlgeschlagen.

Ereignisse des SFTP-Connectors

Anmerkung

Diese Ereignisse werden EventBridge auf einer dauerhaften Ebene übermittelt, wie unter Bereitstellungsebene für AWS Serviceereignisse in der Amazon EventBridge Events Reference beschrieben.

Ereignisdetailtyp Description

Das Senden der SFTP-Connector-Datei ist abgeschlossen

Eine Dateiübertragung von einem Connector zu einem Remote-SFTP-Server wurde erfolgreich abgeschlossen.

Das Senden der SFTP-Connector-Datei ist fehlgeschlagen

Eine Dateiübertragung von einem Connector zu einem Remote-SFTP-Server ist fehlgeschlagen.

Das Abrufen der SFTP-Connector-Datei ist abgeschlossen

Eine Dateiübertragung von einem Remote-SFTP-Server zu einem Connector wurde erfolgreich abgeschlossen.

Fehler beim Abrufen der SFTP-Connector-Datei

Eine Dateiübertragung von einem Remote-SFTP-Server zu einem Connector ist fehlgeschlagen.

Die Verzeichnisliste für den SFTP-Connector ist abgeschlossen

Ein Aufruf zum Auflisten des Startdateiverzeichnisses, der erfolgreich abgeschlossen wurde.

Die Verzeichnisliste für den SFTP-Connector ist fehlgeschlagen

Eine Verzeichnisauflistung der Startdatei ist fehlgeschlagen.

Fernübertragung des SFTP-Connectors abgeschlossen

Dateien oder Verzeichnisse wurden erfolgreich auf dem Remoteserver verschoben oder umbenannt.

Die Fernübertragung des SFTP-Connectors ist fehlgeschlagen

Dateien oder Verzeichnisse konnten auf dem Remoteserver nicht verschoben oder umbenannt werden.

Das Remote-Löschen des SFTP-Connectors ist abgeschlossen

Dateien oder Verzeichnisse wurden erfolgreich auf dem Remoteserver gelöscht.

Das Remote-Löschen des SFTP-Connectors ist fehlgeschlagen

Dateien oder Verzeichnisse konnten auf dem Remoteserver nicht gelöscht werden.

AS2-Ereignisse

Anmerkung

Diese Ereignisse werden EventBridge auf einer dauerhaften Ebene übermittelt, wie unter Bereitstellungsebene für AWS Serviceereignisse in der Amazon EventBridge Events Reference beschrieben.

Ereignisdetailtyp Description

AS2-Payload-Empfang abgeschlossen

Die Nutzlast für eine AS2-Nachricht wurde empfangen.

Der Empfang der AS2-Nutzlast ist fehlgeschlagen

Die Nutzlast für eine AS2-Nachricht wurde nicht empfangen.

Das Senden der AS2-Nutzlast ist abgeschlossen

Die Payload für eine AS2-Nachricht wurde erfolgreich gesendet.

Das Senden der AS2-Nutzlast ist fehlgeschlagen

Die Payload für eine AS2-Nachricht konnte nicht gesendet werden.

AS2-MDN-Empfang abgeschlossen

Die Benachrichtigung über die Nachrichtenlöschung für eine AS2-Nachricht wurde empfangen.

AS2-MDN-Empfang fehlgeschlagen

Die Benachrichtigung über die Nachrichtenlöschung für eine AS2-Nachricht wurde nicht empfangen.

AS2-MDN-Versand abgeschlossen

Die Benachrichtigung über die Nachrichtenlöschung für eine AS2-Nachricht wurde erfolgreich gesendet.

AS2 MDN konnte nicht gesendet werden

Die Benachrichtigung über die Nachrichtenlöschung für eine AS2-Nachricht konnte nicht gesendet werden.

Wird gesendet Transfer Family Ereignisse mithilfe von EventBridge Regeln

Wenn der EventBridge Standardereignisbus Transfer Family Ereignisse an ein Ziel senden soll, müssen Sie eine Regel erstellen, die ein Ereignismuster enthält, das den Daten in den gewünschten Transfer Family Ereignissen entspricht.

Um zu erfassen AWS Transfer Family Ereignisse bei Amazon EventBridge
  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie im Navigationsbereich Regeln und dann Regel erstellen aus.

  3. Geben Sie einen beschreibenden Namen für die Regel ein, und geben Sie optional eine Beschreibung ein.

  4. Wählen Sie als Regeltyp die Option Regel mit einem Ereignismuster aus und klicken Sie dann auf Weiter.

  5. Wählen Sie im Abschnitt Ereignisquelle AWS Ereignisse oder EventBridge Partnerereignisse aus.

  6. Wählen Sie im Abschnitt Erstellungsmethode die Option Musterformular verwenden aus.

  7. Geben Sie im Abschnitt Event-Muster die folgenden Informationen ein.

    1. Als Event source (Ereignisquelle) wählen Sie AWS -Services aus.

    2. Wählen Sie für AWS Service die Option Transfer aus.

    3. Wählen Sie als Ereignistyp den Ereignistyp „Familie übertragen“ aus, der Ihre Regel auslösen soll.

      Je nachdem, welchen Ereignistyp Sie ausgewählt haben, wird Ihnen möglicherweise der Abschnitt „Spezifizierung 1 für den Ereignistyp“ angezeigt.

    4. Wenn Sie den Abschnitt Ereignistypspezifikation 1 sehen, wählen Sie die spezifischen Ereignisse aus, die Sie erfassen möchten (oder wählen Sie Beliebiges Ereignis aus, um alle Ereignisse für den ausgewählten Ereignistyp zu erfassen).

    5. (Optional) Verwenden Sie den Event-Muster-Editor, um Filter für Eventdetails anzugeben.

    6. Wählen Sie Weiter aus.

  8. Wählen Sie ein Ziel aus den unter Ziele auswählen verfügbaren Optionen aus. Wählen Sie aus den folgenden verfügbaren Zielen aus.

    • AWS Service. Beliebte Optionen sind Lambda-Funktionen für serverloses Rechnen, Amazon SQS-Warteschlangen für die Nachrichtenverarbeitung, Amazon SNS-Themen für Benachrichtigungen und für die Orchestrierung von Workflows. AWS Step Functions

    • EventBridge API-Ziel. Wenn Sie Ereignisse an einen HTTP-Endpunkt außerhalb von senden möchten AWS, können Sie ein API-Ziel als Ziel verwenden.

    • EventBridge Event-Bus. Sie können Ereignisse an einen anderen Event-Bus senden, entweder in demselben Konto und derselben Region oder in einem anderen Konto oder einer anderen Region.

      Eine umfassende Anleitung zum Erstellen von Event-Bus-Regeln finden Sie im EventBridge Amazon-Benutzerhandbuch unter Regeln erstellen, die auf Ereignisse reagieren.

    Hilfe bei der Auswahl eines Ziels finden Sie unter Ziele auswählen im EventBridge Amazon-Benutzerhandbuch.

  9. Konfigurieren Sie alle zusätzlichen Optionen für Ihr Ziel und wählen Sie dann Weiter.

  10. (Optional) Fügen Sie Ihrer Regel Tags hinzu und wählen Sie Weiter.

  11. Wenn alles gut aussieht, wähle im Bildschirm „Überprüfen und erstellen“ die Option Regel erstellen aus.

Erstellen von Ereignismustern für Transfer Family Veranstaltungen

Wenn ein Ereignis an den Standardereignisbus Transfer Family übermittelt EventBridge wird, verwendet das für jede Regel definierte Ereignismuster, um zu bestimmen, ob das Ereignis an die Ziele der Regel übermittelt werden soll. Ein Ereignismuster entspricht den Daten in den gewünschten Transfer Family Ereignissen. Jedes Ereignismuster ist ein JSON-Objekt, das Folgendes enthält:

  • Ein source-Attribut, das den Service identifiziert, der das Ereignis sendet. Für Transfer Family Ereignisse ist die Quelleaws.transfer.

  • (Optional) Ein detail-type Attribut, das ein Array der abzugleichenden Ereignistypen enthält.

  • (Optional) Ein detail Attribut, das alle anderen Ereignisdaten enthält, für die ein Abgleich erforderlich ist.

Das folgende Ereignismuster entspricht beispielsweise allen Ereignissen von Transfer Family:

{ "source": ["aws.transfer"] }

Das folgende Beispiel für ein Ereignismuster entspricht allen SFTP-Connector-Ereignissen:

{ "source": ["aws.transfer"], "detail-type": ["SFTP Connector File Send Completed", "SFTP Connector File Retrieve Completed", "SFTP Connector File Retrieve Failed", "SFTP Connector File Send Failed"] }

Das folgende Beispiel für ein Ereignismuster entspricht allen Ereignissen, bei denen die Übertragung der Familie fehlgeschlagen ist:

{ "source": ["aws.transfer"], "detail-type": [{"wildcard", "*Failed"}] }

Das folgende Beispiel für ein Ereignismuster entspricht erfolgreichen SFTP-Downloads für Benutzerusername:

{ "source": ["aws.transfer"], "detail-type": ["SFTP Server File Download Completed"], "detail": { "username": [username] } }

Weitere Informationen zum Schreiben von Ereignismustern finden Sie unter Ereignismuster im EventBridge Benutzerhandbuch.

Testen von Ereignismustern für Transfer Family Ereignisse in EventBridge

Sie können die EventBridge Sandbox verwenden, um ein Ereignismuster schnell zu definieren und zu testen, ohne den umfassenderen Prozess der Erstellung oder Bearbeitung einer Regel abschließen zu müssen. Mithilfe der Sandbox können Sie ein Ereignismuster definieren und anhand eines Beispielereignisses überprüfen, ob das Muster den gewünschten Ereignissen entspricht. EventBridge bietet Ihnen die Möglichkeit, eine neue Regel zu erstellen, indem Sie dieses Ereignismuster direkt aus der Sandbox verwenden.

Weitere Informationen finden Sie im EventBridge Benutzerhandbuch unter Testen eines Ereignismusters mithilfe der EventBridge Sandbox.

Amazon EventBridge Berechtigungen

Transfer Family benötigt keine zusätzlichen Berechtigungen, um Ereignisse zu Amazon EventBridgeübermitteln.

Für die von Ihnen angegebenen Ziele sind möglicherweise bestimmte Berechtigungen oder Konfigurationen erforderlich. Weitere Informationen zur Verwendung bestimmter Dienste für Ziele finden Sie unter Amazon EventBridge Ziele im Amazon EventBridge Benutzerhandbuch.

Zusätzliche EventBridge Ressourcen

Weitere Informationen zur Verarbeitung und Verwaltung von Ereignissen finden Sie EventBridge in den folgenden Abschnitten des Amazon EventBridge Benutzerhandbuchs .

  • Ausführliche Informationen zur Funktionsweise von Event-Bussen finden Sie unter Amazon EventBridge Event-Bus.

  • Informationen zur Veranstaltungsstruktur finden Sie unter Ereignisse.

  • Informationen zum Konstruieren von Ereignismustern EventBridge , die beim Abgleich von Ereignissen mit Regeln verwendet werden können, finden Sie unter Ereignismuster.

  • Informationen zum Erstellen von Regeln zur Angabe, welche Ereignisse EventBridge verarbeitet werden, finden Sie unter Regeln.

  • Informationen darüber, wie Sie angeben, an welche Dienste oder anderen Ziele übereinstimmende Ereignisse EventBridge gesendet werden, finden Sie unter Ziele.