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.](https://docs.aws.amazon.com/it_it/transfer/latest/userguide/images/eventbridge-integration-how-it-works.png) **Topics** + [Transfer Family eventi](#supported-events) + [Invio Transfer Family eventi utilizzando EventBridge rules](#eventbridge-using-events-rules) + [Amazon EventBridge autorizzazioni](#eventbridge-permissions) + [Ulteriori EventBridge risorse](#eventbridge-additonal-resources) + [Transfer Family dettagli di riferimento sugli eventi](events-detail-reference.md) ## 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 ](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) 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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) 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 ](events-detail-reference.md#event-detail-server-events) | È stato scaricato con successo un file per il protocollo FTP. | | [Download del file sul server FTP non riuscito ](events-detail-reference.md#event-detail-server-events) | Il tentativo di scaricare un file non è riuscito per il protocollo FTP. | | [Caricamento del file sul server FTP completato ](events-detail-reference.md#event-detail-server-events) | È stato caricato con successo un file per il protocollo FTP. | | [Caricamento del file sul server FTP non riuscito ](events-detail-reference.md#event-detail-server-events) | Un tentativo di caricamento di un file non è riuscito per il protocollo FTP. | | [Download del file del server FTPS completato ](events-detail-reference.md#event-detail-server-events) | È stato scaricato con successo un file per il protocollo FTPS. | | [Download del file sul server FTPS non riuscito ](events-detail-reference.md#event-detail-server-events) | Il tentativo di scaricare un file non è riuscito per il protocollo FTPS. | | [Caricamento del file sul server FTPS completato ](events-detail-reference.md#event-detail-server-events) | È stato caricato con successo un file per il protocollo FTPS. | | [Caricamento del file sul server FTPS non riuscito ](events-detail-reference.md#event-detail-server-events) | Un tentativo di caricamento di un file non è riuscito per il protocollo FTPS. | | [Download del file del server SFTP completato ](events-detail-reference.md#event-detail-server-events) | È stato scaricato con successo un file per il protocollo SFTP. | | [Download del file del server SFTP non riuscito ](events-detail-reference.md#event-detail-server-events) | Un tentativo di scaricare un file non è riuscito per il protocollo SFTP. | | [Caricamento del file sul server SFTP completato ](events-detail-reference.md#event-detail-server-events) | Un file è stato caricato con successo per il protocollo SFTP. | | [Caricamento del file sul server SFTP non riuscito ](events-detail-reference.md#event-detail-server-events) | 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 ](events-detail-reference.md#event-detail-server-events) | Una directory è stata creata con successo per il protocollo FTP. | | [Creazione della directory del server FTP non riuscita ](events-detail-reference.md#event-detail-server-events) | Il tentativo di creare una directory non è riuscito per il protocollo FTP. | | [Eliminazione della directory del server FTP completata ](events-detail-reference.md#event-detail-server-events) | Una directory è stata eliminata con successo per il protocollo FTP. | | [Eliminazione della directory del server FTP non riuscita ](events-detail-reference.md#event-detail-server-events) | Il tentativo di eliminare una directory non è riuscito per il protocollo FTP. | | [Eliminazione del file del server FTP completata ](events-detail-reference.md#event-detail-server-events) | Un file è stato eliminato con successo per il protocollo FTP. | | [Eliminazione del file dal server FTP non riuscita ](events-detail-reference.md#event-detail-server-events) | Il tentativo di eliminare un file non è riuscito per il protocollo FTP. | | [Rinomina del file del server FTP completata ](events-detail-reference.md#event-detail-server-events) | Un file è stato rinominato correttamente per il protocollo FTP. | | [Rinomina del file del server FTP non riuscita ](events-detail-reference.md#event-detail-server-events) | Un tentativo di rinominare un file non è riuscito per il protocollo FTP. | | [Creazione della directory del server FTPS completata ](events-detail-reference.md#event-detail-server-events) | Una directory è stata creata con successo per il protocollo FTPS. | | [Creazione della directory del server FTPS non riuscita ](events-detail-reference.md#event-detail-server-events) | Il tentativo di creare una directory non è riuscito per il protocollo FTPS. | | [Eliminazione della directory del server FTPS completata ](events-detail-reference.md#event-detail-server-events) | Una directory è stata eliminata con successo per il protocollo FTPS. | | [Eliminazione della directory del server FTPS non riuscita ](events-detail-reference.md#event-detail-server-events) | Il tentativo di eliminare una directory non è riuscito per il protocollo FTPS. | | [Eliminazione del file del server FTPS completata ](events-detail-reference.md#event-detail-server-events) | Un file è stato eliminato con successo per il protocollo FTPS. | | [Eliminazione del file dal server FTPS non riuscita ](events-detail-reference.md#event-detail-server-events) | Il tentativo di eliminare un file non è riuscito per il protocollo FTPS. | | [Rinomina del file del server FTPS completata ](events-detail-reference.md#event-detail-server-events) | Un file è stato rinominato correttamente per il protocollo FTPS. | | [Rinomina del file del server FTPS non riuscita ](events-detail-reference.md#event-detail-server-events) | Un tentativo di rinominare un file non è riuscito per il protocollo FTPS. | | [Creazione della directory del server SFTP completata ](events-detail-reference.md#event-detail-server-events) | Una directory è stata creata con successo per il protocollo SFTP. | | [Creazione della directory del server SFTP non riuscita ](events-detail-reference.md#event-detail-server-events) | Un tentativo di creare una directory non è riuscito per il protocollo SFTP. | | [Eliminazione della directory del server SFTP completata ](events-detail-reference.md#event-detail-server-events) | Una directory è stata eliminata con successo per il protocollo SFTP. | | [Eliminazione della directory del server SFTP non riuscita ](events-detail-reference.md#event-detail-server-events) | Un tentativo di eliminare una directory non è riuscito per il protocollo SFTP. | | [Eliminazione del file del server SFTP completata ](events-detail-reference.md#event-detail-server-events) | Un file è stato eliminato con successo per il protocollo SFTP. | | [Eliminazione del file dal server SFTP non riuscita ](events-detail-reference.md#event-detail-server-events) | Un tentativo di eliminare un file non è riuscito per il protocollo SFTP. | | [Rinomina del file del server SFTP completata ](events-detail-reference.md#event-detail-server-events) | Un file è stato rinominato correttamente per il protocollo SFTP. | | [Rinomina del file del server SFTP non riuscita ](events-detail-reference.md#event-detail-server-events) | 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 ](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) in * Amazon EventBridge Events Reference*. | Tipo di dettaglio dell'evento | Description | | --- | --- | | [Invio del file del connettore SFTP completato ](events-detail-reference.md#event-detail-sftp-connector-events) | Il trasferimento di file da un connettore a un server SFTP remoto è stato completato con successo. | | [Invio del file del connettore SFTP non riuscito ](events-detail-reference.md#event-detail-sftp-connector-events) | Il trasferimento di file da un connettore a un server SFTP remoto non è riuscito. | | [Recupero file del connettore SFTP completato ](events-detail-reference.md#event-detail-sftp-connector-events) | Il trasferimento di file da un server SFTP remoto a un connettore è stato completato con successo. | | [Recupero file dal connettore SFTP non riuscito ](events-detail-reference.md#event-detail-sftp-connector-events) | Il trasferimento di file da un server SFTP remoto a un connettore non è riuscito. | | [Elenco della directory del connettore SFTP completato ](events-detail-reference.md#event-detail-sftp-connector-events) | Una chiamata all'elenco della directory del file iniziale completata con successo. | | [Elenco delle directory del connettore SFTP non riuscito ](events-detail-reference.md#event-detail-sftp-connector-events) | Un elenco di directory del file di avvio che non è riuscito. | | [Spostamento remoto del connettore SFTP completato ](events-detail-reference.md#event-detail-sftp-connector-events) | I file o le directory sono stati spostati o rinominati correttamente sul server remoto. | | [Spostamento remoto del connettore SFTP non riuscito ](events-detail-reference.md#event-detail-sftp-connector-events) | Non è stato possibile spostare o rinominare i file o le directory sul server remoto. | | [Eliminazione remota del connettore SFTP completata ](events-detail-reference.md#event-detail-sftp-connector-events) | I file o le directory sono stati eliminati con successo sul server remoto. | | [Eliminazione remota del connettore SFTP non riuscita ](events-detail-reference.md#event-detail-sftp-connector-events) | 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 ](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) in * Amazon EventBridge Events Reference*. | Tipo di dettaglio dell'evento | Description | | --- | --- | | [Ricezione del payload AS2 completata ](events-detail-reference.md#event-detail-as2-server-events) | Il payload per un messaggio AS2 è stato ricevuto. | | [Ricezione del payload AS2 non riuscita ](events-detail-reference.md#event-detail-as2-server-events) | Il payload per un messaggio AS2 non è stato ricevuto. | | [Invio del payload AS2 completato ](events-detail-reference.md#event-detail-as2-server-events) | Il payload per un messaggio AS2 è stato inviato con successo. | | [Invio del payload AS2 non riuscito ](events-detail-reference.md#event-detail-as2-server-events) | Il payload per un messaggio AS2 non è stato inviato. | | [Ricezione MDN AS2 completata ](events-detail-reference.md#event-detail-as2-server-events) | La notifica di disposizione del messaggio per un messaggio AS2 è stata ricevuta. | | [Ricezione MDN AS2 non riuscita ](events-detail-reference.md#event-detail-as2-server-events) | La notifica di disposizione del messaggio per un messaggio AS2 non è stata ricevuta. | | [Invio MDN AS2 completato ](events-detail-reference.md#event-detail-as2-server-events) | La notifica di disposizione del messaggio per un messaggio AS2 è stata inviata con successo. | | [Invio MDN AS2 non riuscito ](events-detail-reference.md#event-detail-as2-server-events) | 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/](https://console.aws.amazon.com/events/). 1. Nel pannello di navigazione, scegli ** Regole**, quindi scegli ** Crea regola**. 1. Inserisci un nome descrittivo per la regola e, facoltativamente, inserisci una descrizione. 1. Per Tipo di ** regola**, seleziona ** Regola con uno schema di eventi, ** quindi scegli Avanti. ** ** 1. Nella ** sezione Origine ** dell'evento, seleziona **AWS eventi o eventi EventBridge partner**. 1. Nella ** sezione Metodo ** di creazione, scegli ** Usa il modulo del modello**. 1. Nella ** sezione ** Event pattern, fornisci le seguenti informazioni. 1. Per **Origine evento**, scegli **Servizi AWS **. 1. Per l'**AWS assistenza**, scegli ** Trasferimento**. 1. 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. 1. 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). 1. (Facoltativo) Utilizza l'**editor dei pattern ** degli eventi per specificare i filtri per i dettagli degli eventi. 1. Scegli **Avanti**. 1. 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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) nella * Amazon EventBridge User Guide*. Per assistenza nella selezione di un obiettivo, consulta [ Select targets ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html#eb-create-rule-target) nella * Amazon EventBridge User Guide*. 1. Configura eventuali opzioni aggiuntive per il tuo obiettivo, quindi scegli ** Avanti**. 1. (Facoltativo) Aggiungi tag alla regola e scegli ** Avanti**. 1. 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'utente{{username}}: ``` { "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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) 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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-pattern-sandbox.html) 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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) nella Guida * per l'*Amazon EventBridge utente. ## Ulteriori EventBridge risorse Fai riferimento ai seguenti argomenti nella Guida * [ per l'](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)*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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html). + Per informazioni sulla struttura degli eventi, consulta [ Eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html). + Per informazioni sulla creazione di modelli di eventi EventBridge da utilizzare per confrontare gli eventi con le regole, vedi Schemi [ di ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) eventi. + Per informazioni sulla creazione di regole per specificare quali eventi vengono EventBridge elaborati, vedi [ Regole](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html). + Per informazioni su come specificare i servizi o le altre destinazioni a cui EventBridge inviare gli eventi corrispondenti, consulta [ Target](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html).