SFTPConnector-Ereignisse - AWS Transfer Family

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.

SFTPConnector-Ereignisse

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

  • SFTPDer Versand der Connector-Datei ist abgeschlossen

  • SFTPDas Senden der Connector-Datei ist fehlgeschlagen

  • SFTPDer Abruf der Connector-Datei ist abgeschlossen

  • SFTPDas Abrufen der Connector-Datei 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",
    "connector-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"
    "bytes" : "number",
    "local-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    },
  }
}
detail-type

Identifiziert den Ereignistyp.

Für dieses Ereignis ist der Wert einer der zuvor aufgeführten SFTP Connector-Ereignisnamen.

source

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

detail

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

Für dieses Ereignis umfassen die Daten Folgendes:

operation

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

connector-id

Die eindeutige Kennung für den verwendeten SFTP Connector.

transfer-id

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

file-transfer-id

Die eindeutige Kennung für die übertragene Datei.

url

Der URL des Partners 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.

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.

Beispiel SFTPBeispielereignis beim Senden der Connector-Datei fehlgeschlagen

Das folgende Beispiel zeigt ein Ereignis, bei dem ein SFTP Connector beim Versuch, eine Datei an einen SFTP Remoteserver 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": "/DOC-EXAMPLE-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": "DOC-EXAMPLE-BUCKET",
            "key": "testfile.txt"
        }
    }
}
Beispiel SFTPBeispielereignis „Connector-Datei abrufen abgeschlossen“

Das folgende Beispiel zeigt ein Ereignis, bei dem ein SFTP Connector erfolgreich eine von einem SFTP Remoteserver 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": "/DOC-EXAMPLE-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": "DOC-EXAMPLE-BUCKET",
            "key": "testfile.txt"
        }
    }
}