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 valoreRemoteDirectoryPath
che l'utente ha passato allaStartFileTransfer
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" } } }