Transfer Family Ereignisse verwalten mit Amazon EventBridge

Amazon EventBridge ist ein serverloser Dienst, der Ereignisse verwendet, um Anwendungskomponenten miteinander zu verbinden. Dies kann Ihnen die Erstellung skalierbarer ereignisgesteuerter Anwendungen erleichtern. Bei der ereignisgesteuerten Architektur werden lose gekoppelte Softwaresysteme erstellt, die zusammenarbeiten, indem sie Ereignisse auslösen 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 mit dem Ereignismuster der Regel übereinstimmt. Wenn das Ereignis übereinstimmt, sendet der Event-Bus das Ereignis an ein oder mehrere angegebene Ziele.

Themen

• Transfer Family Ereignisse
• Senden von Transfer Family Ereignissen mithilfe von Regeln EventBridge
• Amazon EventBridge Berechtigungen
• Zusätzliche EventBridge Ressourcen
• Transfer Family Referenz mit Einzelheiten zu Ereignissen

Transfer Family Ereignisse

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 nach bestem Wissen und Gewissen an die angegebenen Ziele übermittelt. Es kann jedoch sein, dass einige Ereignisse nicht in der richtigen Reihenfolge zugestellt werden.

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

SFTP-, FTPS- und FTP-Serverereignisse

Art der Einzelheiten des Ereignisses	Beschreibung
Der Download des FTP-Dateiservers ist abgeschlossen	Eine Datei wurde erfolgreich für das FTP-Protokoll heruntergeladen.
Der Download des FTP-Dateiservers ist fehlgeschlagen	Ein Versuch, eine Datei für das FTP-Protokoll herunterzuladen, ist fehlgeschlagen.
Der Upload des FTP-Dateiservers ist abgeschlossen	Eine Datei wurde erfolgreich für das FTP-Protokoll hochgeladen.
Der Upload des FTP-Dateiservers ist fehlgeschlagen	Ein Versuch, eine Datei hochzuladen, ist für das FTP-Protokoll fehlgeschlagen.
Der Download des FTPS-Dateiservers ist abgeschlossen	Eine Datei wurde erfolgreich für das FTPS-Protokoll heruntergeladen.
Der Download des FTPS-Dateiservers ist fehlgeschlagen	Ein Versuch, eine Datei für das FTPS-Protokoll herunterzuladen, ist fehlgeschlagen.
Der Upload des FTPS-Dateiservers ist abgeschlossen	Eine Datei wurde erfolgreich für das FTPS-Protokoll hochgeladen.
Der Upload des FTPS-Dateiservers ist fehlgeschlagen	Ein Versuch, eine Datei hochzuladen, ist für das FTPS-Protokoll fehlgeschlagen.
Der Download der SFTP-Serverdatei ist abgeschlossen	Eine Datei wurde erfolgreich für das SFTP-Protokoll heruntergeladen.
Das Herunterladen der SFTP-Serverdatei ist fehlgeschlagen	Ein Versuch, eine Datei für das SFTP-Protokoll herunterzuladen, ist fehlgeschlagen.
Das Hochladen der SFTP-Serverdatei ist abgeschlossen	Eine Datei wurde erfolgreich für das SFTP-Protokoll hochgeladen.
Das Hochladen der SFTP-Serverdatei ist fehlgeschlagen	Ein Versuch, eine Datei hochzuladen, ist für das SFTP-Protokoll fehlgeschlagen.

Ereignisse des SFTP-Connectors

Art der Einzelheiten des Ereignisses	Beschreibung
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.
Der Abruf 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 des SFTP-Connectors ist abgeschlossen	Ein Aufruf zum Auflisten des Startdateiverzeichnisses, der erfolgreich abgeschlossen wurde.
Die Verzeichnisliste des SFTP-Connectors ist fehlgeschlagen	Eine Verzeichnisliste für die Startdatei, die fehlgeschlagen ist.

A2S-Ereignisse

