Creazione di regole 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 in Amazon EventBridge

Prerequisiti

Prima di iniziare, assicurati di disporre dei seguenti elementi:

  • Accesso alla EventBridge console Amazon

  • Autorizzazioni IAM appropriate per creare regole EventBridge

  • Conoscenza di base delle architetture basate sugli eventi

Panoramica

Per intervenire sugli eventi ricevuti da EventBridge, è possibile creare regole. Quando un evento corrisponde al modello di evento definito nella regola, EventBridge invia l'evento al target specificato.

Questo argomento illustra come creare una regola da EventBridge utilizzare per abbinare gli eventi man mano che vengono inviati al bus 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 desideri 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 Regole, quindi scegli Crea regola.

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

    1. Scegli AWS Service Events o Custom Events.

    2. Utilizza 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 nell'area di disegno Build e rilasciali su Triggering Events.

    EventBridge visualizza la sezione Triggering Events. Questa sezione include:

    • Eventi, che elenca l'evento scelto.

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

      Lo schema contiene tre schede:

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

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

      • Informazioni: informazioni generali sullo schema.

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

    • Schema di eventi (filtro), che contiene uno schema di eventi 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 pattern del tuo evento più specifico in modo che selezioni solo gli eventi che contengono gli attributi e i valori che ti interessano.

Modifica lo schema 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 codice JSON nel riquadro Event pattern

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

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

    1. Scegliete l'icona del filtro accanto all'attributo che desiderate aggiungere come filtro al modello di evento.

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

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

    3. Inserisci il valore che desideri abbinare.

    4. Fai clic sul segno di spunta per terminare.

    EventBridge aggiunge il filtro che hai creato al JSON nel riquadro Event pattern.

  3. Aggiungi filtri aggiuntivi fino a creare un modello di evento che corrisponda a tutti gli attributi di evento che desideri.

Prova lo schema degli eventi

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

Verificate il modello di evento (opzionale)

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

    • Utilizza gli eventi di esempio forniti

      1. Scegli Usa gli 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 Usa il tuo evento.

        EventBridge visualizza un evento generico con un details elemento vuoto.

      2. Modifica il codice JSON dell'evento per creare l'evento rispetto 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. Scegliete Usa eventi di esempio forniti, scegliete un evento dall'evento di attivazione di esempio, quindi scegliete Copia.

        2. Scegli Usa il tuo evento.

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

        4. Modificate l'evento come desiderate.

  2. Scegliete Run Test.

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

Selezionare le destinazioni

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

  • Altri bus 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 Amazon SQS o argomenti di Amazon SNS

Per selezionare le destinazioni
  1. Seleziona il tipo di oggetto dal riquadro Target e trascinalo nella forma Target nell'area di disegno Build.

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

    Suggerimento

    Se avete specificato più di un obiettivo, selezionando la forma di destinazione viene visualizzata la sezione di configurazione per tale destinazione.

  2. Configura l'obiettivo in base al tipo di obiettivo. Per i passaggi di configurazione dettagliati, consulta EventBridge Target.

Personalizza i dati degli eventi inviati alla destinazione

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

Trasforma o sostituisci i dati dell'evento inviati (opzionale)

  1. Nell'area di disegno Build, scegliete l'icona di trasformazione Input nella forma Target.

    EventBridge visualizza la sezione Input transformation.

  2. In Configurazione della trasformazione di 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 input: configura un trasformatore di input per personalizzare il testo EventBridge da inviare alla destinazione. Per ulteriori informazioni, consulta Trasformare l'input del target.

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 Regione AWS e sullo 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 invia un evento, questo passa sempre al bus eventi predefinito del tuo account.

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

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

  6. Scegli Create (Crea).

Fasi successive

Dopo aver creato la regola, puoi:

Risorse aggiuntive

Per ulteriori informazioni sulle EventBridge regole, consulta: