SFTPeventi del connettore - AWS Transfer Family

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

SFTPeventi del connettore

Di seguito sono riportati i campi di dettaglio per gli eventi SFTP del connettore:

  • SFTPInvio del file del connettore completato

  • SFTPInvio del file del connettore non riuscito

  • SFTPRecupero del file del connettore completato

  • SFTPRecupero del file del connettore non riuscito

I detail-type campi source e sono inclusi di seguito perché contengono valori specifici per Transfer Family gli eventi. Per le definizioni degli altri campi di metadati inclusi in tutti gli eventi, consulta il riferimento alla struttura degli eventi nella Guida per l'Amazon EventBridge utente.

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

Identifica il tipo di evento.

Per questo evento, il valore è uno dei nomi di eventi del SFTP connettore elencati in precedenza.

source

Identifica il servizio che ha generato l'evento. Per Transfer Family gli eventi, questo valore èaws.transfer.

detail

Un JSON oggetto che contiene informazioni sull'evento. Il servizio che genera l'evento determina il contenuto di questo campo.

Per questo evento, i dati includono quanto segue:

operation

Se la StartFileTransfer richiesta consiste nell'invio o nel recupero di un file. Valori:. SEND|RETRIEVE

connector-id

L'identificatore univoco del SFTP connettore utilizzato.

transfer-id

L'identificatore univoco per l'evento di trasferimento (una StartFileTransfer richiesta).

file-transfer-id

L'identificatore univoco del file da trasferire.

url

L'endpoint URL del partner AS2 o dell'SFTPendpoint.

file-path

La posizione e il file che vengono inviati o recuperati.

status-code

Se il trasferimento ha esito positivo. Valori:FAILED | COMPLETED.

failure-code

Per i trasferimenti non riusciti, il codice del motivo per cui il trasferimento non è riuscito.

failure-message

Per i trasferimenti non riusciti, i dettagli del motivo per cui il trasferimento non è riuscito.

start-timestamp

Per trasferimenti riusciti, il timestamp di inizio dell'elaborazione dei file.

end-timestamp

Per trasferimenti riusciti, il timestamp del completamento dell'elaborazione del file.

local-directory-path

Per RETRIEVE le richieste, la posizione in cui inserire il file recuperato.

remote-directory-path

Per SEND le richieste, la directory dei file in cui inserire il file sul SFTP server del partner. Questo è il valore RemoteDirectoryPath che l'utente ha passato alla StartFileTransfer richiesta. È possibile specificare una directory predefinita sul SFTP server del partner. In tal caso, questo campo è vuoto.

bytes

Il numero di byte da trasferire. Il valore è 0 per i trasferimenti non riusciti.

local-file-location

Questo parametro contiene i dettagli della posizione del file di AWS archiviazione.

domain

Lo spazio di archiviazione utilizzato. Attualmente, l'unico valore èS3.

bucket

Il contenitore per l'oggetto in Amazon S3.

key

Il nome assegnato all'oggetto in Amazon S3.

Esempio SFTPEsempio di evento Connector File Send Failed

L'esempio seguente mostra un evento in cui un SFTP connettore si è guastato durante il tentativo di inviare un file a un SFTP server remoto.

{ "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" } } }
Esempio SFTPEvento di esempio Connector File Retrieve Completed

L'esempio seguente mostra un evento in cui un SFTP connettore ha recuperato con successo un file inviato da un server remotoSFTP.

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