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.

Argomenti

• Transfer Family eventi
• Invio di Transfer Family eventi tramite regole EventBridge
• Amazon EventBridge autorizzazioni
• EventBridge Risorse aggiuntive
• Transfer Family riferimento ai dettagli degli eventi

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 consegnati agli obiettivi specificati con il massimo impegno, tuttavia alcuni eventi potrebbero essere consegnati in modo errato.

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

Tipo di dettaglio dell'evento	Descrizione
Download del file server FTP completato	Un file è stato scaricato correttamente per il protocollo FTP.
Scaricamento del file server FTP non riuscito	Un tentativo di scaricare un file non è riuscito per il protocollo FTP.
Caricamento del file server FTP completato	Un file è stato caricato correttamente per il protocollo FTP.
Caricamento del file server FTP non riuscito	Un tentativo di caricamento di un file non è riuscito per il protocollo FTP.
Download del file server FTPS completato	Un file è stato scaricato correttamente per il protocollo FTPS.
Scaricamento del file server FTPS non riuscito	Un tentativo di scaricare un file non è riuscito per il protocollo FTPS.
Caricamento del file server FTPS completato	Un file è stato caricato correttamente per il protocollo FTPS.
Caricamento del file 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.

Eventi del connettore SFTP

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.

Eventi A2S

Tipo di dettaglio dell'evento	Descrizione
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 correttamente.
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 correttamente.
Invio MDN AS2 non riuscito	La notifica di disposizione del messaggio per un messaggio AS2 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.

È possibile creare una regola seguendo questi passaggi generali:

1. Crea un modello di evento per la regola che specifica quanto segue:

   • Transfer Family è l'origine degli eventi valutati dalla regola.

   • (Facoltativo) Qualsiasi altro dato relativo all'evento con cui confrontarlo.

   Per ulteriori informazioni, consulta Creazione di modelli di Transfer Family eventi per eventi.

2. (Facoltativo) Crea un trasformatore di input che personalizzi i dati dell'evento prima di EventBridge inviare le informazioni alla destinazione della regola.

   Per ulteriori informazioni, consulta Input transformation nella Guida per l'EventBridge utente.

3. Specificate gli obiettivi a cui desiderate EventBridge fornire eventi che corrispondano allo schema degli eventi.

   Le destinazioni possono essere altri AWS servizi, applicazioni SaaS (Software as a Service), destinazioni API o altri endpoint personalizzati. Per ulteriori informazioni, consulta la sezione Destinazioni nella Guida per l'utente di EventBridge .

Per istruzioni complete sulla creazione di regole per i bus degli eventi, consulta Creazione di regole che reagiscono agli eventi nella Guida per l'EventBridge utente.

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 il nome utente dell'utente:

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