Serverereignisse Connector-Ereignisse AS2-Ereignisse

Transfer Family Referenz zu den Einzelheiten der Ereignisse

Alle Ereignisse von AWS Diensten haben einen gemeinsamen Satz von Feldern, die Metadaten über das 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 Event-Struktur im Amazon EventBridge Benutzerhandbuch.

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

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 gesetztaws.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 zum Erstellen von Ereignismustern, die es Regeln ermöglichen, Transfer Family Ereignisse abzugleichen, finden Sie im Amazon EventBridge Benutzerhandbuch unter Ereignismuster.

Weitere Informationen zu Ereignissen und deren EventBridge Verarbeitung finden Sie im Amazon EventBridge Benutzerhandbuch unter Amazon EventBridge Ereignisse.

SFTP-, FTPS- und FTP-Serverereignisse

Im Folgenden finden Sie die Detailfelder für SFTP-, FTPS- und FTP-Serverereignisse:

Das Erstellen 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
Umbenennung der FTP-Serverdatei abgeschlossen
Das Umbenennen der FTP-Serverdatei ist fehlgeschlagen
Das Hochladen der FTP-Serverdatei ist abgeschlossen
Das Hochladen der FTP-Serverdatei ist fehlgeschlagen
Das Erstellen 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
Die Umbenennung 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
Das Erstellen 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 bestimmte Werte für Transfer Family Ereignisse enthalten. Definitionen der anderen Metadatenfelder, die in allen Ereignissen enthalten sind, finden Sie unter Referenz zur Event-Struktur 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

Identifiziert den Ereignistyp.

Für dieses Ereignis entspricht der Wert einem der zuvor aufgeführten SFTP-, FTPS- oder FTP-Serverereignisnamen.

source

Identifiziert den Service, aus dem das Ereignis stammt. Für Transfer Family-Ereignisse lautet dieser Wert. aws.transfer

detail

Ein JSON-Objekt, das Informationen zum Ereignis enthält. Der Service, der das Ereignis generiert, bestimmt den Inhalt dieses Feldes.

Für dieses Ereignis beinhalten die Daten Folgendes:

failure-code: Kategorie, warum die Übertragung fehlgeschlagen ist. Werte: PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR
status-code: Ob die Übertragung erfolgreich war. Werte:COMPLETED | FAILED.
protocol: Das für die Übertragung verwendete Protokoll. Werte: SFTP | FTPS | FTP
bytes: Die Anzahl der übertragenen Bytes.
client-ip: Die IP-Adresse des an der Übertragung beteiligten Clients
failure-message: Bei fehlgeschlagenen Übertragungen die Details, warum die Übertragung fehlgeschlagen ist.
end-timestamp: Bei erfolgreichen Übertragungen der Zeitstempel, an dem die Verarbeitung der Datei abgeschlossen ist.
etag: Das Entitäts-Tag (wird nur für Amazon S3-Dateien verwendet).
file-path: Der Pfad zu der Datei, die übertragen, gelöscht oder anderweitig bearbeitet wird.
original-file-path: Bei Ereignissen zum Umbenennen von Dateien der ursprüngliche Pfad der Datei vor dem Umbenennen.
renamed-file-path: Bei Ereignissen zum Umbenennen von Dateien der neue Pfad der Datei nach dem Umbenennen.
directory-path: Bei Ereignissen zum Erstellen und Löschen von Verzeichnissen der Pfad des Verzeichnisses.
server-id: Die eindeutige ID für den Transfer Family-Server.
username: Der Benutzer, der die Übertragung durchführt.
session-id: Die eindeutige Kennung für die Übertragungssitzung.
start-timestamp: Bei erfolgreichen Übertragungen der Zeitstempel, an dem die Dateiverarbeitung beginnt.

Beispiel Beispielereignis: Fehler beim Herunterladen der SFTP-Serverdatei

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

Beispiel Beispielereignis „Dateiupload auf FTP-Server abgeschlossen“

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

Beispiel Beispielereignis „Datei löschen auf dem SFTP-Server abgeschlossen“

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

Beispiel Beispielereignis „Dateiumbenennung auf dem SFTP-Server abgeschlossen“

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

Beispiel Beispielereignis „SFTP-Serververzeichnis erstellen“ abgeschlossen

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

Anmerkung

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

Im Folgenden finden Sie die Detailfelder für SFTP-Connector-Ereignisse:

