Gestione Transfer Family degli eventi tramite Amazon EventBridge - 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à.

Gestione Transfer Family degli eventi tramite Amazon EventBridge

Amazon EventBridge è un servizio serverless che utilizza gli eventi per connettere tra loro i componenti dell'applicazione, il che può semplificare la creazione di applicazioni scalabili basate sugli eventi. L'architettura basata sugli eventi è uno stile di creazione di sistemi software liberamente accoppiati che interagiscono emettendo e rispondendo agli eventi. Gli eventi rappresentano un cambiamento in una risorsa o in un ambiente.

Come molti AWS servizi, Transfer Family genera e invia eventi al bus eventi EventBridge predefinito. Tieni presente che il bus degli eventi predefinito viene fornito automaticamente in ogni AWS account. Un router di eventi è un router che riceve eventi e li invia a nessuna o a più destinazioni o target. Si specificano le regole per il bus degli eventi che valuta gli eventi man mano che arrivano. Ogni regola verifica se un evento corrisponde al modello di eventi della regola. Se l'evento corrisponde, il bus degli eventi invia l'evento a uno o più obiettivi specificati.

AWS i servizi inviano gli eventi al bus di eventi EventBridge predefinito. Se l'evento corrisponde al modello di evento di una regola, EventBridge invia l'evento ai target specificati per quella regola.

Transfer Family eventi

Transfer Family invia automaticamente gli eventi al bus EventBridge eventi predefinito. È possibile creare regole sul bus degli eventi in cui ogni regola include un modello di eventi e uno o più obiettivi.

Gli eventi che corrispondono allo schema di eventi di una regola vengono distribuiti agli obiettivi specificati con il massimo impegno possibile o su base duratura (si noti che alcuni eventi potrebbero essere distribuiti in modo errato). Questi livelli di consegna sono descritti nella sezione Livello di consegna per gli eventi AWS di servizio in Amazon EventBridge Events Reference.

  • Gli eventi a livello di server per i server SFTP, FTPS e FTP vengono forniti con la massima diligenza possibile.

  • Gli eventi del connettore SFTP vengono forniti in modo duraturo.

  • Gli AS2 eventi vengono erogati in modo duraturo.

I seguenti eventi sono generati da Transfer Family. Per ulteriori informazioni, consulta EventBridge gli eventi nella Guida Amazon EventBridge per l'utente.

Eventi dei server SFTP, FTPS e FTP

Le tabelle seguenti elencano gli eventi per i server SFTP, FTPS e FTP, organizzati per tipo di evento.

Eventi di caricamento e download di file

Tipo di dettaglio dell'evento Descrizione

Scaricamento del file dal server FTP completato

Un file è stato scaricato correttamente per il protocollo FTP.

Scaricamento del file dal server FTP non riuscito

Un tentativo di scaricare un file non è riuscito per il protocollo FTP.

Caricamento del file sul server FTP completato

Un file è stato caricato correttamente per il protocollo FTP.

Caricamento del file sul server FTP non riuscito

Un tentativo di caricamento di un file non è riuscito per il protocollo FTP.

Scaricamento del file dal server FTPS completato

Un file è stato scaricato correttamente per il protocollo FTPS.

Scaricamento del file dal server FTPS non riuscito

Un tentativo di scaricare un file non è riuscito per il protocollo FTPS.

Caricamento del file sul server FTPS completato

Un file è stato caricato correttamente per il protocollo FTPS.

Caricamento del file sul server FTPS non riuscito

Un tentativo di caricamento di un file non è riuscito per il protocollo FTPS.

Download del file dal server SFTP completato

Un file è stato scaricato correttamente per il protocollo SFTP.

Scaricamento del file dal server SFTP non riuscito

Un tentativo di scaricare un file non è riuscito per il protocollo SFTP.

Caricamento del file sul server SFTP completato

Un file è stato caricato correttamente per il protocollo SFTP.

Caricamento del file sul server SFTP non riuscito

Un tentativo di caricamento di un file non è riuscito per il protocollo SFTP.

Altri eventi relativi alle operazioni sui file

Tipo di dettaglio dell'evento Descrizione

