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.

# Transfer Family Ereignisse verwalten mit Amazon EventBridge
<a name="eventbridge"></a>

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 dem Ereignismuster *der Regel*entspricht. Wenn das Ereignis übereinstimmt, 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 mit dem Ereignismuster einer Regel übereinstimmt, wird das Ereignis an die für diese Regel angegebenen Ziele EventBridge gesendet.\]](http://docs.aws.amazon.com/de_de/transfer/latest/userguide/images/eventbridge-integration-how-it-works.png)


**Topics**
+ [

## Transfer Family Ereignisse
](#supported-events)
+ [

## Senden von Transfer Family Ereignissen mithilfe von EventBridge Regeln
](#eventbridge-using-events-rules)
+ [

## Amazon EventBridge Berechtigungen
](#eventbridge-permissions)
+ [

## Zusätzliche EventBridge Ressourcen
](#eventbridge-additonal-resources)
+ [

# Transfer Family Referenz mit Einzelheiten zu Ereignissen
](events-detail-reference.md)

## Transfer Family Ereignisse
<a name="supported-events"></a>

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* Wissen und Gewissen an die angegebenen Ziele übermittelt *(*beachten Sie, dass einige Ereignisse möglicherweise nicht in der richtigen Reihenfolge übertragen werden). Diese Versandarten werden in der *Amazon Events-Referenz unter [Lieferstufe für AWS EventBridge Serviceereignisse](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)* beschrieben.
+ Ereignisse auf Serverebene für SFTP-, FTPS- und FTP-Server werden nach bestem Wissen und Gewissen übermittelt.
+ Die SFTP-Connector-Ereignisse werden dauerhaft übertragen.
+ Die AS2 Ereignisse werden dauerhaft übertragen.

Die folgenden Ereignisse werden von generiert Transfer Family. Weitere Informationen finden Sie im *Amazon EventBridge Benutzerhandbuch* unter [EventBridge Ereignisse](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html).

### SFTP-, FTPS- und FTP-Serverereignisse
<a name="supported-events-servers"></a>

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

**Ereignisse beim Hoch- und Herunterladen von Dateien**


| Ereignisdetailtyp | Description | 
| --- | --- | 
|  [Das Herunterladen der FTP-Server-Datei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das FTP-Protokoll heruntergeladen.  | 
|  [Das Herunterladen der FTP-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei für das FTP-Protokoll herunterzuladen, ist fehlgeschlagen.  | 
|  [Das Hochladen der Datei auf den FTP-Server ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das FTP-Protokoll hochgeladen.  | 
|  [Das Hochladen der FTP-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei hochzuladen, ist für das FTP-Protokoll fehlgeschlagen.  | 
|  [Das Herunterladen der FTPS-Serverdatei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das FTPS-Protokoll heruntergeladen.  | 
|  [Das Herunterladen der FTPS-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei für das FTPS-Protokoll herunterzuladen, ist fehlgeschlagen.  | 
|  [Das Hochladen der Datei auf den FTPS-Server ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das FTPS-Protokoll hochgeladen.  | 
|  [Das Hochladen der FTPS-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei hochzuladen, ist für das FTPS-Protokoll fehlgeschlagen.  | 
|  [Der Download der SFTP-Serverdatei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das SFTP-Protokoll heruntergeladen.  | 
|  [Das Herunterladen der SFTP-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei für das SFTP-Protokoll herunterzuladen, ist fehlgeschlagen.  | 
|  [Das Hochladen der SFTP-Serverdatei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das SFTP-Protokoll hochgeladen.  | 
|  [Das Hochladen der SFTP-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei hochzuladen, ist für das SFTP-Protokoll fehlgeschlagen.  | 

**Andere Ereignisse im Zusammenhang mit Dateivorgängen**


| Ereignisdetailtyp | Description | 
| --- | --- | 
|  [Die Erstellung des FTP-Serververzeichnisses ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Ein Verzeichnis wurde erfolgreich für das FTP-Protokoll erstellt.  | 
|  [Fehler beim Erstellen des FTP-Serververzeichnisses](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, ein Verzeichnis für das FTP-Protokoll zu erstellen, ist fehlgeschlagen.  | 
|  [Das Löschen des FTP-Serververzeichnisses ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Ein Verzeichnis für das FTP-Protokoll wurde erfolgreich gelöscht.  | 
|  [Das Löschen des FTP-Serververzeichnisses ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, ein Verzeichnis für das FTP-Protokoll zu löschen, ist fehlgeschlagen.  | 
|  [Das Löschen der FTP-Serverdatei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das FTP-Protokoll gelöscht.  | 
|  [Das Löschen der FTP-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei für das FTP-Protokoll zu löschen, ist fehlgeschlagen.  | 
|  [Das Umbenennen der FTP-Serverdatei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das FTP-Protokoll umbenannt.  | 
|  [Fehler beim Umbenennen der FTP-Serverdatei](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei umzubenennen, ist für das FTP-Protokoll fehlgeschlagen.  | 
|  [Die Erstellung des FTPS-Serververzeichnisses ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Ein Verzeichnis wurde erfolgreich für das FTPS-Protokoll erstellt.  | 
|  [Fehler beim Erstellen des FTPS-Serververzeichnisses](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, ein Verzeichnis für das FTPS-Protokoll zu erstellen, ist fehlgeschlagen.  | 
|  [Das Löschen des FTPS-Serververzeichnisses ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Ein Verzeichnis wurde erfolgreich für das FTPS-Protokoll gelöscht.  | 
|  [Das Löschen des FTPS-Serververzeichnisses ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, ein Verzeichnis für das FTPS-Protokoll zu löschen, ist fehlgeschlagen.  | 
|  [Das Löschen der FTPS-Serverdatei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das FTPS-Protokoll gelöscht.  | 
|  [Das Löschen der FTPS-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei für das FTPS-Protokoll zu löschen, ist fehlgeschlagen.  | 
|  [Die Umbenennung der FTPS-Serverdatei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das FTPS-Protokoll umbenannt.  | 
|  [Fehler beim Umbenennen der FTPS-Serverdatei](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei umzubenennen, ist für das FTPS-Protokoll fehlgeschlagen.  | 
|  [Die Erstellung des SFTP-Serververzeichnisses ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Ein Verzeichnis wurde erfolgreich für das SFTP-Protokoll erstellt.  | 
|  [Das Erstellen des SFTP-Serververzeichnisses ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, ein Verzeichnis für das SFTP-Protokoll zu erstellen, ist fehlgeschlagen.  | 
|  [Das Löschen des SFTP-Serververzeichnisses ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Ein Verzeichnis für das SFTP-Protokoll wurde erfolgreich gelöscht.  | 
|  [Das Löschen des SFTP-Serververzeichnisses ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, ein Verzeichnis für das SFTP-Protokoll zu löschen, ist fehlgeschlagen.  | 
|  [Das Löschen der SFTP-Serverdatei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei für das SFTP-Protokoll wurde erfolgreich gelöscht.  | 
|  [Das Löschen der SFTP-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei für das SFTP-Protokoll zu löschen, ist fehlgeschlagen.  | 
|  [Die Umbenennung der SFTP-Serverdatei ist abgeschlossen](events-detail-reference.md#event-detail-server-events)  |  Eine Datei wurde erfolgreich für das SFTP-Protokoll umbenannt.  | 
|  [Das Umbenennen der SFTP-Serverdatei ist fehlgeschlagen](events-detail-reference.md#event-detail-server-events)  |  Ein Versuch, eine Datei umzubenennen, ist für das SFTP-Protokoll fehlgeschlagen.  | 

### Ereignisse des SFTP-Connectors
<a name="supported-events-connectors"></a>

**Anmerkung**  
Diese Ereignisse werden EventBridge auf einem dauerhaften Niveau zugestellt, wie unter [Lieferstufe für AWS Serviceereignisse](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) in der *Amazon EventBridge Events-Referenz* beschrieben.


| Ereignisdetailtyp | Description | 
| --- | --- | 
|  [Der Versand der SFTP-Connector-Datei ist abgeschlossen](events-detail-reference.md#event-detail-sftp-connector-events)  | Eine Dateiübertragung von einem Connector zu einem Remote-SFTP-Server wurde erfolgreich abgeschlossen. | 
|  [Das Senden der SFTP-Connector-Datei ist fehlgeschlagen](events-detail-reference.md#event-detail-sftp-connector-events)  | Eine Dateiübertragung von einem Connector zu einem Remote-SFTP-Server ist fehlgeschlagen. | 
|  [Der Abruf der SFTP-Connector-Datei ist abgeschlossen](events-detail-reference.md#event-detail-sftp-connector-events)  | Eine Dateiübertragung von einem Remote-SFTP-Server zu einem Connector wurde erfolgreich abgeschlossen. | 
|  [Fehler beim Abrufen der SFTP-Connector-Datei](events-detail-reference.md#event-detail-sftp-connector-events)  | Eine Dateiübertragung von einem Remote-SFTP-Server zu einem Connector ist fehlgeschlagen. | 
|  [Die Verzeichnisliste des SFTP-Connectors ist abgeschlossen](events-detail-reference.md#event-detail-sftp-connector-events)  | Ein Aufruf zum Auflisten des Startdateiverzeichnisses, der erfolgreich abgeschlossen wurde. | 
|  [Die Verzeichnisliste des SFTP-Connectors ist fehlgeschlagen](events-detail-reference.md#event-detail-sftp-connector-events)  | Eine Verzeichnisliste für die Startdatei, die fehlgeschlagen ist. | 
|  [Die Remote-Verschiebung des SFTP-Connectors ist abgeschlossen](events-detail-reference.md#event-detail-sftp-connector-events)  | Dateien oder Verzeichnisse wurden erfolgreich auf dem Remoteserver verschoben oder umbenannt. | 
|  [Das Remote-Verschieben des SFTP-Connectors ist fehlgeschlagen](events-detail-reference.md#event-detail-sftp-connector-events)  | Dateien oder Verzeichnisse konnten auf dem Remoteserver nicht verschoben oder umbenannt werden. | 
|  [Fernlöschung des SFTP-Connectors abgeschlossen](events-detail-reference.md#event-detail-sftp-connector-events)  | Dateien oder Verzeichnisse wurden erfolgreich auf dem Remoteserver gelöscht. | 
|  [Das Remote-Löschen des SFTP-Connectors ist fehlgeschlagen](events-detail-reference.md#event-detail-sftp-connector-events)  | Dateien oder Verzeichnisse konnten auf dem Remoteserver nicht gelöscht werden. | 

### AS2 Ereignisse
<a name="supported-events-as2"></a>

**Anmerkung**  
Diese Ereignisse werden EventBridge auf einem dauerhaften Niveau zugestellt, wie unter [Lieferstufe für AWS Serviceereignisse](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) in der *Amazon EventBridge Events-Referenz* beschrieben.


| Ereignisdetailtyp | Description | 
| --- | --- | 
|  [AS2 Empfang der Payload abgeschlossen](events-detail-reference.md#event-detail-as2-server-events)  | Die Payload für eine AS2 Nachricht wurde empfangen. | 
|  [AS2 Payload konnte nicht empfangen werden](events-detail-reference.md#event-detail-as2-server-events)  | Die Payload für eine AS2 Nachricht wurde nicht empfangen. | 
|  [AS2 Payload wurde gesendet](events-detail-reference.md#event-detail-as2-server-events)  | Die Payload für eine AS2 Nachricht wurde erfolgreich gesendet. | 
|  [AS2 Payload konnte nicht gesendet werden](events-detail-reference.md#event-detail-as2-server-events)  | Die Payload für eine AS2 Nachricht konnte nicht gesendet werden. | 
|  [AS2 MDN-Empfang abgeschlossen](events-detail-reference.md#event-detail-as2-server-events)  | Die Benachrichtigung über den Nachrichtenzugriff für eine AS2 Nachricht wurde empfangen. | 
|  [AS2 MDN-Empfang fehlgeschlagen](events-detail-reference.md#event-detail-as2-server-events)  | Die Benachrichtigung über die Nachrichtenablage für eine AS2 Nachricht wurde nicht empfangen. | 
|  [AS2 MDN-Sendung abgeschlossen](events-detail-reference.md#event-detail-as2-server-events)  | Die Benachrichtigung über den Nachrichtenzugriff für eine AS2 Nachricht wurde erfolgreich gesendet. | 
|  [AS2 MDN-Sendung ist fehlgeschlagen](events-detail-reference.md#event-detail-as2-server-events)  | Die Benachrichtigung über die Nachrichtenablage für eine AS2 Nachricht konnte nicht gesendet werden. | 

## Senden von Transfer Family Ereignissen mithilfe von EventBridge Regeln
<a name="eventbridge-using-events-rules"></a>

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. 

**Um AWS Transfer Family Ereignisse in Amazon zu erfassen EventBridge**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Wählen Sie im Navigationsbereich **Regeln** und anschließend **Regel erstellen** aus.

1. Geben Sie einen aussagekräftigen Namen für die Regel und optional eine Beschreibung ein.

1. Wählen Sie als **Regeltyp** die Option **Regel mit einem Ereignismuster** und dann **Weiter** aus.

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

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

1. Geben Sie im Abschnitt **Ereignismuster** die folgenden Informationen ein.

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

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

   1. Wählen Sie als **Ereignistyp** den Ereignistyp „Transfer Family“ aus, der Ihre Regel auslösen soll.

      Je nachdem, welchen **Ereignistyp** Sie ausgewählt haben, wird Ihnen möglicherweise der Abschnitt **Ereignistyp-Spezifikation 1** angezeigt.

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

   1. (Optional) Verwenden Sie den **Event-Muster-Editor**, um Filter für Eventdetails festzulegen.

   1. Wählen Sie **Weiter** aus.

1. Wählen Sie ein Ziel aus den unter **Ziele auswählen** verfügbaren Optionen aus. Wählen Sie eines der folgenden verfügbaren Ziele aus.
   + **AWS Dienst**. Beliebte Optionen sind Lambda-Funktionen für serverloses Computing, Amazon SQS SQS-Warteschlangen für die Nachrichtenverarbeitung, Amazon SNS 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 Eventbus senden, entweder in demselben Konto und derselben Region oder in einem anderen Konto oder in einer anderen Region.

     Umfassende Anweisungen zur Erstellung von Event-Bus-Regeln finden Sie im * EventBridge Amazon-Benutzerhandbuch* unter [Regeln erstellen, die auf Ereignisse reagieren](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html). 

   Hilfe bei der Auswahl eines Ziels finden [Sie unter Ziele auswählen](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html#eb-create-rule-target) im * EventBridge Amazon-Benutzerhandbuch*.

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

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

1. Wenn alles gut aussieht, wählen Sie im Bildschirm **Überprüfen und erstellen** die Option **Regel erstellen** aus.

### Ereignismuster für Transfer Family Ereignisse erstellen
<a name="eventbridge-using-events-rules-patterns"></a>

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 Quelle`aws.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 Benutzer*username*:

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

Weitere Informationen zum Schreiben von Ereignismustern finden Sie unter [Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) im *EventBridge Benutzerhandbuch*.

### Testen von Ereignismustern für Transfer Family Ereignisse in EventBridge
<a name="eventbridge-using-events-testing"></a>

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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-pattern-sandbox.html) im *EventBridge Benutzerhandbuch*.

## Amazon EventBridge Berechtigungen
<a name="eventbridge-permissions"></a>

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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) finden Sie im *Amazon EventBridge Benutzerhandbuch* unter Ziele.

## Zusätzliche EventBridge Ressourcen
<a name="eventbridge-additonal-resources"></a>

Weitere Informationen zur Verarbeitung und Verwaltung von Ereignissen finden Sie EventBridge in den folgenden Themen im [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html).
+ Ausführliche Informationen zur Funktionsweise von Eventbussen finden Sie unter [Amazon EventBridge Event-Bus](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html).
+ Informationen zur Veranstaltungsstruktur finden Sie unter [Ereignisse](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html).
+ Informationen zur Erstellung von Ereignismustern für EventBridge den Abgleich von Ereignissen mit Regeln finden Sie unter [Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html).
+ Informationen zum Erstellen von Regeln, mit denen angegeben wird, welche Ereignisse EventBridge verarbeitet werden, finden Sie unter [Regeln](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
+ Informationen darüber, wie Sie angeben, an welche Dienste oder andere Ziele übereinstimmende Ereignisse EventBridge gesendet werden, finden Sie unter [Ziele](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html).

# Transfer Family Referenz mit Einzelheiten zu Ereignissen
<a name="events-detail-reference"></a>

Alle Ereignisse von AWS Diensten haben einen gemeinsamen Satz von Feldern, die Metadaten zu dem Ereignis enthalten. Zu diesen Metadaten können der AWS Dienst gehören, der die Quelle des Ereignisses ist, die Uhrzeit, zu der das Ereignis generiert wurde, das Konto und die Region, in der das Ereignis stattgefunden hat, und andere. Definitionen dieser allgemeinen Felder finden Sie unter [Referenz zur Ereignisstruktur](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) im *Amazon EventBridge Benutzerhandbuch*. 

Darüber hinaus weist jedes Ereignis ein `detail`-Feld auf, das spezifische Daten für das betreffende Ereignis enthält. In der folgenden Referenz werden die Detailfelder für die verschiedenen Transfer Family Ereignisse definiert.

Beachten Sie EventBridge bei der Auswahl und Verwaltung von Transfer Family Ereignissen Folgendes:
+ Das `source` Feld für alle Ereignisse von Transfer Family ist auf gesetzt`aws.transfer`.
+ Das Feld `detail-type` gibt den Ereignistyp an. 

  Beispiel, `FTP Server File Download Completed`.
+ Das Feld `detail` enthält die Daten, die für das betreffende Ereignis spezifisch sind. 

Informationen zur Erstellung von Ereignismustern, die es Regeln ermöglichen, Transfer Family Ereignissen zuzuordnen, finden Sie im *Amazon EventBridge Benutzerhandbuch* unter [Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html).

Weitere Informationen zu Ereignissen und deren EventBridge Verarbeitung finden Sie im *Amazon EventBridge Benutzerhandbuch* unter [Amazon EventBridge Ereignisse](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html).

**Topics**
+ [

## SFTP-, FTPS- und FTP-Serverereignisse
](#event-detail-server-events)
+ [

## Ereignisse des SFTP-Connectors
](#event-detail-sftp-connector-events)
+ [

## AS2 Ereignisse
](#event-detail-as2-server-events)

## SFTP-, FTPS- und FTP-Serverereignisse
<a name="event-detail-server-events"></a>

Im Folgenden finden Sie die Detailfelder für SFTP-, FTPS- und FTP-Serverereignisse:
+ Die Erstellung des FTP-Serververzeichnisses ist abgeschlossen
+ Das Erstellen des FTP-Serververzeichnisses ist fehlgeschlagen
+ Das Löschen des FTP-Serververzeichnisses ist abgeschlossen
+ Das Löschen des FTP-Serververzeichnisses ist fehlgeschlagen
+ Das Löschen der FTP-Serverdatei ist abgeschlossen
+ Das Löschen der FTP-Serverdatei ist fehlgeschlagen
+ Das Herunterladen der FTP-Serverdatei ist abgeschlossen
+ Das Herunterladen der FTP-Serverdatei ist fehlgeschlagen
+ Das Umbenennen der FTP-Serverdatei ist abgeschlossen
+ Das Umbenennen der FTP-Serverdatei ist fehlgeschlagen
+ Das Hochladen der FTP-Serverdatei ist abgeschlossen
+ Das Hochladen der FTP-Serverdatei ist fehlgeschlagen
+ Die Erstellung des FTPS-Serververzeichnisses ist abgeschlossen
+ Das Erstellen des FTPS-Serververzeichnisses ist fehlgeschlagen
+ Das Löschen des FTPS-Serververzeichnisses ist abgeschlossen
+ Das Löschen des FTPS-Serververzeichnisses ist fehlgeschlagen
+ Das Löschen der FTPS-Serverdatei ist abgeschlossen
+ Das Löschen der FTPS-Serverdatei ist fehlgeschlagen
+ Das Herunterladen der FTPS-Serverdatei ist abgeschlossen
+ Das Herunterladen der FTPS-Serverdatei ist fehlgeschlagen
+ Das Umbenennen der FTPS-Serverdatei ist abgeschlossen
+ Das Umbenennen der FTPS-Serverdatei ist fehlgeschlagen
+ Das Hochladen der FTPS-Serverdatei ist abgeschlossen
+ Das Hochladen der FTPS-Serverdatei ist fehlgeschlagen
+ Die Erstellung des SFTP-Serververzeichnisses ist abgeschlossen
+ Das Erstellen des SFTP-Serververzeichnisses ist fehlgeschlagen
+ Das Löschen des SFTP-Serververzeichnisses ist abgeschlossen
+ Das Löschen des SFTP-Serververzeichnisses ist fehlgeschlagen
+ Das Löschen der SFTP-Serverdatei ist abgeschlossen
+ Das Löschen der SFTP-Serverdatei ist fehlgeschlagen
+ Das Herunterladen der SFTP-Serverdatei ist abgeschlossen
+ Das Herunterladen der SFTP-Serverdatei ist fehlgeschlagen
+ Die Umbenennung der SFTP-Serverdatei ist abgeschlossen
+ Das Umbenennen der SFTP-Serverdatei ist fehlgeschlagen
+ Das Hochladen der SFTP-Serverdatei ist abgeschlossen
+ Das Hochladen der SFTP-Serverdatei ist fehlgeschlagen

Die `detail-type` Felder `source` und sind unten aufgeführt, da sie spezifische Werte für Transfer Family Ereignisse enthalten. Definitionen der anderen Metadatenfelder, die in allen Ereignissen enthalten sind, finden Sie unter [Referenz zur Ereignisstruktur](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) im *Amazon EventBridge Benutzerhandbuch*.

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "failure-code" : "string",
    "status-code" : "string",
    "protocol" : "string",
    "bytes" : "number",
    "client-ip" : "string",
    "failure-message" : "string",
    "end-timestamp" : "string",
    "etag" : "string",
    "file-path" : "string",
    "original-file-path" : "string",
    "renamed-file-path" : "string",
    "directory-path" : "string",
    "server-id" : "string",
    "username" : "string",
    "session-id" : "string",
    "start-timestamp" : "string"
  }
}
```

`detail-type`  <a name="event-detail-server-events-detail-type"></a>
Identifiziert den Ereignistyp.  
Für dieses Ereignis ist der Wert einer der zuvor aufgeführten SFTP-, FTPS- oder FTP-Serverereignisnamen.

`source`  <a name="event-detail-server-events-source"></a>
Identifiziert den Service, aus dem das Ereignis stammt. Für Transfer Family Family-Veranstaltungen ist dieser Wert`aws.transfer`.

`detail`  <a name="sftp-server-detail"></a>
Ein JSON-Objekt, das Informationen zum Ereignis enthält. Der Service, der das Ereignis generiert, bestimmt den Inhalt dieses Feldes.  
Für dieses Ereignis umfassen die Daten Folgendes:    
`failure-code`  <a name="sftp-server-failure-code"></a>
Kategorie, warum die Übertragung fehlgeschlagen ist. Werte: `PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR`  
`status-code`  <a name="sftp-server-status-code"></a>
Ob die Übertragung erfolgreich ist. Werte:`COMPLETED | FAILED`.  
`protocol`  <a name="sftp-server-protocol"></a>
Das für die Übertragung verwendete Protokoll. Werte: `SFTP | FTPS | FTP`  
`bytes`  <a name="sftp-server-bytes"></a>
Die Anzahl der übertragenen Bytes.  
`client-ip`  <a name="sftp-server-client-ip"></a>
Die IP-Adresse des Clients, der an der Übertragung beteiligt ist  
`failure-message`  <a name="sftp-server-failure-message"></a>
Bei fehlgeschlagenen Übertragungen die Details, warum die Übertragung fehlgeschlagen ist.  
`end-timestamp`  <a name="sftp-server-end-timestamp"></a>
Bei erfolgreichen Übertragungen der Zeitstempel, wann die Verarbeitung der Datei abgeschlossen ist.  
`etag`  <a name="sftp-server-etag"></a>
Das Entity-Tag (wird nur für Amazon S3 S3-Dateien verwendet).  
`file-path`  <a name="sftp-server-file-path"></a>
Der Pfad zu der Datei, die übertragen, gelöscht oder anderweitig bearbeitet wird.  
`original-file-path`  <a name="sftp-server-original-file-path"></a>
Bei Ereignissen zum Umbenennen von Dateien der ursprüngliche Pfad der Datei vor dem Umbenennen.  
`renamed-file-path`  <a name="sftp-server-renamed-file-path"></a>
Bei Ereignissen zum Umbenennen von Dateien der neue Pfad der Datei nach dem Umbenennen.  
`directory-path`  <a name="sftp-server-directory-path"></a>
Bei Ereignissen zum Erstellen und Löschen von Verzeichnissen der Pfad des Verzeichnisses.  
`server-id`  <a name="sftp-server-server-id"></a>
Die eindeutige ID für den Transfer Family Family-Server.  
`username`  <a name="sftp-server-username"></a>
Der Benutzer, der die Übertragung durchführt.  
`session-id`  <a name="sftp-server-session-id"></a>
Die eindeutige Kennung für die Übertragungssitzung.  
`start-timestamp`  <a name="sftp-server-start-timestamp"></a>
Bei erfolgreichen Übertragungen der Zeitstempel für den Beginn der Dateiverarbeitung.

**Example Beispielereignis: Fehler beim Herunterladen der SFTP-Serverdatei**  <a name="event-detail-server-events.example"></a>
Das folgende Beispiel zeigt ein Ereignis, bei dem ein Download auf einem SFTP-Server fehlgeschlagen Amazon EFS ist (wird der Speicher verwendet).  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Download Failed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T17:20:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "failure-code": "PARTIAL_DOWNLOAD",
        "status-code": "FAILED",
        "protocol": "SFTP",
        "bytes": 4100,
        "client-ip": "IP-address",
        "failure-message": "File was partially downloaded.",
        "end-timestamp": "2024-01-29T17:20:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2024-01-29T17:20:16.706282454Z"
    }
}
```

**Example Beispielereignis „Dateiupload abgeschlossen“ auf dem FTP-Server**  <a name="event-detail-server-events.example"></a>
Das folgende Beispiel zeigt ein Ereignis, bei dem ein Upload auf einem FTP-Server erfolgreich abgeschlossen wurde (Amazon S3 wird der Speicher verwendet).  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "FTP Server File Upload Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T16:31:43Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1111aaaa2222bbbb3"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "FTP",
        "bytes": 1048576,
        "client-ip": "10.0.0.141",
        "end-timestamp": "2024-01-29T16:31:43.311866408Z",
        "etag": "b6d81b360a5672d80c27430f39153e2c",
        "file-path": "/amzn-s3-demo-bucket/test/1mb_file",
        "server-id": "s-1111aaaa2222bbbb3",
        "username": "test",
        "session-id": "event-ID",
        "start-timestamp": "2024-01-29T16:31:42.462088327Z"
    }
}
```

**Example Beispielereignis „SFTP-Serverdatei löschen“ abgeschlossen**  <a name="event-detail-server-events.example"></a>
Das folgende Beispiel zeigt ein Ereignis, bei dem eine Datei erfolgreich auf einem SFTP-Server gelöscht wurde.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Delete Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T14:30:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T14:30:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file-to-delete.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T14:30:26.706282454Z"
    }
}
```

**Example Beispielereignis zum Umbenennen der SFTP-Serverdatei abgeschlossen**  <a name="event-detail-server-events.example"></a>
Das folgende Beispiel zeigt ein Ereignis, bei dem eine Datei auf einem SFTP-Server erfolgreich umbenannt wurde.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Rename Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T15:45:12Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T15:45:12.749749117Z",
        "original-file-path": "/fs-1234abcd5678efghi/user0/old-filename.txt",
        "renamed-file-path": "/fs-1234abcd5678efghi/user0/new-filename.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T15:45:11.706282454Z"
    }
}
```

**Example Beispielereignis „SFTP-Serververzeichnis erstellen“ abgeschlossen**  <a name="event-detail-server-events.example"></a>
Das folgende Beispiel zeigt ein Ereignis, bei dem ein Verzeichnis erfolgreich auf einem SFTP-Server erstellt wurde.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server Directory Create Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T16:20:05Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T16:20:05.749749117Z",
        "directory-path": "/fs-1234abcd5678efghi/user0/new-directory",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T16:20:04.706282454Z"
    }
}
```

## Ereignisse des SFTP-Connectors
<a name="event-detail-sftp-connector-events"></a>

**Anmerkung**  
Diese Ereignisse werden EventBridge auf einem dauerhaften Niveau zugestellt, wie unter [Lieferstufe für AWS Serviceereignisse](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) in der *Amazon EventBridge Events-Referenz* beschrieben.

Im Folgenden sind die Detailfelder für SFTP-Connector-Ereignisse aufgeführt:
+ Das Senden der SFTP-Connector-Datei ist abgeschlossen
+ Das Senden der SFTP-Connector-Datei ist fehlgeschlagen
+ Der Abruf der SFTP-Connector-Datei ist abgeschlossen
+ Fehler beim Abrufen der SFTP-Connector-Datei
+ Die Verzeichnisliste für den SFTP-Connector ist abgeschlossen
+ Die Verzeichnisliste für den SFTP-Connector ist fehlgeschlagen
+ Die Remote-Verschiebung des SFTP-Connectors ist abgeschlossen
+ Die Remote-Verschiebung des SFTP-Connectors ist fehlgeschlagen
+ Fernlöschung des SFTP-Connectors abgeschlossen
+ Das Löschen des SFTP-Connectors per Fernzugriff ist fehlgeschlagen

Die `detail-type` Felder `source` und sind unten aufgeführt, da sie spezifische Werte für Transfer Family Ereignisse enthalten. Definitionen der anderen Metadatenfelder, die in allen Ereignissen enthalten sind, finden Sie unter [Referenz zur Ereignisstruktur](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) im *Amazon EventBridge Benutzerhandbuch*.

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "operation" : "string",
    "max-items" : "number",
    "connector-id" : "string",
    "output-directory-path" : "string",
    "listing-id" : "string",
    "transfer-id" : "string",
    "file-transfer-id" : "string",
    "url" : "string",
    "file-path" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "local-directory-path" : "string",
    "remote-directory-path" : "string"
    "item-count" : "number"
    "truncated" : "boolean"
    "bytes" : "number",
    "egress-type" : "string",
    "vpc-lattice-resource-configuration-arn" : "string",
    "vpc-lattice-port-number" : "number",
    "local-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    },
    "output-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    }
  }
}
```

`detail-type`  <a name="event-detail-sftp-connector-events-detail-type"></a>
Identifiziert den Ereignistyp.  
Für dieses Ereignis entspricht der Wert einem der zuvor aufgeführten SFTP-Connector-Ereignisnamen.

`source`  <a name="event-detail-sftp-connector-events-source"></a>
Identifiziert den Service, aus dem das Ereignis stammt. Für Transfer Family Ereignisse ist `aws.transfer` dieser Wert.

`detail`  <a name="sftp-connector-detail"></a>
Ein JSON-Objekt, das Informationen zum Ereignis enthält. Der Dienst, der das Ereignis generiert, bestimmt den Inhalt dieses Felds.  
Für dieses Ereignis umfassen die Daten Folgendes:    
`max-items`  <a name="sftp-connector-max-items"></a>
Die maximale Anzahl von directory/file Namen, die zurückgegeben werden sollen.  
`operation`  <a name="sftp-connector-operation"></a>
Ob die `StartFileTransfer` Anfrage eine Datei sendet oder abruft. Werte:`SEND|RETRIEVE`.  
`connector-id`  <a name="sftp-connector-connector-id"></a>
Die eindeutige Kennung für den verwendeten SFTP-Connector.  
`output-directory-path`  <a name="sftp-connector-output-directory-path"></a>
Der Pfad (Bucket und Präfix) in Amazon S3 zum Speichern der Ergebnisse des file/directory Angebots.  
`listing-id`  <a name="sftp-connector-listing-id"></a>
Eine eindeutige Kennung für den `StartDirectoryListing` API-Vorgang. Diese Kennung kann verwendet werden, um in den CloudWatch Protokollen den Status der Angebotsanfrage zu überprüfen.  
`transfer-id`  <a name="sftp-connector-transfer-id"></a>
Die eindeutige Kennung für das Übertragungsereignis (eine `StartFileTransfer` Anfrage).  
`file-transfer-id`  <a name="sftp-connector-file-transfer-id"></a>
Die eindeutige Kennung für die übertragene Datei.  
`url`  <a name="sftp-connector-url"></a>
Die URL des Partner AS2 - oder SFTP-Endpunkts.  
`file-path`  <a name="sftp-connector-file-path"></a>
Der Speicherort und die Datei, die gesendet oder abgerufen werden.  
`status-code`  <a name="sftp-connector-status-code"></a>
Ob die Übertragung erfolgreich ist. Werte:`FAILED | COMPLETED`.   
`failure-code`  <a name="sftp-connector-failure-code"></a>
Bei fehlgeschlagenen Übertragungen der Ursachencode, warum die Übertragung fehlgeschlagen ist.  
`failure-message`  <a name="sftp-connector-failure-message"></a>
Bei fehlgeschlagenen Übertragungen die Details, warum die Übertragung fehlgeschlagen ist.  
`start-timestamp`  <a name="sftp-connector-start-timestamp"></a>
Bei erfolgreichen Übertragungen der Zeitstempel für den Beginn der Dateiverarbeitung.  
`end-timestamp`  <a name="sftp-connector-end-timestamp"></a>
Bei erfolgreichen Übertragungen der Zeitstempel für den Abschluss der Dateiverarbeitung.  
`local-directory-path`  <a name="sftp-connector-local-directory-path"></a>
Bei `RETRIEVE` Anfragen der Ort, an dem die abgerufene Datei abgelegt werden soll.  
`remote-directory-path`  <a name="sftp-connector-remote-directory-path"></a>
Bei `SEND` Anfragen das Dateiverzeichnis, in dem die Datei auf dem SFTP-Server des Partners abgelegt werden soll. Dies ist der Wert für den`RemoteDirectoryPath`, den der Benutzer an die `StartFileTransfer` Anfrage übergeben hat. Sie können ein Standardverzeichnis auf dem SFTP-Server des Partners angeben. Wenn ja, ist dieses Feld leer.  
`item-count`  <a name="sftp-connector-item-count"></a>
Die Anzahl der Elemente (Verzeichnisse und Dateien), die für die Angebotsanfrage zurückgegeben wurden.  
`truncated`  <a name="sftp-connector-truncated"></a>
Ob die Listenausgabe alle im Remote-Verzeichnis enthaltenen Elemente enthält oder nicht.  
`bytes`  <a name="sftp-connector-bytes"></a>
Die Anzahl der übertragenen Byte. Der Wert ist 0 für fehlgeschlagene Übertragungen.  
`egress-type`  <a name="sftp-connector-egress-type"></a>
Art der Ausgangskonfiguration für den Connector. Werte: `SERVICE_MANAGED` oder`VPC_LATTICE`.  
`vpc-lattice-resource-configuration-arn`  <a name="sftp-connector-vpc-lattice-resource-configuration-arn"></a>
ARN der VPC\$1LATTICE-Ressourcenkonfiguration, die den Ziel-SFTP-Serverstandort definiert. Dieses Feld ist für vom Service verwaltete Connectors leer.  
`vpc-lattice-port-number`  <a name="sftp-connector-vpc-lattice-port-number"></a>
Portnummer für die Verbindung zum SFTP-Server über VPC\$1LATTICE.  
`local-file-location`  <a name="sftp-connector-local-file-location"></a>
Dieser Parameter enthält die Details zum Speicherort der Speicherdatei. AWS     
`domain`  <a name="sftp-connector-domain"></a>
Der Speicher, der verwendet wird. Derzeit ist der einzige Wert`S3`.  
`bucket`  <a name="sftp-connector-bucket"></a>
Der Container für das Objekt in Amazon S3.  
`key`  <a name="sftp-connector-key"></a>
Der dem Objekt in Amazon S3 zugewiesene Name.  
`output-file-location`  <a name="sftp-connector-output-file-location"></a>
Dieser Parameter enthält die Details des AWS Speicherorts, an dem die Ergebnisse der Verzeichnisliste gespeichert werden sollen.    
`domain`  <a name="sftp-connector-output-domain"></a>
Der verwendete Speicher. Derzeit ist der einzige Wert`S3`.  
`bucket`  <a name="sftp-connector-output-bucket"></a>
Der Container für das Objekt in Amazon S3.  
`key`  <a name="sftp-connector-output-key"></a>
Der dem Objekt in Amazon S3 zugewiesene Name.

**Example Beispielereignis beim Senden der SFTP-Connector-Datei fehlgeschlagen**  <a name="event-detail-sftp-connector-events.example"></a>
Das folgende Beispiel zeigt ein Ereignis, bei dem ein SFTP-Connector beim Versuch, eine Datei an einen Remote-SFTP-Server zu senden, fehlgeschlagen ist.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Send Failed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T19:30:45Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "SEND",
        "connector-id": "c-f1111aaaa2222bbbb3",
        "transfer-id": "transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "/amzn-s3-demo-bucket/testfile.txt",
        "status-code": "FAILED",
        "failure-code": "CONNECTION_ERROR",
        "failure-message": "Unknown Host",
        "remote-directory-path": "",
        "bytes": 0,
        "start-timestamp": "2024-01-24T18:29:33.658729Z",
        "end-timestamp": "2024-01-24T18:29:33.993196Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example Beispielereignis „SFTP-Connector File Retrieve Completed“**  <a name="event-detail-sftp-connector-events.example"></a>
Das folgende Beispiel zeigt ein Ereignis, bei dem ein SFTP-Connector erfolgreich eine von einem Remote-SFTP-Server gesendete Datei abgerufen hat.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Retrieve Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "RETRIEVE",
        "connector-id": "c-fc68000012345aa18",
        "transfer-id": "file-transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "testfile.txt",
        "status-code": "COMPLETED",
        "local-directory-path": "/amzn-s3-demo-bucket",
        "bytes": 63533,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example Beispielereignis mit der Verzeichnisliste des SFTP-Connectors abgeschlossen**  <a name="event-detail-sftp-connector-events.example"></a>
Das folgende Beispiel zeigt ein Ereignis, bei dem ein Startaufruf für die Verzeichnisauflistung eine Auflistungsdatei von einem Remote-SFTP-Server abgerufen hat.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector Directory Listing Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "max-items": 10000,
        "connector-id": "c-fc68000012345aa18",
        "output-directory-path": "/amzn-s3-demo-bucket/example/file-listing-output",
        "listing-id": "123456-23aa-7980-abc1-1a2b3c4d5e",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",        
        "status-code": "COMPLETED",
        "remote-directory-path": "/home",
        "item-count": 10000,
        "truncated": true,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "output-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "c-fc1ab90fd0d047e7a-70987273-49nn-4006-bab1-1a7290cc412ba.json"
        }
    }
}
```

## AS2 Ereignisse
<a name="event-detail-as2-server-events"></a>

**Anmerkung**  
Diese Ereignisse werden EventBridge auf einem dauerhaften Niveau zugestellt, wie unter [Lieferstufe für AWS Serviceereignisse](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) in der *Amazon EventBridge Events-Referenz* beschrieben.

Im Folgenden sind die Detailfelder für AS2 Ereignisse aufgeführt:
+ AS2 Empfang der Payload abgeschlossen
+ AS2 Der Empfang der Nutzdaten ist fehlgeschlagen
+ AS2 Versand der Payload abgeschlossen
+ AS2 Payload konnte nicht gesendet werden
+ AS2 MDN-Empfang abgeschlossen
+ AS2 MDN-Empfang fehlgeschlagen
+ AS2 MDN-Sendung abgeschlossen
+ AS2 MDN-Sendung ist fehlgeschlagen

Die `detail-type` Felder `source` und sind unten aufgeführt, da sie spezifische Werte für Transfer Family Ereignisse enthalten. Definitionen der anderen Metadatenfelder, die in allen Ereignissen enthalten sind, finden Sie unter [Referenz zur Ereignisstruktur](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) im *Amazon EventBridge Benutzerhandbuch*.

```
{
   . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {    
    "s3-attributes" : {
      "file-bucket" : "string",
      "file-key" : "string",
      "json-bucket" : "string",
      "json-key" : "string", 
      "mdn-bucket" : "string",
      "mdn-key" : "string"
      }
    "mdn-subject" : "string",
    "mdn-message-id" : "string",
    "disposition" : "string",
    "bytes" : "number",
    "as2-from" : "string",
    "as2-message-id" : "string",
    "as2-to" : "string",
    "connector-id" : "string",
    "client-ip" : "string",
    "agreement-id" : "string",
    "server-id" : "string",
    "requester-file-name" : "string",
    "message-subject" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "transfer-id" : "string"
  }
}
```

`detail-type`  <a name="event-detail-as2-server-events-detail-type"></a>
Identifiziert den Ereignistyp.  
Für dieses Ereignis ist der Wert eines der zuvor aufgeführten AS2 Ereignisse.

`source`  <a name="event-detail-as2-server-events-source"></a>
Identifiziert den Service, aus dem das Ereignis stammt. Für Transfer Family Ereignisse ist dieser Wert`aws.transfer`.

`detail`  <a name="as2-server-detail"></a>
Ein JSON-Objekt, das Informationen zum Ereignis enthält. Der Service, der das Ereignis generiert, bestimmt den Inhalt dieses Feldes.    
`s3-attributes`  <a name="as2-server-s3-attributes"></a>
Identifiziert den Amazon S3 S3-Bucket und den Schlüssel für die übertragene Datei. Bei MDN-Ereignissen identifiziert es auch den Bucket und den Schlüssel für die MDN-Datei.    
`file-bucket`  <a name="as2-server-s3-file-bucket"></a>
Der Container für das Objekt in Amazon S3.  
`file-key`  <a name="as2-server-s3-file-key"></a>
Der dem Objekt in Amazon S3 zugewiesene Name.  
`json-bucket`  <a name="as2-server-s3-json-bucket"></a>
Bei ABGESCHLOSSENEN oder FEHLGESCHLAGENEN Übertragungen der Container für die JSON-Datei.  
`json-key`  <a name="as2-server-s3-json-key"></a>
Bei ABGESCHLOSSENEN oder FEHLGESCHLAGENEN Übertragungen der Name, der der JSON-Datei in Amazon S3 zugewiesen wurde.  
`mdn-bucket`  <a name="as2-server-s3-mdn-bucket"></a>
Bei MDN-Ereignissen der Container für die MDN-Datei.  
`mdn-key`  <a name="as2-server-s3-mdn-key"></a>
Bei MDN-Ereignissen der Name, der der MDN-Datei in Amazon S3 zugewiesen wurde.   
`mdn-subject`  <a name="as2-server-mdn-subject"></a>
Bei MDN-Ereignissen eine Textbeschreibung für die Nachrichtenverwaltung.  
`mdn-message-id`  <a name="as2-server-mdn-message-id"></a>
Bei MDN-Ereignissen eine eindeutige ID für die MDN-Nachricht.  
`disposition`  <a name="as2-server-disposition"></a>
Bei MDN-Ereignissen die Kategorie für die Disposition.  
`bytes`  <a name="as2-server-bytes"></a>
Die Anzahl der Byte in der Nachricht.  
`as2-from`  <a name="as2-server-as2-from"></a>
Der AS2 Handelspartner, der die Nachricht sendet.  
`as2-message-id`  <a name="as2-server-as2-message-id"></a>
Eine eindeutige Kennung für die zu übertragende AS2 Nachricht.  
`as2-to`  <a name="as2-server-as2-to"></a>
Der AS2 Handelspartner, der die Nachricht erhält.  
`connector-id`  <a name="as2-server-connector-id"></a>
Für AS2 Nachrichten, die von einem Transfer Family Family-Server an einen Handelspartner gesendet werden, wird die eindeutige Kennung für den AS2 Connector verwendet.  
`client-ip`  <a name="as2-server-client-ip"></a>
Bei Serverereignissen (Übertragungen von einem Geschäftspartner zu einem Transfer Family Family-Server) die IP-Adresse des an der Übertragung beteiligten Clients.   
`agreement-id`  <a name="as2-server-agreement-id"></a>
Bei Serverereignissen die eindeutige Kennung für die AS2 Vereinbarung.  
`server-id`  <a name="as2-server-server-id"></a>
Für Serverereignisse eine eindeutige ID nur für den Transfer Family Family-Server.  
`requester-file-name`  <a name="as2-server-requester-file-name"></a>
Bei Payload-Ereignissen der ursprüngliche Name der Datei, die während der Übertragung empfangen wurde.  
`message-subject`  <a name="as2-server-message-subject"></a>
Eine Textbeschreibung für den Betreff der Nachricht.  
`start-timestamp`  <a name="as2-server-start-timestamp"></a>
Bei erfolgreichen Übertragungen der Zeitstempel für den Beginn der Dateiverarbeitung.  
`end-timestamp`  <a name="as2-server-end-timestamp"></a>
Bei erfolgreichen Übertragungen der Zeitstempel für den Abschluss der Dateiverarbeitung.  
`status-code`  <a name="as2-server-status-code"></a>
Der Code, der dem Status des AS2 Nachrichtenübertragungsprozesses entspricht. Zulässige Werte: `COMPLETED | FAILED | PROCESSING`.  
`failure-code`  <a name="as2-server-failure-code"></a>
Bei fehlgeschlagenen Übertragungen die Kategorie, warum die Übertragung fehlgeschlagen ist.  
`failure-message`  <a name="as2-server-failure-message"></a>
Bei fehlgeschlagenen Übertragungen die Details, warum die Übertragung fehlgeschlagen ist.  
`transfer-id`  <a name="as2-server-transfer-id"></a>
Die eindeutige Kennung für das Übertragungsereignis.

**Example AS2 Beispielereignis „Payload Receive Completed“**  <a name="event-detail-as2-server-events.example"></a>

```
{
    "version": "0",
     "id": "event-ID",
    "detail-type": "AS2 Payload Receive Completed",
    "source": "aws.transfer",
    "account": "076722215406",
    "time": "2024-02-07T06:47:05Z",
    "region": "us-east-1",
    "resources": ["arn:aws:transfer:us-east-1:076722215406:connector/c-1111aaaa2222bbbb3"],
    "detail": {
        "s3-attributes": {
            "file-key": "/inbound/processed/testAs2Message.dat",
            "file-bucket": "amzn-s3-demo-bucket"
        },
        "client-ip": "client-IP-address",
        "requester-file-name": "testAs2MessageVerifyFile.dat",
        "end-timestamp": "2024-02-07T06:47:06.040031Z",
        "as2-from": "as2-from-ID",
        "as2-message-id": "as2-message-ID",
        "message-subject": "Message from AS2 tests",
        "start-timestamp": "2024-02-07T06:47:05.410Z",
        "status-code": "PROCESSING",
        "bytes": 63,
        "as2-to": "as2-to-ID",
        "agreement-id": "a-1111aaaa2222bbbb3",
        "server-id": "s-1234abcd5678efghi"
    }
}
```

**Example AS2 Beispielereignis „MDN Receive Failed“**  <a name="event-detail-as2-server-events.example"></a>

```
{
  "version": "0",
  "id": "event-ID",
  "detail-type": "AS2 MDN Receive Failed",
  "source": "aws.transfer",
  "account": "889901007463",
  "time": "2024-02-06T22:05:09Z",
  "region": "us-east-1",
  "resources": ["arn:aws:transfer:us-east-1:076722215406:server/s-1111aaaa2222bbbb3"],
  "detail": {      
      "mdn-subject": "Your Requested MDN Response re: Test run from Id 123456789abcde to partner ijklmnop987654",
      "s3-attributes": {
          "json-bucket": "amzn-s3-demo-bucket1",
          "file-key": "/as2Integ/TestOutboundWrongCert.dat",
          "file-bucket": "amzn-s3-demo-bucket2",
          "json-key": "/as2Integ/failed/TestOutboundWrongCert.dat.json"
      },
      "mdn-message-id": "MDN-message-ID",
      "end-timestamp": "2024-02-06T22:05:09.479878Z",
      "as2-from": "PartnerA",
      "as2-message-id": "as2-message-ID",
      "connector-id": "c-1234abcd5678efghj",
      "message-subject": "Test run from Id 123456789abcde to partner ijklmnop987654",
      "start-timestamp": "2024-02-06T22:05:03Z",
      "failure-code": "VERIFICATION_FAILED_NO_MATCHING_KEY_FOUND",
      "status-code": "FAILED",
      "as2-to": "MyCompany",
      "failure-message": "No public certificate matching message signature could be found in profile: p-1234abcd5678efghj",
      "transfer-id": "transfer-ID"
  }
}
```