Das Senden der SFTP-Connector-Datei ist abgeschlossen
Das Senden der SFTP-Connectordatei ist fehlgeschlagen
Das Abrufen der SFTP-Connectordatei ist abgeschlossen
Fehler beim Abrufen der SFTP-Connectordatei
Die Verzeichnisliste für den SFTP-Connector ist abgeschlossen
Die Verzeichnisliste für den SFTP-Connector ist fehlgeschlagen
Fernübertragung des SFTP-Connectors abgeschlossen
Die Fernübertragung des SFTP-Connectors ist fehlgeschlagen
Das Remote-Löschen des SFTP-Connectors ist abgeschlossen
Das Remote-Löschen des SFTP-Connectors 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 Event-Struktur 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

Identifiziert den Ereignistyp.

Für dieses Ereignis entspricht der Wert einem der zuvor aufgeführten SFTP-Connector-Ereignisnamen.

source

Identifiziert den Service, aus dem das Ereignis stammt. Für Transfer Family Ereignisse ist aws.transfer dieser Wert.

detail

Ein JSON-Objekt, das Informationen zum Ereignis enthält. Der Dienst, der das Ereignis generiert, bestimmt den Inhalt dieses Felds.

Für dieses Ereignis beinhalten die Daten Folgendes:

max-items

Die maximale Anzahl von directory/file Namen, die zurückgegeben werden sollen.

operation

Ob die StartFileTransfer Anfrage eine Datei sendet oder abruft. Werte:SEND|RETRIEVE.

connector-id

Die eindeutige Kennung für den verwendeten SFTP-Connector.

output-directory-path

Der Pfad (Bucket und Präfix) in Amazon S3 zum Speichern der Ergebnisse des file/directory Angebots.

listing-id

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

Die eindeutige Kennung für das Übertragungsereignis (eine StartFileTransfer Anfrage).

file-transfer-id

Die eindeutige Kennung für die Datei, die übertragen wird.

url

Die URL des AS2- oder SFTP-Endpunkts des Partners.

file-path

Der Speicherort und die Datei, die gesendet oder abgerufen werden.

status-code

Ob die Übertragung erfolgreich war. Werte:FAILED | COMPLETED.

failure-code

failure-message

Bei fehlgeschlagenen Übertragungen die Details, warum die Übertragung fehlgeschlagen ist.

start-timestamp

Bei erfolgreichen Übertragungen der Zeitstempel, an dem die Dateiverarbeitung beginnt.

end-timestamp

Bei erfolgreichen Übertragungen der Zeitstempel für den Abschluss der Dateiverarbeitung.

local-directory-path

Bei RETRIEVE Anfragen der Ort, an dem die abgerufene Datei abgelegt werden soll.

remote-directory-path

Bei SEND Anfragen das Dateiverzeichnis, in dem die Datei auf dem SFTP-Server des Partners abgelegt werden soll. Dies ist der Wert für denRemoteDirectoryPath, 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

Die Anzahl der Elemente (Verzeichnisse und Dateien), die für die Angebotsanfrage zurückgegeben wurden.

truncated

Ob die Listenausgabe alle im Remote-Verzeichnis enthaltenen Elemente enthält oder nicht.

bytes

Die Anzahl der übertragenen Byte. Der Wert für fehlgeschlagene Übertragungen ist 0.

egress-type

Art der Ausgangskonfiguration für den Connector. Werte: SERVICE_MANAGED oderVPC_LATTICE.

vpc-lattice-resource-configuration-arn

ARN der VPC_LATTICE-Ressourcenkonfiguration, die den Ziel-SFTP-Serverstandort definiert. Dieses Feld ist für dienstverwaltete Connectors Null.

vpc-lattice-port-number

Portnummer für die Verbindung zum SFTP-Server über VPC_LATTICE.

local-file-location

Dieser Parameter enthält die Details zum Speicherort der Speicherdatei. AWS

domain: Der verwendete Speicher. Derzeit ist der einzige WertS3.
bucket: Der Container für das Objekt in Amazon S3.
key: Der Name, der dem Objekt in Amazon S3 zugewiesen wurde.

output-file-location

Dieser Parameter enthält die Details des Speicherorts, an dem die Ergebnisse der Verzeichnisliste im AWS Speicher gespeichert werden sollen.

domain: Der verwendete Speicher. Derzeit ist der einzige WertS3.
bucket: Der Container für das Objekt in Amazon S3.
key: Der Name, der dem Objekt in Amazon S3 zugewiesen wurde.

Beispiel Beispielereignis: Das Senden der SFTP-Connector-Datei ist fehlgeschlagen

Das folgende Beispiel zeigt ein Ereignis, bei dem ein SFTP-Connector beim Versuch, eine Datei an einen Remote-SFTP-Server zu senden, ausgefallen 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"
        }
    }
}

Beispiel Beispielereignis zum Abrufen der SFTP-Connector-Datei „Abgeschlossen“

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

Beispiel Beispielereignis „Liste des SFTP-Connector-Verzeichnisses abgeschlossen“

Das folgende Beispiel zeigt ein Ereignis, bei dem ein Startaufruf zur 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

Anmerkung

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

Im Folgenden sind die Detailfelder für AS2-Ereignisse aufgeführt:

Empfang der AS2-Nutzdaten abgeschlossen
Der Empfang der AS2-Nutzlast ist fehlgeschlagen
Das Senden der AS2-Nutzlast ist abgeschlossen
Das Senden der AS2-Nutzlast ist fehlgeschlagen
AS2-MDN-Empfang abgeschlossen
AS2 MDN-Empfang fehlgeschlagen
AS2 MDN-Versand abgeschlossen
AS2 MDN konnte nicht gesendet werden


{
   . . .,
  "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

Identifiziert den Ereignistyp.

Für dieses Ereignis ist der Wert eines der zuvor aufgeführten AS2-Ereignisse.

source

Identifiziert den Service, aus dem das Ereignis stammt. Für Transfer Family Ereignisse ist aws.transfer dieser Wert.

detail

Ein JSON-Objekt, das Informationen zum Ereignis enthält. Der Service, der das Ereignis generiert, bestimmt den Inhalt dieses Feldes.

s3-attributes

Identifiziert den Amazon 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: Der Container für das Objekt in Amazon S3.
file-key: Der Name, der dem Objekt in Amazon S3 zugewiesen wurde.
json-bucket: Für ABGESCHLOSSENE oder FEHLGESCHLAGENE Übertragungen der Container für die JSON-Datei.
json-key: Bei ABGESCHLOSSENEN oder FEHLGESCHLAGENEN Übertragungen der Name, der der JSON-Datei in Amazon S3 zugewiesen wurde.
mdn-bucket: Für MDN-Ereignisse der Container für die MDN-Datei.
mdn-key: Für MDN-Ereignisse der Name, der der MDN-Datei in Amazon S3 zugewiesen wurde.

mdn-subject

Für MDN-Ereignisse eine Textbeschreibung für die Nachrichtenlöschung.

mdn-message-id

Bei MDN-Ereignissen eine eindeutige ID für die MDN-Nachricht.

disposition

Für MDN-Ereignisse die Kategorie für die Disposition.

bytes

Die Anzahl der Byte in der Nachricht.

as2-from

Der AS2-Handelspartner, der die Nachricht sendet.

as2-message-id

Eine eindeutige Kennung für die AS2-Nachricht, die übertragen wird.

as2-to

Der AS2-Handelspartner, der die Nachricht empfängt.

connector-id

Für AS2-Nachrichten, die von einem Transfer Family-Server an einen Handelspartner gesendet werden, wird die eindeutige Kennung für den AS2-Connector verwendet.

client-ip

Bei Serverereignissen (Übertragungen von einem Handelspartner zu einem Transfer Family-Server) die IP-Adresse des an der Übertragung beteiligten Clients.

agreement-id

Bei Serverereignissen die eindeutige Kennung für die AS2-Vereinbarung.

server-id

Bei Serverereignissen eine eindeutige ID nur für den Transfer Family-Server.

requester-file-name

Bei Nutzlastereignissen der ursprüngliche Name der Datei, die während der Übertragung empfangen wurde.

message-subject

Eine Textbeschreibung für den Betreff der Nachricht.

start-timestamp

Bei erfolgreichen Übertragungen der Zeitstempel, an dem die Dateiverarbeitung beginnt.

end-timestamp

Bei erfolgreichen Übertragungen der Zeitstempel für den Abschluss der Dateiverarbeitung.

status-code

Der Code, der dem Status des AS2-Nachrichtenübertragungsprozesses entspricht. Zulässige Werte: COMPLETED | FAILED | PROCESSING.

failure-code

Bei fehlgeschlagenen Übertragungen die Kategorie, warum die Übertragung fehlgeschlagen ist.

failure-message

Bei fehlgeschlagenen Übertragungen die Details, warum die Übertragung fehlgeschlagen ist.

transfer-id

Die eindeutige Kennung für das Übertragungsereignis.

Beispiel Beispielereignis „AS2 Payload Receive Completed“


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

Beispiel Beispielereignis AS2 MDN Receive Failed


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

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Ereignisse verwalten mit EventBridge

Sicherheit