View a markdown version of this page

Gestione Transfer Family eventi utilizzando 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 eventi utilizzando 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. Event-driven l'architettura è 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 di eventi predefinito. EventBridge Tieni presente che il bus di eventi predefinito viene fornito automaticamente in ogni AWS account. Un router di eventi è un router che riceve eventi e li invia a zero o più destinazioni o target. Specificate le regole per il bus di eventi che valuta gli eventi man mano che arrivano. Ogni regola verifica se un evento corrisponde al modello della regola. Se l'evento corrisponde, il bus degli eventi invia l'evento a uno o più obiettivi specificati.

AWS i servizi inviano eventi al bus di eventi EventBridge predefinito. Se l'evento corrisponde al modello di evento di una regola, EventBridge invia l'evento alle destinazioni specificate per quella regola.

Transfer Family eventi

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

Gli eventi che corrispondono allo schema di eventi di una regola vengono consegnati agli obiettivi specificati in modo ottimale o duraturo (tieni presente che alcuni eventi potrebbero essere consegnati fuori servizio). Questi livelli di consegna sono descritti in Livello di consegna per gli eventi AWS di servizio in Amazon EventBridge Events Reference.

  • Server-level gli eventi per i server SFTP, FTPS e FTP vengono erogati nel migliore dei modi.

  • Gli eventi del connettore SFTP vengono erogati su base duratura.

  • Gli eventi AS2 vengono erogati su base duratura.

I seguenti eventi sono generati da Transfer Family. Per ulteriori informazioni, vedere 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 Description

Download del file sul server FTP completato

È stato scaricato con successo un file per il protocollo FTP.

Download del file sul server FTP non riuscito

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

Caricamento del file sul server FTP completato

È stato caricato con successo un file 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.

Download del file del server FTPS completato

È stato scaricato con successo un file per il protocollo FTPS.

Download del file sul server FTPS non riuscito

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

Caricamento del file sul server FTPS completato

È stato caricato con successo un file 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 del server SFTP completato

È stato scaricato con successo un file per il protocollo SFTP.

Download del file del 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 con successo per il protocollo SFTP.

Caricamento del file sul server SFTP non riuscito

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

Altri eventi relativi alle operazioni sui file

Tipo di dettaglio dell'evento Description

Creazione della directory del server FTP completata

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

Creazione della directory del server FTP non riuscita

Il tentativo di creare 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

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

Eliminazione del file del server FTP completata

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

Eliminazione del file dal server FTP non riuscita

Il tentativo di eliminare un file non è riuscito per il protocollo FTP.

Rinomina del file del server FTP completata

Un file è stato rinominato correttamente per il protocollo FTP.

Rinomina del 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

Una directory è stata creata con successo per il protocollo FTPS.

Creazione della directory del server FTPS non riuscita

Il tentativo di creare una directory non è riuscito per il protocollo FTPS.

Eliminazione della directory del server FTPS completata

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

Eliminazione della directory del server FTPS non riuscita

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

Eliminazione del file del server FTPS completata

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

Eliminazione del file dal server FTPS non riuscita

Il tentativo di eliminare un file non è riuscito per il protocollo FTPS.

Rinomina del file del server FTPS completata

Un file è stato rinominato correttamente per il protocollo FTPS.

Rinomina del 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

Una directory è stata creata con successo 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 del file del 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 del file del server SFTP completata

Un file è stato rinominato correttamente per il protocollo SFTP.

Rinomina del 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 duraturo, come descritto in Livello di consegna per gli eventi di AWS servizio in Amazon EventBridge Events Reference.

Tipo di dettaglio dell'evento Description

Invio del file del connettore SFTP completato

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

Invio del file del connettore SFTP non riuscito

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

Recupero file del connettore SFTP completato

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

Recupero file dal connettore SFTP non riuscito

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

Elenco della directory del connettore SFTP completato

Una chiamata all'elenco della directory del file iniziale completata con successo.

Elenco delle directory del connettore SFTP non riuscito

Un elenco di directory del file di avvio che 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

Non è stato possibile spostare o rinominare i file o le directory sul server remoto.

Eliminazione remota del connettore SFTP completata

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

Eliminazione remota del connettore SFTP non riuscita

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

Eventi AS2

Nota

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

Tipo di dettaglio dell'evento Description

Ricezione del payload AS2 completata

Il payload per un messaggio AS2 è stato ricevuto.

Ricezione del payload AS2 non riuscita

Il payload per un messaggio AS2 non è stato ricevuto.

Invio del payload AS2 completato

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

Invio del payload AS2 non riuscito

Il payload per un messaggio AS2 non è stato inviato.

Ricezione MDN AS2 completata

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

Ricezione MDN AS2 non riuscita

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

Invio MDN AS2 completato

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

Invio MDN AS2 non riuscito

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

Invio Transfer Family eventi utilizzando EventBridge rules

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

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

  2. Nel pannello 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 uno schema di eventi, quindi scegli Avanti.

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

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

  7. Nella sezione Event pattern, fornisci le seguenti informazioni.

    1. Per Origine evento, scegli Servizi AWS .

    2. Per l'AWS assistenza, scegli Trasferimento.

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

      A seconda del tipo di evento selezionato, ti potrebbe essere presentata una sezione Specifica del tipo di evento 1.

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

    5. (Facoltativo) Utilizza l'editor dei pattern degli eventi per specificare i filtri per i dettagli degli eventi.

    6. Scegli Avanti.

  8. Scegliete un obiettivo tra le scelte disponibili in Seleziona obiettivi. Scegliete 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 di eventi. È possibile inviare eventi a un altro bus di eventi, nello stesso account e nella stessa area geografica oppure in un account o regione diversi.

      Per istruzioni complete sulla creazione di regole per i bus di eventi, consulta 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 a posto, scegli Crea regola.

Creazione di modelli di eventi per Transfer Family eventi

Quando Transfer Family invia un evento al bus di eventi predefinito, EventBridge utilizza il modello di evento definito per ogni regola per determinare se l'evento deve essere recapitato alle destinazioni della regola. Un pattern di eventi corrisponde ai dati negli Transfer Family eventi desiderati. Ogni pattern di eventi è 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 a cui corrispondere.

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

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

Il seguente esempio di modello di evento 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 modello di evento corrisponde a tutti gli eventi falliti di Transfer Family:

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

Il seguente esempio di modello di evento 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, vedere Modelli di eventi nella Guida per l'EventBridge utente.

Test dei modelli di eventi per Transfer Family eventi in EventBridge

Puoi 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 modello di evento e utilizzare un evento di esempio per confermare che il modello corrisponda agli eventi desiderati. EventBridge offre la possibilità di creare una nuova regola utilizzando quel modello di evento 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 la distribuzione degli eventi. Amazon EventBridge

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

Ulteriori EventBridge risorse

Fai riferimento ai seguenti argomenti nella Guida per l'Amazon EventBridge 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 confrontare gli eventi con le regole, vedi Schemi di eventi.

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

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