Creazione della directory del server FTP completata

È stata creata correttamente una directory per il protocollo FTP.

Creazione della directory del server FTP non riuscita

Tentativo di creazione di una directory non riuscito per il protocollo FTP.

Eliminazione della directory del server FTP completata

Una directory è stata eliminata con successo per il protocollo FTP.

Eliminazione della directory del server FTP non riuscita

Un tentativo di eliminare una directory non è riuscito per il protocollo FTP.

Eliminazione del file dal server FTP completata

Un file è stato eliminato con successo per il protocollo FTP.

Eliminazione del file dal server FTP non riuscita

Tentativo di eliminazione di un file non riuscito per il protocollo FTP.

Rinomina file del server FTP completata

Un file è stato rinominato correttamente per il protocollo FTP.

Rinomina file del server FTP non riuscita

Un tentativo di rinominare un file non è riuscito per il protocollo FTP.

Creazione della directory del server FTPS completata

È stata creata correttamente una directory per il protocollo FTPS.

Creazione della directory del server FTPS non riuscita

Tentativo di creazione di una directory non riuscito per il protocollo FTPS.

Eliminazione della directory del server FTPS completata

Una directory è stata eliminata correttamente per il protocollo FTPS.

Eliminazione della directory del server FTPS non riuscita

Un tentativo di eliminare una directory non è riuscito per il protocollo FTPS.

Eliminazione del file dal server FTPS completata

Un file è stato eliminato con successo per il protocollo FTPS.

Eliminazione del file dal server FTPS non riuscita

Tentativo di eliminazione di un file non riuscito per il protocollo FTPS.

Rinomina file del server FTPS completata

Un file è stato rinominato correttamente per il protocollo FTPS.

Rinomina file del server FTPS non riuscita

Un tentativo di rinominare un file non è riuscito per il protocollo FTPS.

Creazione della directory del server SFTP completata

È stata creata correttamente una directory per il protocollo SFTP.

Creazione della directory del server SFTP non riuscita

Un tentativo di creare una directory non è riuscito per il protocollo SFTP.

Eliminazione della directory del server SFTP completata

Una directory è stata eliminata con successo per il protocollo SFTP.

Eliminazione della directory del server SFTP non riuscita

Un tentativo di eliminare una directory non è riuscito per il protocollo SFTP.

Eliminazione dei file dal server SFTP completata

Un file è stato eliminato con successo per il protocollo SFTP.

Eliminazione del file dal server SFTP non riuscita

Un tentativo di eliminare un file non è riuscito per il protocollo SFTP.

Rinomina file del server SFTP completata

Un file è stato rinominato correttamente per il protocollo SFTP.

Rinomina file del server SFTP non riuscita

Un tentativo di rinominare un file non è riuscito per il protocollo SFTP.

Eventi del connettore SFTP

Nota

Questi eventi vengono erogati a un EventBridge livello durevole, come descritto nella sezione Livello di consegna per gli eventi AWS di servizio in Amazon EventBridge Events Reference.

Tipo di dettaglio dell'evento Descrizione

Invio del file del connettore SFTP completato

Il trasferimento di file da un connettore a un server SFTP remoto è stato completato correttamente.

Invio del file del connettore SFTP non riuscito

Un trasferimento di file da un connettore a un server SFTP remoto non è riuscito.

Recupero dei file del connettore SFTP completato

Il trasferimento di file da un server SFTP remoto a un connettore è stato completato correttamente.

Recupero del file del connettore SFTP non riuscito

Un trasferimento di file da un server SFTP remoto a un connettore non è riuscito.

Elenco delle directory dei connettori SFTP completato

Una chiamata di avvio dell'elenco delle directory dei file completata con successo.

Elenco delle directory dei connettori SFTP non riuscito

Un elenco di directory di file di avvio non riuscito.

Spostamento remoto del connettore SFTP completato

I file o le directory sono stati spostati o rinominati correttamente sul server remoto.

Spostamento remoto del connettore SFTP non riuscito

Impossibile spostare o rinominare file o directory sul server remoto.

Eliminazione remota del connettore SFTP completata

