Creazione di regole Amazon EventBridge che reagiscono agli eventi - Amazon EventBridge
Creazione di una regola che reagisce agli eventi

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à.

Creazione di regole Amazon EventBridge che reagiscono agli eventi

Per intraprendere azioni in relazione agli eventi ricevuti da Amazon EventBridge, puoi creare delle regole. Quando un evento corrisponde al modello di eventi definito nella regola, EventBridge invia l'evento alla destinazione specificata e attiva l'azione definita nella regola.

Nel video seguente viene illustrato come creare e verificare differenti tipi di regole:

Creazione di una regola che reagisce agli eventi

I passaggi seguenti forniscono procedure dettagliate su come creare una regola che EventBridge utilizza per trovare eventi corrispondenti tra quelli inviati al router di eventi specificato.

Definizione della regola

Innanzitutto, immetti un nome e una descrizione per la regola in modo da identificarla. Devi inoltre definire il router di eventi in cui la regola cerca eventi corrispondenti a un modello di eventi.

Per definire i dettagli della regola

  1. Aprire la console Amazon EventBridge all'indirizzo https://console.aws.amazon.com/events/.

  2. Nel pannello di navigazione, scegliere Rules (Regole).

  3. Scegli Create rule (Crea regola).

  4. Immetti un nome ed eventualmente una descrizione per la regola rispettivamente in Nome e Descrizione.

    Una regola non può avere lo stesso nome di un'altra regola nella stessa Regione AWS e sullo stesso bus di eventi.

  5. In Router di eventi, scegli il router di eventi da associare alla regola. Se la regola deve cercare eventi corrispondenti provenienti dal tuo account, seleziona Bus di eventi predefiniti di AWS. Quando un Servizio AWS nell'account emette un evento, passa sempre al bus di eventi predefinito dell'account.

  6. Per Rule type (Tipo di regola), scegli Rule with an event pattern (Regola con un modello di eventi).

  7. Scegli Successivo.

Creazione di un modello di eventi

Ora è necessario creare il modello di eventi. A tale scopo, specifica l'origine dell'evento, scegli la base per il modello di eventi e definisci gli attributi e i valori su cui basare la corrispondenza. Puoi anche generare il modello di eventi in JSON e verificarlo utilizzando un evento di esempio.

