Creazione di regole che reagiscono agli eventi in Amazon EventBridge - Amazon EventBridge
Definizione della regolaCreazione di un modello di eventiSelezionare le destinazioniConfigurazione di tag e revisione della regola

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. Seleziona 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 lo schema degli eventi JSON e testarlo rispetto a 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: inserisci il tuo evento nel 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. Eliminate la struttura degli eventi di esempio nel riquadro di JSON modifica e incollate l'evento AWS o l'evento partner al suo posto.

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

  3. In Metodo di creazione, scegli un metodo di creazione. È possibile creare un modello di evento da EventBridge uno 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. Scegliete Genera modello di evento in JSON per generare e convalidare il modello di evento come JSON testo.

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

      È anche possibile scegliere una delle seguenti opzioni:

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

      • Prettify: semplifica la lettura del JSON testo 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. È necessario formattare lo schema come testo valido. JSON

    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 modello di evento in JSON per generare e convalidare il modello di evento come JSON testo.

    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.

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

    Event pattern

    Per scrivere un modello di evento personalizzato in JSON formato, effettuate le seguenti operazioni:

    1. Nella sezione Metodo di creazione, per Metodo, scegliete Modello personalizzato (JSONeditor).

    2. Per Schema di evento, inserisci il modello di evento personalizzato in un JSON testo formattato.

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

      È anche possibile scegliere una delle seguenti opzioni:

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

      • Prettify: semplifica la lettura del JSON testo 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 che Pattern Builder venga aperto.

  4. Seleziona Successivo.

Selezionare le destinazioni

Scegli una o più destinazioni per ricevere eventi che corrispondono al modello specificato. Gli obiettivi possono includere un bus per EventBridge eventi, EventBridge API destinazioni, 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

    Per selezionare un bus di EventBridge eventi, seleziona EventBridge Event bus, quindi procedi come segue:

    API destination

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

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

    • Per creare una nuova API destinazione, seleziona Crea una nuova API destinazione. 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.

      • APIendpoint di destinazione: l'URLendpoint per la destinazione.

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

      • HTTPmetodo: seleziona il HTTP metodo 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 APIdestinazioni come obiettivi in Amazon EventBridge.

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

  2. Per molti tipi di oggetto, EventBridge sono necessarie le autorizzazioni per inviare eventi alla destinazione. In questi casi, EventBridge può creare il IAM ruolo 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. Immettete un nome per questo ruolo di esecuzione o utilizzate 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) Per la coda di lettere morte, scegli se utilizzare una SQS coda Amazon 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 SQS coda Amazon 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 SQS coda Amazon in un altro AWS account come coda di lettere non scritte, quindi inserisci la ARN coda da utilizzare. È necessario allegare alla coda una politica basata sulle risorse che autorizza l'invio di messaggi. EventBridge

      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. 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 JSON percorso che definisca la parte dell'evento che desiderate inviare EventBridge alla destinazione.

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

        In Specificate la costante in JSON, specificate il JSON testo che desiderate inviare EventBridge alla destinazione anziché all'evento.

      • Trasformatore di ingresso: 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 il periodo di tempo massimo (in ore, minuti e secondi) per EventBridge conservare gli 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 morte, scegli se utilizzare una SQS coda Amazon 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 SQS coda Amazon 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 SQS coda Amazon in un altro AWS account come coda di lettere non scritte, quindi inserisci la ARN coda da utilizzare. È necessario allegare alla coda una politica basata sulle risorse che autorizza l'invio di messaggi. EventBridge

        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. 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 JSON percorso che definisca la parte dell'evento che desiderate inviare EventBridge alla destinazione.

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

        In Specificate la costante in JSON, specificate il JSON testo che desiderate inviare EventBridge alla destinazione anziché all'evento.

      • Trasformatore di ingresso: 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 il periodo di tempo massimo (in ore, minuti e secondi) per EventBridge conservare gli 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 morte, scegli se utilizzare una SQS coda Amazon 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 SQS coda Amazon 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 SQS coda Amazon in un altro AWS account come coda di lettere non scritte, quindi inserisci la ARN coda da utilizzare. È necessario allegare alla coda una politica basata sulle risorse che autorizza l'invio di messaggi. EventBridge

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

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

  5. Seleziona 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 la pagina Etichettare le risorse in Amazon EventBridge.

  2. Seleziona 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.