Transfer Family Referenz mit Einzelheiten zu Ereignissen - AWS Transfer Family
ServerereignisseConnector-EreignisseAS2-Ereignisse

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

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 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 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 zur Erstellung von Ereignismustern, die es Regeln ermöglichen, Transfer Family Ereignissen zuzuordnen, 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:

  • 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 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 ist der Wert einer der zuvor aufgeführten SFTP-, FTPS- oder FTP-Serverereignisnamen.

source

Identifiziert den Service, aus dem das Ereignis stammt. Für Transfer Family Family-Veranstaltungen ist dieser Wertaws.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 umfassen die Daten Folgendes:

failure-code

Kategorie, warum die Übertragung fehlgeschlagen ist. Werte: PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR

status-code

Ob die Übertragung erfolgreich ist. 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, wann die Verarbeitung der Datei abgeschlossen ist.

etag

Das Entity-Tag (wird nur für Amazon S3 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 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 für den Beginn der Dateiverarbeitung.

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"
    }
}
Beispielereignis „Dateiupload abgeschlossen“ auf dem FTP-Server

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"
    }
}
Beispielereignis „SFTP-Serverdatei löschen“ 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"
    }
}
Beispielereignis zum Umbenennen der SFTP-Serverdatei 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"
    }
}
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 einem dauerhaften Niveau zugestellt, wie unter Lieferstufe für AWS Serviceereignisse 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 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",
    "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 umfassen 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 übertragene Datei.

url

Die URL des Partner AS2 - oder SFTP-Endpunkts.

file-path

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

status-code

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

failure-code

Bei fehlgeschlagenen Übertragungen der Ursachencode, warum die Übertragung fehlgeschlagen ist.

failure-message

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

start-timestamp

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

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 ist 0 für fehlgeschlagene Übertragungen.

local-file-location

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

domain

Der Speicher, der verwendet wird. Derzeit ist der einzige WertS3.

bucket

Der Container für das Objekt in Amazon S3.

key

Der dem Objekt in Amazon S3 zugewiesene Name.

output-file-location

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

domain

Der verwendete Speicher. Derzeit ist der einzige WertS3.

bucket

Der Container für das Objekt in Amazon S3.

key

Der dem Objekt in Amazon S3 zugewiesene Name.

Beispielereignis beim Senden der SFTP-Connector-Datei fehlgeschlagen

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"
        }
    }
}
Beispielereignis „SFTP-Connector File Retrieve Completed“

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"
        }
    }
}
Beispielereignis mit der Verzeichnisliste des SFTP-Connectors abgeschlossen

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

Anmerkung

Diese Ereignisse werden EventBridge auf einem dauerhaften Niveau zugestellt, wie unter Lieferstufe für AWS Serviceereignisse 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 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

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 dieser Wertaws.transfer.

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 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 dem Objekt in Amazon S3 zugewiesene Name.

json-bucket

Bei ABGESCHLOSSENEN oder FEHLGESCHLAGENEN Ü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

Bei MDN-Ereignissen der Container für die MDN-Datei.

mdn-key

Bei MDN-Ereignissen der Name, der der MDN-Datei in Amazon S3 zugewiesen wurde.

mdn-subject

Bei MDN-Ereignissen eine Textbeschreibung für die Nachrichtenverwaltung.

mdn-message-id

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

disposition

Bei MDN-Ereignissen 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 erhält.

connector-id

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

Bei Serverereignissen (Übertragungen von einem Geschäftspartner zu einem Transfer Family 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

Für Serverereignisse eine eindeutige ID nur für den Transfer Family Family-Server.

requester-file-name

Bei Payload-Ereignissen 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 für den Beginn der Dateiverarbeitung.

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 AS2 Beispielereignis „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 AS2 Beispielereignis „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"
  }
}