Art der Einzelheiten des Ereignisses	Beschreibung
Empfang der AS2-Nutzlast abgeschlossen	Die Payload für eine AS2-Nachricht wurde empfangen.
Der Empfang der AS2-Nutzdaten ist fehlgeschlagen	Die Payload für eine AS2-Nachricht wurde nicht empfangen.
Der Versand 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 Entsorgung von Nachrichten für eine AS2-Nachricht wurde empfangen.
AS2 MDN-Empfang ist fehlgeschlagen	Die Benachrichtigung über die Nachrichtenablage für eine AS2-Nachricht wurde nicht empfangen.
AS2 MDN Send abgeschlossen	Die Benachrichtigung über die Entsorgung von Nachrichten für eine AS2-Nachricht wurde erfolgreich gesendet.
AS2 MDN konnte nicht gesendet werden	Die Benachrichtigung über die Nachrichtenablage für eine AS2-Nachricht konnte nicht gesendet werden.

Senden von Transfer Family Ereignissen mithilfe von Regeln EventBridge

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

Sie können eine Regel erstellen, indem Sie die folgenden allgemeinen Schritte ausführen:

1. Erstellen Sie ein Ereignismuster für die Regel, das Folgendes festlegt:

   • Transfer Family ist die Quelle der Ereignisse, die von der Regel ausgewertet werden.

   • (Optional) Alle anderen Ereignisdaten, mit denen sie abgeglichen werden soll.

   Weitere Informationen finden Sie unter Ereignismuster für Transfer Family Ereignisse erstellen.

2. (Optional) Erstellen Sie einen Eingangstransformator, der die Daten aus dem Ereignis anpasst, bevor die Informationen an das Ziel der Regel EventBridge gesendet werden.

   Weitere Informationen finden Sie unter Eingabetransformation im EventBridge Benutzerhandbuch.

3. Geben Sie die Ziele an, an die Sie Ereignisse senden EventBridge möchten, die dem Ereignismuster entsprechen.

   Ziele können andere AWS Dienste, SaaS-Anwendungen (Software as a Service), API-Ziele oder andere benutzerdefinierte Endpunkte sein. Weitere Informationen finden Sie unter Ziele im Benutzerhandbuch für EventBridge .

Umfassende Anweisungen zum Erstellen von Event-Bus-Regeln finden Sie im EventBridge Benutzerhandbuch unter Erstellen von Regeln, die auf Ereignisse reagieren.

Ereignismuster für Transfer Family Ereignisse erstellen

Wenn ein Ereignis an den Standardereignisbus Transfer Family übermittelt, EventBridge verwendet das für jede Regel definierte Ereignismuster, um zu bestimmen, ob das Ereignis an die Ziele der Regel gesendet 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 zuzuordnenden 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 Ereignissen des SFTP-Connectors:

{
  "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 fehlgeschlagenen Transfer Family Family-Ereignissen:

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

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

{
  "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 schnell ein Ereignismuster 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 unter Testen eines Ereignismusters mithilfe der EventBridge Sandbox im EventBridge Benutzerhandbuch.

Amazon EventBridge Berechtigungen

Transfer Family benötigt keine zusätzlichen Berechtigungen für die Übermittlung von Ereignissen an Amazon EventBridge.

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

Zusätzliche EventBridge Ressourcen

Weitere Informationen zur Verarbeitung und Verwaltung von Ereignissen finden Sie EventBridge in den folgenden Themen im Amazon EventBridge Benutzerhandbuch.

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

• Informationen zur Veranstaltungsstruktur finden Sie unter Ereignisse.

• Informationen zur Erstellung von Ereignismustern für EventBridge den Abgleich von Ereignissen mit Regeln finden Sie unter Ereignismuster.

• Informationen zum Erstellen von Regeln, mit denen angegeben wird, welche Ereignisse EventBridge verarbeitet werden, finden Sie unter Regeln.

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