Creazione di regole che reagiscono agli eventi in Amazon EventBridge - Amazon EventBridge

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 che reagiscono agli eventi in Amazon EventBridge

Per intervenire sugli eventi ricevuti da Amazon EventBridge, puoi creare regole. Quando un evento corrisponde al modello di evento definito nella regola, EventBridge invia l'evento al target specificato e attiva l'azione definita nella regola.

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

I passaggi seguenti illustrano come creare una regola da EventBridge utilizzare per abbinare gli eventi man mano che vengono inviati al bus 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. Apri la EventBridge console Amazon all'indirizzo https://console.aws.amazon.com/events/.

  2. Nel pannello di navigazione, scegli Regole.

  3. Scegli 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 nello stesso 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 utente emette un evento, questo passa sempre al bus degli eventi predefinito del tuo account.

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

  7. Scegli Next (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. Per Event source, scegli AWS eventi o eventi EventBridge partner.

  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:

    • AWS eventi: seleziona tra gli eventi emessi da Servizi AWS Supported.

    • EventBridge eventi partner: seleziona tra gli 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 AWS o un evento partner come punto di partenza per creare il tuo evento personalizzato.

      1. Seleziona AWS eventi o eventi EventBridge partner.

      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. Elimina la struttura degli eventi di esempio nel riquadro di modifica JSON e incolla l'evento AWS o il partner al suo posto.

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

  3. In Metodo di creazione, scegli un metodo di creazione. È possibile creare un modello di evento da uno EventBridge schema o modello oppure creare un modello di evento personalizzato.

    Existing schema

    Per utilizzare uno EventBridge schema esistente per creare il modello di eventi, effettuate le seguenti operazioni:

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

      È 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 dell'evento.

      È 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 dell'evento.

      È 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 il pattern non può essere renderizzato in Pattern Builder così com'è, EventBridge avvisa l'utente prima dell'apertura di Pattern Builder.

  4. Scegli Next (Successivo).

Selezionare le destinazioni

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

Per selezionare le destinazioni
  1. In Tipi di destinazione, scegli uno dei seguenti tipi di destinazione:

    Event bus
    1. Seleziona Event BusEventBridge .

    2. Scegliete il bus dell'evento da usare come destinazione.

    3. Per molti tipi di target, EventBridge necessita di autorizzazioni per l'invio degli eventi. In questi casi, EventBridge può 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. Inserisci un nome per questo ruolo di esecuzione o usa 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.

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

      (Facoltativo) Per la coda di lettere non scritte, scegli se utilizzare una coda Amazon SQS standard come coda di lettere non scritte. EventBridge invia gli eventi che corrispondono a questa regola alla coda di lettere non scritte se non vengono consegnati correttamente alla destinazione. Esegui una di queste 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 allegare alla coda una politica basata sulle risorse che conceda l'autorizzazione a inviare messaggi alla coda. EventBridge

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

    API destination
    1. EventBridge Seleziona la destinazione dell'API.

    2. Scegli una destinazione API nuova o esistente:

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

    3. Per molti tipi di target, EventBridge necessita di autorizzazioni per l'invio degli eventi. In questi casi, EventBridge puoi 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. Inserisci un nome per questo ruolo di esecuzione o usa 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.

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

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

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

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

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

          In Specificate la parte dell'evento corrispondente, specificate un percorso JSON che definisce la parte dell'evento che desiderate inviare EventBridge 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 Specificate la costante in JSON, specificate il testo JSON che desiderate inviare EventBridge alla destinazione anziché all'evento.

        • Trasformatore di input: configura un trasformatore di input per personalizzare il testo che desideri EventBridge 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 ingresso durante la creazione di una regola in EventBridge.

      2. (Facoltativo) In Politica Riprova, specificate come EventBridge ripetere l'invio di un evento a una destinazione dopo che si è verificato un errore.

        • Età massima dell'evento: immettete la quantità di tempo massima (in ore, minuti e secondi) EventBridge per la conservazione degli eventi non elaborati. Il valore predefinito è 24 ore.

        • Tentativi di nuovo tentativo: immettete il numero massimo di volte in cui è EventBridge necessario riprovare a inviare un evento alla destinazione dopo che si è verificato un errore. L'impostazione predefinita è 185 volte.

      3. (Facoltativo) Per la coda di lettere non scritte, scegli se utilizzare una coda Amazon SQS standard come coda di lettere non scritte. EventBridge invia gli eventi che corrispondono a questa regola alla coda di lettere non scritte se non vengono consegnati correttamente alla destinazione. Esegui una di queste operazioni:

        • Scegli Nessuna per non utilizzare una coda DLQ.

        • Scegli Seleziona una coda Amazon SQS nell' AWS account corrente da utilizzare come coda di lettere non scritte, quindi seleziona la coda da utilizzare dall'elenco 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 allegare alla coda una policy basata sulle risorse che conceda l'autorizzazione a inviarle messaggi. EventBridge

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

    Per ulteriori informazioni, consulta Destinazioni API come destinazioni in Amazon EventBridge.

    Servizio AWS
    1. Seleziona Servizio AWS.

    2. In Seleziona una destinazione, seleziona un Servizio AWS da utilizzare come destinazione.

    3. Se scegli un AWS servizio che supporta destinazioni tra account, puoi selezionare una destinazione nello stesso account dell'event bus o in un account diverso.

      • Per un obiettivo nello stesso account, per Tipo di destinazione seleziona Obiettivo in questo account.

        1. 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 Target del bus degli eventi disponibili nella EventBridge console.

        2. Per molti tipi di target, EventBridge necessita di autorizzazioni per l'invio degli eventi. In questi casi, EventBridge puoi 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. Inserisci un nome per questo ruolo di esecuzione o usa 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.

      • Per una destinazione in un account diverso, per Tipo di destinazione seleziona Target in un altro AWS account.

        1. Immettete l'ARN della risorsa di destinazione a cui desiderate inviare gli eventi.

        2. Fornisci tutte le informazioni aggiuntive richieste per il servizio selezionato.

        3. Seleziona il nome del ruolo di esecuzione da utilizzare dall'elenco a discesa.

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

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

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

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

          In Specificate la parte dell'evento corrispondente, specificate un percorso JSON che definisce la parte dell'evento che desiderate inviare EventBridge 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 Specificate la costante in JSON, specificate il testo JSON che desiderate inviare EventBridge alla destinazione anziché all'evento.

        • Trasformatore di input: configura un trasformatore di input per personalizzare il testo che desideri EventBridge 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 ingresso durante la creazione di una regola in EventBridge.

      2. (Facoltativo) In Politica Riprova, specificate come EventBridge ripetere l'invio di un evento a una destinazione dopo che si è verificato un errore.

        • Età massima dell'evento: immettete la quantità di tempo massima (in ore, minuti e secondi) EventBridge per la conservazione degli eventi non elaborati. Il valore predefinito è 24 ore.

        • Tentativi di nuovo tentativo: immettete il numero massimo di volte in cui è EventBridge necessario riprovare a inviare un evento alla destinazione dopo che si è verificato un errore. L'impostazione predefinita è 185 volte.

      3. (Facoltativo) Per la coda di lettere non scritte, scegli se utilizzare una coda Amazon SQS standard come coda di lettere non scritte. EventBridge invia gli eventi che corrispondono a questa regola alla coda di lettere non scritte se non vengono consegnati correttamente alla destinazione. Esegui una di queste operazioni:

        • Scegli Nessuna per non utilizzare una coda DLQ.

        • Scegli Seleziona una coda Amazon SQS nell' AWS account corrente da utilizzare come coda di lettere non scritte, quindi seleziona la coda da utilizzare dall'elenco 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 allegare alla coda una policy basata sulle risorse che conceda l'autorizzazione a inviarle messaggi. EventBridge

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

  2. (Facoltativo) Scegli Aggiungi destinazione per aggiungere un’altra destinazione per questa regola.

  3. Scegli Next (Successivo).

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 Etichettare le risorse in Amazon EventBridge.

  2. Scegli Next (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.