I file o le directory sono stati eliminati correttamente sul server remoto.

Eliminazione remota del connettore SFTP non riuscita

Impossibile eliminare file o directory sul server remoto.

AS2 eventi

Nota

Questi eventi vengono erogati a un EventBridge livello durevole, come descritto nella sezione Livello di consegna per gli eventi AWS di servizio in Amazon EventBridge Events Reference.

Tipo di dettaglio dell'evento Descrizione

AS2 Ricezione del payload completata

Il payload per un AS2 messaggio è stato ricevuto.

AS2 Ricezione del payload non riuscita

Il payload di un AS2 messaggio non è stato ricevuto.

AS2 Payload (invio completato)

Il payload per un AS2 messaggio è stato inviato con successo.

AS2 Invio del payload non riuscito

Il payload di un AS2 messaggio non è stato inviato.

AS2 Ricezione MDN completata

La notifica di disposizione del messaggio relativa a un AS2 messaggio è stata ricevuta.

AS2 Ricezione MDN non riuscita

La notifica di disposizione del messaggio relativa a un AS2 messaggio non è stata ricevuta.

AS2 Invio MDN completato

La notifica di disposizione del messaggio per un AS2 messaggio è stata inviata con successo.

AS2 Invio MDN non riuscito

La notifica di disposizione del AS2 messaggio non è stata inviata.

Invio di Transfer Family eventi tramite regole EventBridge

Se si desidera che il bus degli eventi EventBridge predefinito invii Transfer Family eventi a una destinazione, è necessario creare una regola che contenga uno schema di eventi che corrisponda ai dati degli Transfer Family eventi desiderati.

Per registrare AWS Transfer Family eventi in Amazon EventBridge
  1. Accedi a AWS Management Console e apri la EventBridge console Amazon all'indirizzo https://console.aws.amazon.com/events/.

  2. Nel riquadro di navigazione, scegli Regole, quindi scegli Crea regola.

  3. Inserisci un nome descrittivo per la regola e, facoltativamente, inserisci una descrizione.

  4. Per Tipo di regola, seleziona Regola con un modello di evento, quindi scegli Avanti.

  5. Nella sezione Origine dell'evento, seleziona AWS eventi o eventi EventBridge partner.

  6. Nella sezione Metodo di creazione, scegli Usa modulo modello.

  7. Nella sezione Schema di eventi, fornisci le seguenti informazioni.

    1. Per Origine evento, scegli Servizi AWS .

    2. Per AWS assistenza, scegliete Trasferimento.

    3. Per Tipo di evento, scegli il tipo di evento Transfer Family che desideri attivare la regola.

      A seconda del tipo di evento selezionato, è possibile che venga visualizzata la sezione Specificazione del tipo di evento 1.

    4. Se vedi la sezione Specificazione del tipo di evento 1, seleziona gli eventi specifici che desideri acquisire (oppure seleziona Qualsiasi evento per acquisire tutti gli eventi per il tipo di evento selezionato).

    5. (Facoltativo) Utilizzate l'editor del modello di evento per specificare i filtri per i dettagli degli eventi.

    6. Scegli Next (Successivo).

  8. Scegliete un obiettivo tra le scelte disponibili in Seleziona obiettivi. Scegli tra i seguenti obiettivi disponibili.

    • AWS servizio. Le opzioni più comuni sono le funzioni Lambda per l'elaborazione senza server, le code Amazon SQS per l'elaborazione dei messaggi, gli argomenti di Amazon SNS per le notifiche e per l'orchestrazione dei flussi di lavoro. AWS Step Functions

    • EventBridge Destinazione API. Se desideri inviare eventi a un endpoint HTTP esterno a AWS, puoi utilizzare una destinazione API come destinazione.

    • EventBridge bus per eventi. Puoi inviare eventi a un altro bus di eventi, nello stesso account e nella stessa regione o in un account o regione diversi.

      Per istruzioni complete sulla creazione di regole per i bus degli eventi, consulta la sezione Creazione di regole che reagiscono agli eventi nella Amazon EventBridge User Guide.

    Per assistenza nella selezione di un obiettivo, consulta Select targets nella Amazon EventBridge User Guide.

  9. Configura eventuali opzioni aggiuntive per il tuo obiettivo, quindi scegli Avanti.

  10. (Facoltativo) Aggiungi tag alla regola e scegli Avanti.

  11. Nella schermata Rivedi e crea, se tutto sembra corretto, scegli Crea regola.

Creazione di modelli di Transfer Family eventi per eventi

Quando Transfer Family invia un evento al bus di eventi predefinito, EventBridge utilizza il modello di eventi definito per ogni regola per determinare se l'evento deve essere distribuito agli obiettivi della regola. Un modello di eventi corrisponde ai dati negli Transfer Family eventi desiderati. Ogni modello di evento è un oggetto JSON che contiene quanto segue:

  • Un attributo source che identifica il servizio che invia l'evento. Per Transfer Family gli eventi, la fonte èaws.transfer.

  • (Facoltativo) Un detail-type attributo che contiene una matrice dei tipi di eventi da abbinare.

  • (Facoltativo) Un detail attributo contenente qualsiasi altro dato relativo all'evento su cui effettuare la corrispondenza.

Ad esempio, il seguente schema di eventi corrisponde a tutti gli eventi di Transfer Family:

{ "source": ["aws.transfer"] }

Il seguente esempio di pattern di eventi corrisponde a tutti gli eventi del connettore SFTP:

{ "source": ["aws.transfer"], "detail-type": ["SFTP Connector File Send Completed", "SFTP Connector File Retrieve Completed", "SFTP Connector File Retrieve Failed", "SFTP Connector File Send Failed"] }

Il seguente esempio di pattern di eventi corrisponde a tutti gli eventi non riusciti di Transfer Family:

{ "source": ["aws.transfer"], "detail-type": [{"wildcard", "*Failed"}] }

Il seguente esempio di pattern di eventi corrisponde ai download SFTP riusciti per l'utenteusername:

{ "source": ["aws.transfer"], "detail-type": ["SFTP Server File Download Completed"], "detail": { "username": [username] } }

Per ulteriori informazioni sulla scrittura di modelli di eventi, consultate Event pattern nella Guida per l'EventBridge utente.

Test dei modelli di Transfer Family eventi per gli eventi in EventBridge

È possibile utilizzare EventBridge Sandbox per definire e testare rapidamente un modello di evento, senza dover completare il processo più ampio di creazione o modifica di una regola. Utilizzando la Sandbox, è possibile definire un pattern di eventi e utilizzare un evento di esempio per confermare che il pattern corrisponda agli eventi desiderati. EventBridge offre la possibilità di creare una nuova regola utilizzando quel pattern di eventi direttamente dalla sandbox.

Per ulteriori informazioni, consulta Testare un pattern di eventi utilizzando la EventBridge sandbox nella Guida per l'EventBridge utente.

Amazon EventBridge autorizzazioni

Transfer Family non richiede autorizzazioni aggiuntive per l'invio di eventi. Amazon EventBridge

Le destinazioni specificate potrebbero richiedere autorizzazioni o configurazioni specifiche. Per maggiori dettagli sull'utilizzo di servizi specifici per le destinazioni, consulta Amazon EventBridge gli obiettivi nella Guida per l'Amazon EventBridge utente.

EventBridge Risorse aggiuntive

Fate riferimento ai seguenti argomenti della Guida per Amazon EventBridge l'utente per ulteriori informazioni su come utilizzare EventBridge per elaborare e gestire gli eventi.

  • Per informazioni dettagliate sul funzionamento degli event bus, consulta Amazon EventBridge Event Bus.

  • Per informazioni sulla struttura degli eventi, consulta Eventi.

  • Per informazioni sulla creazione di modelli di eventi EventBridge da utilizzare per abbinare gli eventi alle regole, consulta Modelli di eventi.

  • Per informazioni sulla creazione di regole per specificare quali eventi vengono EventBridge elaborati, consulta Regole.

  • Per informazioni su come specificare i servizi o le altre destinazioni a cui EventBridge inviare gli eventi corrispondenti, consulta Target.