View a markdown version of this page

Creazione di regole utilizzando Enhanced Builder - 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 utilizzando Enhanced Builder

Prerequisiti

Prima di iniziare, assicurati di disporre dei seguenti elementi:

  • Accesso alla EventBridge console Amazon

  • Autorizzazioni IAM appropriate per creare regole EventBridge

  • Comprensione di base delle architetture basate sugli eventi

Panoramica di

Per intervenire sugli eventi ricevuti da EventBridge, puoi creare regole. Quando un evento corrisponde al modello di evento definito nella regola, EventBridge invia l'evento alla destinazione specificata.

Questo argomento illustra la creazione di una regola che EventBridge utilizza la corrispondenza degli eventi nel momento in cui vengono inviati al bus di eventi specificato.

La creazione di EventBridge regole prevede quattro passaggi principali:

  1. Scegli gli eventi che desideri elaborare

  2. Configura il filtraggio e il test degli eventi

  3. Seleziona e configura gli obiettivi

  4. Configura le impostazioni delle regole

Scegli gli eventi

Per prima cosa, scegli gli eventi che vuoi inviare al bersaglio.

Per selezionare un evento
  1. Apri la EventBridge console Amazon all'indirizzo https://console.aws.amazon.com/events/.

  2. Nel riquadro di navigazione scegli Rules (Regole), quindi Create rule (Crea regola).

  3. Nella pagina di selezione del generatore di regole, scegli Enhanced Builder.

    L'Enhanced Builder fornisce una tela visiva per la creazione di regole e obiettivi trascinando eventi e obiettivi. Per utilizzare invece modelli e configurazioni JSON, vedi Creazione di regole (Advanced Builder).

  4. Nella scheda Eventi, trova gli eventi che desideri inviare al target:

    1. Scegli Eventi AWS di servizio o Eventi personalizzati.

    2. Usa la casella di ricerca o sfoglia l'elenco degli eventi per trovare gli eventi che desideri inviare alla destinazione.

    3. Trascina uno o più eventi nella tela Build e rilasciali su Triggering Events.

    EventBridge visualizza la sezione Triggering Events. Questa sezione include:

    • Eventi, che elenca l'evento che hai scelto.

    • Schema, che visualizza lo schema dell'evento selezionato, se disponibile.

      Lo schema contiene tre schede:

      • Struttura: una visualizzazione ad albero dello schema degli eventi.

      • Codice: lo schema degli eventi in formato Open API spec o JSON.

      • Informazioni: informazioni generali sullo schema.

    • Evento di esempio, che visualizza un esempio di un evento selezionato, se disponibile.

    • Modello di evento (filtro), che contiene un modello di evento che seleziona tutti gli eventi che hai scelto.

Filtra gli eventi per inviare solo ciò che desideri

Probabilmente non vorrai inviare tutti gli eventi di un tipo specifico a un target. Puoi rendere il tuo modello di evento più specifico in modo che selezioni solo gli eventi che contengono gli attributi e i valori che ti interessano.

Modifica il modello dell'evento (opzionale)

Nel riquadro Eventi di attivazione, puoi creare il modello di evento in due modi:

  • Visivamente, utilizzando la visualizzazione ad albero dello schema

  • Modificando direttamente il JSON nel riquadro dello schema degli eventi

Per modificare il modello di evento utilizzando la visualizzazione ad albero dello schema
  1. Scegli la scheda Albero del riquadro Schema.

  2. Aggiungi e modifica i filtri per creare lo schema degli eventi.

    1. Scegli l'icona del filtro accanto all'attributo che desideri aggiungere come filtro al pattern dell'evento.

    2. Scegli un operatore di confronto dall'elenco a discesa.

      Per ulteriori informazioni sugli operatori di confronto, consulta Creazione di modelli di eventi.

    3. Inserite il valore da abbinare.

    4. Fai clic sul segno di spunta per terminare.

    EventBridge aggiunge il filtro che hai creato al JSON nel riquadro dello schema degli eventi.

  3. Aggiungi filtri aggiuntivi finché non hai creato un modello di evento che corrisponda a tutti gli attributi dell'evento che desideri.