Per creare il modello di eventi

  1. In Origine evento, scegli Eventi AWS o eventi partner EventBridge.

  2. (Facoltativo) Nella sezione Eventi di esempio, in Tipo evento di esempio, scegli un tipo di evento di esempio in base al quale verificare il modello di eventi.

    Sono disponibili i seguenti tipi di evento di esempio:

    • Eventi AWS: seleziona uno degli eventi emessi dai Servizi AWS supportati.

    • Eventi partner EventBridge: seleziona uno degli eventi emessi da servizi di terze parti che supportano EventBridge, come Salesforce.

    • Inserisci il mio: immetti il tuo evento in testo JSON.

      Puoi anche utilizzare un evento partner o AWS come riferimento per la creazione di un evento personalizzato.

      1. Seleziona Eventi AWS o Eventi partner EventBridge.

      2. Nell'elenco a discesa Eventi di esempio, seleziona l'evento da utilizzare come riferimento per l'evento personalizzato.

        EventBridge visualizza l'evento di esempio.

      3. Seleziona Copia.

      4. Seleziona Inserisci il mio in Tipo di evento.

      5. Nel riquadro di modifica JSON, elimina la struttura dell'evento di esempio e al suo posto incolla l'evento partner o AWS.

      6. Modifica il testo JSON dell'evento per creare il tuo evento di esempio.

  3. In Metodo di creazione, scegli un metodo di creazione. Puoi creare un modello di eventi da uno schema o un modello EventBridge oppure creare un modello di eventi personalizzato.

    Existing schema

    Per creare il modello di eventi utilizzando uno schema Eventbridge esistente, procedi come segue:

    1. Nella sezione Metodo di creazione, in Metodo, seleziona Utilizza schema.

    2. Nella sezione Modello di eventi, in Tipo di schema, seleziona Seleziona lo schema dal registro schemi.

    3. In Registro dello schema, scegli la casella a discesa e immetti il nome di un registro, ad esempio aws.events. Puoi anche selezionare un'opzione dall'elenco a discesa visualizzato.

    4. In Schema, scegli la casella a discesa e immetti il nome dello schema da utilizzare. Ad esempio, aws.s3@ObjectDeleted. Puoi anche selezionare un'opzione dall'elenco a discesa visualizzato.

    5. Nella sezione Modelli, scegli il pulsante Modifica accanto a qualsiasi attributo per visualizzarne le proprietà. Imposta i campi Relazione e Valore come necessario, quindi scegli Imposta per salvare l'attributo.

      Nota

      Per informazioni sulla definizione di un attributo, scegli l'icona Informazioni accanto al nome dell'attributo. Per informazioni di riferimento su come impostare le proprietà degli attributi nell'evento, apri la sezione Nota della finestra di dialogo delle proprietà degli attributi.

      Per eliminare le proprietà di un attributo, scegli il pulsante Modifica accanto a quell'attributo, quindi scegli Cancella.

    6. Scegli Genera un modello di eventi in JSON per generare e convalidare il modello di eventi come testo JSON.

    7. (Facoltativo) Per testare l'evento di esempio in base al tuo modello di test, scegli Modello di test.

      EventBridge visualizza una finestra di messaggio che indica se l'evento di esempio corrisponde al modello di eventi.

      È anche possibile scegliere una delle seguenti opzioni:

      • Copia: copia il modello di eventi negli appunti del dispositivo.

      • Abbellisci (Prettify): semplifica la lettura del testo JSON aggiungendo interruzioni di riga, tabulazioni e spazi.

    Custom schema

    Per scrivere uno schema personalizzato e convertirlo in un modello di eventi, procedi come segue:

    1. Nella sezione Metodo di creazione, in Metodo, scegli Utilizza schema.

    2. Nella sezione Modello di eventi, in Tipo di schema, scegli Inserisci schema.

    3. Immetti lo schema nella casella di testo. Devi formattarlo come testo JSON valido.

    4. Nella sezione Modelli, scegli il pulsante Modifica accanto a qualsiasi attributo per visualizzarne le proprietà. Imposta i campi Relazione e Valore come necessario, quindi scegli Imposta per salvare l'attributo.

      Nota

      Per informazioni sulla definizione di un attributo, scegli l'icona Informazioni accanto al nome dell'attributo. Per informazioni di riferimento su come impostare le proprietà degli attributi nell'evento, apri la sezione Nota della finestra di dialogo delle proprietà degli attributi.

      Per eliminare le proprietà di un attributo, scegli il pulsante Modifica accanto a quell'attributo, quindi scegli Cancella.

    5. Scegli Genera un modello di eventi in JSON per generare e convalidare il modello di eventi come testo JSON.

    6. (Facoltativo) Per testare l'evento di esempio in base al tuo modello di test, scegli Modello di test.

      EventBridge visualizza una finestra di messaggio che indica se l'evento di esempio corrisponde al modello di eventi.

      È anche possibile scegliere una delle seguenti opzioni:

      • Copia: copia il modello di eventi negli appunti del dispositivo.

      • Abbellisci (Prettify): semplifica la lettura del testo JSON aggiungendo interruzioni di riga, tabulazioni e spazi.

    Event pattern

    Per scrivere un modello di eventi personalizzato in formato JSON, procedi come segue:

    1. Nella sezione Metodo di creazione, in Metodo, scegli Modello personalizzato (editor JSON).

    2. In Modello di eventi, immetti il modello di eventi personalizzato in testo in formato JSON.

    3. (Facoltativo) Per testare l'evento di esempio in base al tuo modello di test, scegli Modello di test.

      EventBridge visualizza una finestra di messaggio che indica se l'evento di esempio corrisponde al modello di eventi.

      È anche possibile scegliere una delle seguenti opzioni:

      • Copia: copia il modello di eventi negli appunti del dispositivo.

      • Abbellisci (Prettify): semplifica la lettura del testo JSON aggiungendo interruzioni di riga, tabulazioni e spazi.

      • Modulo del modello di eventi: apre il modello di eventi in Generatore di modello. Se non è possibile eseguire il rendering del modello in Generatore di modelli così com'è, EventBridge ti avvisa prima di aprire Generatore di modelli.

  4. Scegli Successivo.

Selezionare le destinazioni

Scegli una o più destinazioni per ricevere eventi che corrispondono al modello specificato. Le destinazioni possono includere un router di eventi EventBridge, destinazioni API di EventBridge, inclusi partner SaaS come Salesforce, o un altro Servizio AWS.

Per selezionare le destinazioni

  1. In Tipi di destinazione, scegli uno dei seguenti tipi di destinazione:

    Event bus

    Per selezionare un router di eventi EventBridge, seleziona Bus di eventi EventBridge, quindi procedi come segue:

    API destination

    Per utilizzare una destinazione API di EventBridge, seleziona Destinazione API di EventBridge, quindi esegui una delle seguenti operazioni:

    • Per utilizzare una destinazione API esistente, seleziona Utilizza una destinazione API esistente. Quindi seleziona una destinazione API dall'elenco a discesa.

    • Per creare una nuova destinazione API, seleziona Crea una nuova destinazione API. Fornisci quindi i seguenti dettagli per la destinazione:

      • Nome: immetti un nome per la destinazione.

        I nomi devono essere univoci nel tuo Account AWS. I nomi possono avere fino a 64 caratteri. I caratteri validi sono A-Z, a-z, 0-9 e . _ - (trattino).

      • (Facoltativo) Descrizione: immetti una descrizione per la destinazione.

        La descrizione può avere un massimo di 512 caratteri.

      • Endpoint di destinazione API: l'endpoint URL per la destinazione.

        L'URL dell'endpoint deve iniziare con https. Puoi includere il carattere jolly * come parametro di percorso. Puoi impostare i parametri di percorso dall'attributo HttpParameters della destinazione.

      • Metodo HTTP: seleziona il metodo HTTP utilizzato quando richiami l'endpoint.

      • (Facoltativo) Limite di velocità di invocazione al secondo: immetti il numero massimo di invocazioni accettate al secondo per la destinazione.

        Questo valore deve essere maggiore di zero. Per impostazione predefinita, è 300.

      • Connessione: scegli questa opzione per utilizzare una connessione nuova o esistente:

        • Per utilizzare una connessione esistente, seleziona Utilizza una connessione esistente e seleziona la connessione dall'elenco a discesa.

        • Per creare una nuova connessione per questa destinazione, seleziona Crea una nuova connessione, quindi definisci Nome, Tipo di destinazione e Tipo di autorizzazione della connessione. Eventualmente, puoi anche aggiungere una Descrizione per la connessione.

    Per ulteriori informazioni, consulta Destinazioni API.

    Servizio AWS

    Per utilizzare un Servizio AWS, seleziona Servizio AWS, quindi procedi come segue:

    1. In Seleziona una destinazione, seleziona un Servizio AWS da utilizzare come destinazione. Fornisci le informazioni richieste per il servizio selezionato.

      Nota

      I campi visualizzati variano a seconda del servizio selezionato. Per ulteriori informazioni sulle destinazioni disponibili, consulta Obiettivi disponibili nella EventBridge console.

  2. Per molti tipi di destinazione, EventBridge necessita di autorizzazioni per l'invio degli eventi alla destinazione. In questi casi, EventBridge è in grado di creare il ruolo IAM necessario per l'esecuzione della regola.

    In Ruolo di esecuzione, esegui una delle seguenti operazioni:

    • Per creare un nuovo ruolo di esecuzione per questa regola:

      1. Seleziona Crea un nuovo ruolo per questa risorsa specifica.

      2. Immetti un nome per questo ruolo di esecuzione o utilizza il nome generato da EventBridge.

    • Per utilizzare un ruolo di esecuzione esistente per questa regola:

      1. Seleziona Utilizza un ruolo esistente.

      2. Immetti o seleziona il nome del ruolo di esecuzione da utilizzare dall'elenco a discesa.

  3. (Facoltativo) In Impostazioni aggiuntive, specifica una delle impostazioni facoltative disponibili per il tipo di destinazione:

    Event bus

    (Facoltativo) In Coda DLQ scegli se utilizzare una coda Amazon SQS standard come coda DLQ. EventBridge invia eventi che corrispondono a questa regola alla coda DLQ se non vengono recapitati correttamente alla destinazione. Completa una delle seguenti operazioni:

    • Scegli Nessuna per non utilizzare una coda DLQ.

    • Scegli Seleziona una coda Amazon SQS nell'account AWS corrente da utilizzare come coda DLQ, quindi seleziona la coda da utilizzare dal menu a discesa.

    • Scegli Seleziona una coda Amazon SQS in un altro account AWS come coda DLQ e specifica l'ARN della coda da utilizzare. È necessario collegare alla coda una policy basata su risorse che concede l'autorizzazione EventBridge per l'invio di messaggi.

      Per ulteriori informazioni, consulta Concessione delle autorizzazioni per la coda DLQ.

    API destination

    1. (Facoltativo) In Configura l'input di destinazione, scegli come personalizzare il testo inviato alla destinazione per gli eventi corrispondenti. Scegli una delle seguenti opzioni:

      • Eventi corrispondenti: EventBridge invia l'intero evento di origine originale alla destinazione. Questa è l'impostazione predefinita.

      • Parte degli eventi corrispondenti: EventBridge invia solo la parte specificata dell'evento di origine originale alla destinazione.

        In Specifica la parte dell'evento corrispondente, specifica un percorso JSON che definisce la parte dell'evento che EventBridge deve inviare alla destinazione.

      • Costante (testo JSON): EventBridge invia solo il testo JSON specificato alla destinazione. Non viene inviata alcuna parte dell'evento di origine originale.

        In Specifica la costante in JSON, specifica il testo JSON che EventBridge deve inviare alla destinazione anziché all'evento.

      • Trasformatore di input: configura un trasformatore di input per personalizzare il testo che EventBridge deve inviare alla destinazione. Per ulteriori informazioni, consulta Trasformazione degli EventBridge input di Amazon.

        1. Seleziona Configura il trasformatore di input.

        2. Configura il trasformatore di input seguendo la procedura descritta in Configurazione di un trasformatore di input come parte della creazione di una regola.

    2. (Facoltativo) In Policy di ripetizione, specifica in che modo EventBridge deve ritentare l'invio di un evento a una destinazione dopo che si è verificato un errore.

      • Durata massima dell'evento: immetti il periodo di tempo massimo (in ore, minuti e secondi) durante il quale EventBridge deve mantenere gli eventi non elaborati. Il valore predefinito è 24 ore.

      • Nuovi tentativi: immetti il numero massimo di volte in cui EventBridge deve riprovare a inviare un evento alla destinazione dopo che si è verificato un errore. L'impostazione predefinita è 185 volte.

    3. (Facoltativo) In Coda DLQ scegli se utilizzare una coda Amazon SQS standard come coda DLQ. EventBridge invia eventi che corrispondono a questa regola alla coda DLQ se non vengono recapitati correttamente alla destinazione. Completa una delle seguenti operazioni:

      • Scegli Nessuna per non utilizzare una coda DLQ.

      • Scegli Seleziona una coda Amazon SQS nell'account AWS corrente da utilizzare come coda DLQ, quindi seleziona la coda da utilizzare dal menu a discesa.

      • Scegli Seleziona una coda Amazon SQS in un altro account AWS come coda DLQ e specifica l'ARN della coda da utilizzare. È necessario collegare alla coda una policy basata su risorse che concede l'autorizzazione EventBridge per l'invio di messaggi.

        Per ulteriori informazioni, consulta Concessione delle autorizzazioni per la coda DLQ.

    AWS service

    Tieni presente che EventBridge potrebbe non visualizzare tutti i seguenti campi per un determinato servizio AWS.

    1. (Facoltativo) In Configura l'input di destinazione, scegli come personalizzare il testo inviato alla destinazione per gli eventi corrispondenti. Scegli una delle seguenti opzioni:

      • Eventi corrispondenti: EventBridge invia l'intero evento di origine originale alla destinazione. Questa è l'impostazione predefinita.

      • Parte degli eventi corrispondenti: EventBridge invia solo la parte specificata dell'evento di origine originale alla destinazione.

        In Specifica la parte dell'evento corrispondente, specifica un percorso JSON che definisce la parte dell'evento che EventBridge deve inviare alla destinazione.

      • Costante (testo JSON): EventBridge invia solo il testo JSON specificato alla destinazione. Non viene inviata alcuna parte dell'evento di origine originale.

        In Specifica la costante in JSON, specifica il testo JSON che EventBridge deve inviare alla destinazione anziché all'evento.

      • Trasformatore di input: configura un trasformatore di input per personalizzare il testo che EventBridge deve inviare alla destinazione. Per ulteriori informazioni, consulta Trasformazione degli EventBridge input di Amazon.

        1. Seleziona Configura il trasformatore di input.

        2. Configura il trasformatore di input seguendo la procedura descritta in Configurazione di un trasformatore di input come parte della creazione di una regola.

    2. (Facoltativo) In Policy di ripetizione, specifica in che modo EventBridge deve ritentare l'invio di un evento a una destinazione dopo che si è verificato un errore.

      • Durata massima dell'evento: immetti il periodo di tempo massimo (in ore, minuti e secondi) durante il quale EventBridge deve mantenere gli eventi non elaborati. Il valore predefinito è 24 ore.

      • Nuovi tentativi: immetti il numero massimo di volte in cui EventBridge deve riprovare a inviare un evento alla destinazione dopo che si è verificato un errore. L'impostazione predefinita è 185 volte.

    3. (Facoltativo) In Coda DLQ scegli se utilizzare una coda Amazon SQS standard come coda DLQ. EventBridge invia eventi che corrispondono a questa regola alla coda DLQ se non vengono recapitati correttamente alla destinazione. Completa una delle seguenti operazioni:

      • Scegli Nessuna per non utilizzare una coda DLQ.

      • Scegli Seleziona una coda Amazon SQS nell'account AWS corrente da utilizzare come coda DLQ, quindi seleziona la coda da utilizzare dal menu a discesa.

      • Scegli Seleziona una coda Amazon SQS in un altro account AWS come coda DLQ e specifica l'ARN della coda da utilizzare. È necessario collegare alla coda una policy basata su risorse che concede l'autorizzazione EventBridge per l'invio di messaggi.

        Per ulteriori informazioni, consulta Concessione delle autorizzazioni per la coda DLQ.

  4. (Facoltativo) Scegli Aggiungi un'altra destinazione per aggiungere un'altra destinazione per questa regola.

  5. Scegli Successivo.

Tieni presente che EventBridge potrebbe non visualizzare tutti i seguenti campi per un determinato servizio AWS.

Configurazione di tag e revisione della regola

Infine, immetti i tag desiderati per la regola, quindi rivedi e crea la regola.

Per configurare i tag e rivedere e creare la regola

  1. (Facoltativo) Inserire uno o più tag per la regola. Per ulteriori informazioni, consulta EventBridge Etichette Amazon.

  2. Scegli Successivo.

  3. Rivedi i dettagli della nuova regola. Per apportare modifiche a una qualsiasi sezione, scegli il pulsante Modifica accanto alla sezione in questione.

    Quando sei soddisfatto dei dettagli della regola, scegli Crea regola.