

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 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"
  }
}
```