Prova il modello di evento

Dopo aver creato un modello di evento che corrisponda a tutti gli attributi di evento desiderati, verificate che il modello di evento funzioni come previsto.

Verificate il modello di evento (opzionale)

  1. Scegli un evento di esempio per il test o usa il tuo.

    • Usa gli eventi di esempio forniti

      1. Scegli Usa eventi di esempio forniti.

      2. In Esempio di evento di attivazione, seleziona l'evento da utilizzare per il test dall'elenco a discesa.

    • Usa il tuo evento

      1. Scegli Utilizza il tuo evento.

        EventBridge visualizza un evento generico con un details elemento vuoto.

      2. Modifica il JSON dell'evento per creare l'evento in base al quale desideri testare il modello dell'evento.

        Suggerimento

        Puoi utilizzare gli eventi di esempio forniti come punti di partenza per creare eventi personalizzati da utilizzare nei test:

        1. Scegli Utilizza eventi di esempio forniti, scegli un evento dall’Evento di attivazione di esempio, quindi scegli Copia.

        2. Scegli Utilizza il tuo evento.

        3. Seleziona l’intero evento nella finestra e incolla l’evento di esempio su di esso.

        4. Modifica l’evento come desideri.

  2. Scegli Esegui test.

    EventBridge visualizza un messaggio che indica se l'evento di test corrisponde al modello dell'evento.

Selezionare le destinazioni

Trascina uno (e fino a cinque) target nell'area Build e rilascialo su Target per ricevere eventi che corrispondono al modello di evento specificato. Gli obiettivi possono includere:

  • Altri autobus per EventBridge eventi, uguali o diversi Account AWS

  • EventBridge Destinazioni API, inclusi partner SaaS come Salesforce

  • Una gamma di risorse di AWS servizio, come le code di Amazon SQS o gli argomenti di Amazon SNS

Per selezionare le destinazioni
  1. Seleziona il tipo di destinazione dal riquadro Target e rilascialo sulla forma Target nella tela Build.

    EventBridge visualizza la sezione Target nel Build, con le opzioni di configurazione applicabili in base al tipo di target selezionato.

    Suggerimento

    Se hai specificato più di un target, selezionando la forma del target viene visualizzata la sezione di configurazione per quel target.

  2. Configura la destinazione in base al tipo di destinazione. Per i passaggi di configurazione dettagliati, consulta EventBridge Target.

Personalizza i dati degli eventi inviati al target

Se selezioni una destinazione diversa da un bus di EventBridge eventi o una destinazione EventBridge API, hai la possibilità di personalizzare i dati che vengono effettivamente consegnati alla destinazione.

Trasforma o sostituisci i dati degli eventi inviati (opzionale)

  1. Nella tela di progettazione Build, scegli l'icona di trasformazione di input nella forma Target.

    EventBridge visualizza la sezione Trasformazione di input.

  2. In Configurazione della trasformazione dell'input, scegli Abilita.

  3. Seleziona il metodo di trasformazione per scegliere come personalizzare il testo inviato alla destinazione per gli eventi corrispondenti:

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

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

    • Trasformatore di ingresso: configura un trasformatore di ingresso per personalizzare il testo che desideri inviare EventBridge al target. Per ulteriori informazioni, consulta Trasformazione dell'input di destinazione.

Configura la regola

Infine, configura e crea la regola.

Per configurare la regola (console)
  1. Scegli Configura.

  2. 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 bus di eventi Regione AWS e nello stesso bus di eventi.

  3. 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 del tuo account invia un evento, viene sempre inviato al bus eventi predefinito del tuo account.

  4. Per abilitare la regola non appena viene creata, in Attivazione abilita Attivo.

  5. (Facoltativo) Inserire uno o più tag per la regola. Per ulteriori informazioni, consulta Etichettare le risorse in Amazon EventBridge.

  6. Scegli Crea.

Fasi successive

Dopo aver creato la regola, puoi:

Risorse aggiuntive

Per ulteriori informazioni sulle EventBridge regole, consulta: