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à.
# Regole in Amazon EventBridge
È possibile specificare EventBridge cosa fare con gli eventi distribuiti a ciascun bus di eventi. Per fare ciò, create *delle regole*. Una regola specifica quali eventi inviare a quali [destinazioni](eb-targets.md) per l'elaborazione. Una singola regola può inviare un evento a più destinazioni, che vengono eseguite in parallelo.
È possibile creare due tipi di regole: regole che corrispondono ai dati degli eventi man mano che gli eventi vengono consegnati e regole che vengono eseguite secondo una pianificazione definita. Inoltre, alcuni AWS servizi possono creare e gestire regole anche nel tuo account.
## Regole che corrispondono ai dati degli eventi
È possibile creare regole che corrispondano agli eventi in arrivo in base a criteri relativi ai dati degli eventi (denominati *pattern di eventi*). Un modello di eventi definisce la struttura dell'evento e i campi a cui una regola corrisponde. Se un evento corrisponde ai criteri definiti nel modello di evento, lo EventBridge invia alle destinazioni specificate.
Per ulteriori informazioni, consulta [Creazione di regole in Amazon EventBridge](eb-create-rule-visual.md).
## Regole che vengono eseguite secondo una pianificazione
**Nota**
Le regole pianificate sono una funzionalità legacy di EventBridge.
EventBridgeoffre un modo più flessibile e potente per creare, eseguire e gestire le attività pianificate centralmente e su larga scala: EventBridge Scheduler. Con EventBridge Scheduler, puoi creare pianificazioni utilizzando le espressioni cron e rate per schemi ricorrenti o configurare chiamate una tantum. Puoi configurare finestre temporali flessibili per la consegna, definire limiti per nuovi tentativi e impostare il tempo massimo di conservazione per invocazioni API non riuscite.
Scheduler è altamente personalizzabile e offre una migliore scalabilità rispetto alle regole pianificate, con un set più ampio di operazioni e servizi API mirati. AWS Ti consigliamo di utilizzare Scheduler per richiamare gli obiettivi in base a una pianificazione.
Per ulteriori informazioni, consulta la nostra Guida per l'utente [Creare una pianificazione.](using-eventbridge-scheduler.md#using-eventbridge-scheduler-create) di *[EventBridge Scheduler.](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)*
È inoltre possibile creare regole che inviano eventi alle destinazioni specificate a intervalli specificati. Ad esempio, per eseguire periodicamente una Lambda funzione, è possibile creare una regola da eseguire in base a una pianificazione.
Per ulteriori informazioni, consulta [Creazione di una regola pianificata (legacy) in Amazon EventBridge](eb-create-rule-schedule.md).
## Regole gestite dai AWS servizi
Oltre alle regole create dall'utente, AWS i servizi possono creare e gestire EventBridge le regole AWS dell'account necessarie per determinate funzioni di tali servizi. Queste regole sono denominate *regole gestite*.
Quando un servizio crea una regola gestita, può anche creare una [IAM politica](eb-iam.md) che concede al servizio l'autorizzazione a creare la regola. Per consentire la creazione delle sole regole necessarie, l'ambito delle policy IAM create in questo modo può essere limitato con autorizzazioni a livello di risorsa.
Puoi eliminare le regole gestite utilizzando l'opzione **Forza eliminazione**, ma devi eliminarle solo se hai la certezza che non siano più necessarie all'altro servizio. In caso contrario, se elimini una regola gestita, le caratteristiche che si basano su di essa smettono di funzionare.
# 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 di
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
1. Configura il filtraggio e il test degli eventi
1. Seleziona e configura gli obiettivi
1. 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/](https://console.aws.amazon.com/events/).
1. Nel riquadro di navigazione, scegli **Regole**, quindi scegli **Crea regola**.
1. Nella scheda **Eventi**, trova gli eventi che desideri inviare al target:
1. Scegli **AWS Service Events** o **Custom Events**.
1. Utilizza la casella di ricerca o sfoglia l'elenco degli eventi per trovare gli eventi che desideri inviare alla destinazione.
1. 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**.
1. 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.
1. Scegliete un operatore di confronto dall'elenco a discesa.
Per ulteriori informazioni sugli operatori di confronto, consulta [Creazione di modelli di eventi](eb-create-pattern-operators.md).
1. Inserisci il valore che desideri abbinare.
1. Fai clic sul segno di spunta per terminare.
EventBridge aggiunge il filtro che hai creato al JSON nel riquadro **Event pattern**.
1. 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**.
1. 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.
1. 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:
Scegli **Utilizza eventi di esempio forniti**, scegli un evento dall’**Evento di attivazione di esempio**, quindi scegli **Copia**.
Scegli **Utilizza il tuo evento**.
Seleziona l’intero evento nella finestra e incolla l’evento di esempio su di esso.
Modifica l’evento come desideri.
1. Scegli **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.
1. Configura l'obiettivo in base al tipo di obiettivo. Per i passaggi di configurazione dettagliati, consulta [EventBridge Target](eb-targets.md).
### 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**.
1. In **Configurazione della trasformazione di input**, scegli **Abilita**.
1. 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](eb-transform-target-input.md) l'input del target.
## Configura la regola
Infine, configura e crea la regola.
**Per configurare la regola (console)**
1. Scegli **Configura**.
1. 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.
1. 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.
1. Per abilitare la regola non appena viene creata, in **Attivazione** abilita **Active**.
1. (Facoltativo) Inserire uno o più tag per la regola. Per ulteriori informazioni, consulta [Etichettare le risorse in Amazon EventBridge](eb-tagging.md).
1. Scegli **Create** (Crea).
## Fasi successive
Dopo aver creato la regola, puoi:
+ [Monitora le prestazioni delle regole utilizzando le metriche](eb-monitoring.md)
+ [Verifica la tua regola con eventi di esempio](eb-event-pattern-sandbox.md)
+ [Modifica i modelli di eventi in base alle esigenze](eb-event-patterns.md)
+ [Aggiungi obiettivi aggiuntivi alle regole esistenti](eb-targets.md)
## Risorse aggiuntive
Per ulteriori informazioni sulle EventBridge regole, consulta:
+ [EventBridge panoramica delle regole](eb-rules.md)
+ [Creazione di modelli di eventi](eb-event-patterns.md)
+ [EventBridge obiettivi](eb-targets.md)
+ [ EventBridge regole di risoluzione dei problemi](eb-troubleshooting.md)
# Creazione di regole che reagiscono agli eventi in Amazon EventBridge
Per intervenire sugli eventi ricevuti da Amazon EventBridge, puoi creare [regole](eb-rules.md). Quando un evento corrisponde al [modello di evento](eb-event-patterns.md) definito nella regola, EventBridge invia l'evento al [target](eb-targets.md) specificato e attiva l'azione definita nella regola.
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.
**Topics**
+ [Definizione della regola](#eb-create-rule-define)
+ [Creazione di un modello di eventi](#eb-create-rule-event-pattern)
+ [Selezionare le destinazioni](#eb-create-rule-target)
+ [Configurazione di tag e revisione della regola](#eb-create-rule-review)
## 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/](https://console.aws.amazon.com/events/).
1. Nel pannello di navigazione, scegli **Regole**.
1. Scegli **Crea regola**.
1. 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.
1. 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.
1. Per **Tipo di regola**, scegli **Regola con un modello di eventi**.
1. 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**.
1. (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**.
1. Nell'elenco a discesa **Eventi di esempio**, seleziona l'evento da utilizzare come riferimento per l'evento personalizzato.
EventBridge visualizza l'evento di esempio.
1. Seleziona **Copia**.
1. Seleziona **Inserisci il mio** in **Tipo di evento**.
1. Elimina la struttura degli eventi di esempio nel riquadro di modifica JSON e incolla l'evento AWS o il partner al suo posto.
1. Modifica il testo JSON dell'evento per creare il tuo evento di esempio.
1. 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**.
1. Nella sezione **Modello di eventi**, in **Tipo di schema**, seleziona **Seleziona lo schema dal registro schemi**.
1. 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.
1. 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.
1. 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**.
1. Scegli **Genera un modello di eventi in JSON** per generare e convalidare il modello di eventi come testo JSON.
1. (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**.
1. Nella sezione **Modello di eventi**, in **Tipo di schema**, scegli **Inserisci schema**.
1. Immetti lo schema nella casella di testo. Devi formattarlo come testo JSON valido.
1. 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**.
1. Scegli **Genera un modello di eventi in JSON** per generare e convalidare il modello di eventi come testo JSON.
1. (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)**.
1. In **Modello di eventi**, immetti il modello di eventi personalizzato in testo in formato JSON.
1. (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.
------
1. 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 .**
1. Scegli il bus dell'evento da usare come destinazione.
+ Per utilizzare un bus di eventi Regione AWS come in questa regola:
1. Seleziona **Bus eventi nello stesso account e nella stessa Regione**.
1. Per **Bus di eventi come destinazione**, scegli la casella a discesa e immetti il nome del router di eventi. Puoi anche selezionare il router di eventi dall'elenco a discesa.
Per ulteriori informazioni, consulta [Invio di eventi tra bus di eventi nello stesso account e nella stessa regione in Amazon EventBridge](eb-bus-to-bus.md).
+ Per utilizzare un bus di eventi in un account Regione AWS or diverso come segue:
1. Seleziona **Bus di eventi in un account diverso o in una Regione diversa**.
1. In **Bus di eventi come destinazione**, immetti l'ARN del router di eventi da utilizzare.
Per ulteriori informazioni, consulta:
+ [Invio e ricezione di eventi tra AWS account in Amazon EventBridge](eb-cross-account.md)
+ [Invio e ricezione di eventi tra AWS regioni in Amazon EventBridge](eb-cross-region.md)
1. 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**.
1. 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**.
1. Immetti o seleziona il nome del ruolo di esecuzione da utilizzare dall'elenco a discesa.
1. (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 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 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](eb-rule-dlq.md#eb-dlq-perms).
------
#### [ API destination ]
1. **EventBridge Seleziona** la destinazione dell'API.
1. 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 **.** **\$1** **-** (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 **\$1** 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.
1. 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**.
1. 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**.
1. Immetti o seleziona il nome del ruolo di esecuzione da utilizzare dall'elenco a discesa.
1. (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](eb-transform-target-input.md).
1. Seleziona **Configura il trasformatore di input**.
1. Configura il trasformatore di input seguendo la procedura descritta in [Configurazione di un trasformatore di ingresso durante la creazione di una regola in EventBridge](eb-transform-input-rule.md).
1. (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.
1. (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 delle seguenti 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](eb-rule-dlq.md#eb-dlq-perms).
Per ulteriori informazioni, consulta [Destinazioni API come destinazioni in Amazon EventBridge](eb-api-destinations.md).
------
#### [ Servizio AWS ]
1. Seleziona **Servizio AWS**.
1. In **Seleziona una destinazione**, seleziona un Servizio AWS da utilizzare come destinazione.
1. 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](eb-targets.md#eb-console-targets).
1. 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**.
1. 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**.
1. 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.
1. Fornisci tutte le informazioni aggiuntive richieste per il servizio selezionato.
1. Seleziona il nome del ruolo di esecuzione da utilizzare dall'elenco a discesa.
1. (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](eb-transform-target-input.md).
1. Seleziona **Configura il trasformatore di input**.
1. Configura il trasformatore di input seguendo la procedura descritta in [Configurazione di un trasformatore di ingresso durante la creazione di una regola in EventBridge](eb-transform-input-rule.md).
1. (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.
1. (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 delle seguenti 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](eb-rule-dlq.md#eb-dlq-perms).
------
1. (Facoltativo) Scegli **Aggiungi destinazione** per aggiungere un’altra destinazione per questa regola.
1. 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](eb-tagging.md).
1. Scegli **Next (Successivo)**.
1. 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**.
# Disattivazione o eliminazione di una regola in Amazon EventBridge
Per impedire a una [regola](eb-rules.md) di elaborare [eventi](eb-events.md) o di essere eseguita in base a una pianificazione, puoi eliminare o disabilitare la regola. I passaggi seguenti illustrano come eliminare o disabilitare una EventBridge regola.
**Per eliminare o disabilitare una regola**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Nel riquadro di navigazione, scegli **Regole**.
In **Event bus (Bus di eventi)**, selezionare il bus di eventi associato alla regola.
1. Esegui una delle seguenti operazioni:
1. Per eliminare una regola, seleziona il pulsante accanto alla regola e seleziona **Actions** (Operazioni), **Delete** (Elimina), **Delete** (Elimina).
Se la regola è una regola gestita, immetti il nome della regola per riconoscere che si tratta di una regola gestita e che l'eliminazione della stessa può causare l'arresto delle funzionalità nel servizio che ha creato la regola. Per continuare, digitare il nome della regola e scegliere **Force delete (Forza eliminazione)**.
1. Per disattivare temporaneamente una regola, selezionare il pulsante accanto alla regola, quindi selezionare **Actions (Operazioni)**, **Disable (Disattiva)**.
Non è possibile disabilitare una regola gestita.
# Le migliori pratiche per la definizione delle regole in Amazon EventBridge
Di seguito sono riportate alcune best practice da prendere in considerazione quando crei regole per i tuoi router di eventi.
## Impostazione di un'unica destinazione per ogni regola
Sebbene sia possibile specificare fino a cinque destinazioni per una determinata regola, la gestione delle regole è più semplice se si specifica una singola destinazione per ogni regola. Se più di una regola deve ricevere lo stesso set di eventi, consigliamo di duplicare la regola per distribuire gli stessi eventi a destinazioni diverse. Questo incapsulamento semplifica la gestione delle regole: se le esigenze delle destinazioni degli eventi divergono nel tempo, puoi aggiornare ogni regola e il relativo modello di eventi indipendentemente dalle altre.
## Impostazione delle autorizzazioni delle regole
È possibile consentire ai componenti o ai servizi delle applicazioni che utilizzano eventi di avere il controllo della gestione delle proprie regole. Un approccio architettonico comune adottato dai clienti consiste nell'isolare questi componenti o servizi applicativi utilizzando AWS account separati. Per abilitare il flusso di eventi da un account all'altro, devi creare una regola in un router di eventi che instradi gli eventi a un router di eventi in un altro account. È possibile consentire ai team o a i servizi che utilizzano eventi di avere il controllo della gestione delle proprie regole. A tale scopo, devi specificare le autorizzazioni appropriate per i relativi account tramite policy basate su risorse. Ciò vale per account e Regioni.
Per ulteriori informazioni, consulta [Autorizzazioni per gli event bus in Amazon EventBridge](eb-event-bus-perms.md).
Per un esempio di politiche relative alle risorse, consulta [Modelli di progettazione multiaccount con Amazon EventBridge](https://github.com/aws-samples/amazon-eventbridge-resource-policy-samples/tree/main/patterns) on GitHub.
## Monitoraggio delle prestazioni delle regole
Monitora le tue regole per assicurarti che funzionino come previsto:
+ Il monitoraggio della metrica `TriggeredRules` per punti dati mancanti o anomalie può assisterti nel rilevare discrepanze per un editore che ha apportato una modifica sostanziale. Per ulteriori informazioni, consulta [Monitoraggio Amazon EventBridge](eb-monitoring.md).
+ Gli allarmi sulle anomalie o sul conteggio massimo previsto possono anche aiutare a rilevare quando una regola corrisponde a nuovi eventi. Ciò può accadere quando gli editori di eventi, inclusi servizi AWS e partner SaaS, introducono nuovi eventi abilitando nuovi casi d'uso e funzionalità. Quando questi nuovi eventi sono imprevisti e generano un volume superiore alla velocità di elaborazione della destinazione a valle, possono causare un backlog degli eventi.
Tale elaborazione di eventi imprevisti può anche comportare addebiti di fatturazione indesiderati.
Può anche attivare una limitazione delle regole quando l'account supera la quota di servizio prevista aggregata al secondo. EventBridge cercherà comunque di fornire eventi conformi a regole limitate e riproverà fino a 24 ore o come descritto nella politica di riprova personalizzata dell'obiettivo. Puoi rilevare le regole limitate e impostare allarmi per le stesse utilizzando la metrica `ThrottledRules`.
+ Per i casi d'uso a bassa latenza, puoi anche monitorare la latenza utilizzando `IngestionToInvocationStartLatency`, che fornisce un'indicazione dell'integrità del tuo router di eventi. Qualsiasi periodo prolungato di latenza elevata superiore a 30 secondi può indicare un'interruzione del servizio o una limitazione delle regole.
# Utilizzo AWS Serverless Application Model di modelli per distribuire risorse Amazon EventBridge
Puoi creare e testare [le regole](eb-rules.md) manualmente nella EventBridge console, il che può aiutarti nel processo di sviluppo mentre perfezioni [i modelli di eventi](eb-event-patterns.md). Tuttavia, quando è tutto pronto per distribuire l'applicazione, è più semplice utilizzare un framework come [AWS SAM](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html) per avviare tutte le risorse serverless in modo coerente.
Useremo quest'[applicazione di esempio](https://github.com/aws-samples/amazon-eventbridge-producer-consumer-example) per esaminare i modi in cui è possibile utilizzare i AWS SAM modelli per creare EventBridge risorse. Il file template.yaml in questo esempio è un AWS SAM modello che definisce quattro [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)funzioni e mostra due modi diversi per integrare le funzioni Lambda. EventBridge
Per una procedura guidata di questa applicazione di esempio, consulta [Tutorial: crea un' EventBridge applicazione Amazon di esempio](eb-tutorial-get-started.md).
Esistono due approcci all'utilizzo e ai modelli. EventBridge AWS SAM Per integrazioni semplici in cui una funzione Lambda viene richiamata da una regola, si consiglia l'approccio **Modello combinato**. Se si utilizza una logica di routing complessa o ci si connette a risorse esterne al AWS SAM modello, l'approccio basato su **modelli separati** è la scelta migliore.
**Topics**
+ [Modello combinato](#eb-combined-template)
+ [Modello separato](#eb-separated-template)
## Modello combinato
Il primo approccio utilizza la `Events` proprietà per configurare la EventBridge regola. Il codice di esempio seguente definisce un [evento](eb-events.md) che richiama la funzione Lambda.
**Nota**
Questo esempio crea automaticamente la regola sul [bus di eventi](eb-event-bus.md) predefinito, che esiste in ogni AWS account. Per associare la regola a un router di eventi personalizzato, puoi aggiungere `EventBusName` al modello.
```
atmConsumerCase3Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case3Handler
Runtime: nodejs12.x
Events:
Trigger:
Type: CloudWatchEvent
Properties:
Pattern:
source:
- custom.myATMapp
detail-type:
- transaction
detail:
result:
- "anything-but": "approved"
```
Questo codice YAML è equivalente a un pattern di eventi nella EventBridge console. In YAML, è sufficiente definire il modello di evento e creare AWS SAM automaticamente un ruolo IAM con le autorizzazioni richieste.
## Modello separato
Nel secondo approccio alla definizione di una EventBridge configurazione in AWS SAM, le risorse vengono separate più chiaramente nel modello.
1. Innanzitutto, definisci la funzione Lambda:
```
atmConsumerCase1Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case1Handler
Runtime: nodejs12.x
```
1. Successivamente, definisci la regola utilizzando una risorsa `AWS::Events::Rule`. Le proprietà definiscono il modello di eventi e possono anche specificare le [destinazioni](eb-targets.md). È possibile definire in modo esplicito più destinazioni.
```
EventRuleCase1:
Type: AWS::Events::Rule
Properties:
Description: "Approved transactions"
EventPattern:
source:
- "custom.myATMapp"
detail-type:
- transaction
detail:
result:
- "approved"
State: "ENABLED"
Targets:
-
Arn:
Fn::GetAtt:
- "atmConsumerCase1Fn"
- "Arn"
Id: "atmConsumerTarget1"
```
1. Infine, definisci una `AWS::Lambda::Permission` risorsa che conceda il permesso di EventBridge invocare l'obiettivo.
```
PermissionForEventsToInvokeLambda:
Type: AWS::Lambda::Permission
Properties:
FunctionName:
Ref: "atmConsumerCase1Fn"
Action: "lambda:InvokeFunction"
Principal: "events.amazonaws.com"
SourceArn:
Fn::GetAtt:
- "EventRuleCase1"
- "Arn"
```
# Generazione di un AWS CloudFormation modello da una regola esistente EventBridge
AWS CloudFormation consente di configurare e gestire AWS le risorse tra account e regioni in modo centralizzato e ripetibile trattando l'infrastruttura come codice. CloudFormation lo fa consentendoti di creare *modelli* che definiscono le risorse che desideri fornire e gestire.
EventBridge ti consente di generare modelli a partire dalle regole esistenti nel tuo account, come aiuto per iniziare subito a sviluppare modelli. CloudFormation Puoi selezionare una singola regola o più regole da includere nel modello. È quindi possibile utilizzare questi modelli come base per [creare pile](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) di risorse da gestire. CloudFormation
Per ulteriori informazioni, CloudFormation consulta la [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
**Nota**
EventBridge non include [regole gestite](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) nel modello generato.
Puoi anche [generare un modello da un router di eventi esistente](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-generate-event-bus-template.html), incluse le regole contenute nel router di eventi.
**Per generare un CloudFormation modello da una o più regole**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Nel riquadro di navigazione, scegli **Regole**.
1. In **Seleziona bus di eventi**, scegli il router di eventi che contiene le regole da includere nel modello.
1. In **Regole**, scegli le regole che desideri includere nel CloudFormation modello generato.
Per una singola regola, puoi anche scegliere il nome della regola per visualizzare la pagina dei dettagli della regola.
1. Scegli **CloudFormation Modello**, quindi scegli il formato in cui desideri EventBridge generare il modello: **JSON** o **YAML**.
EventBridge visualizza il modello, generato nel formato selezionato.
1. EventBridge offre la possibilità di scaricare il file modello o di copiare il modello negli appunti.
+ Per scaricare il file di modello, scegli **Scarica**.
+ Per copiare il modello negli appunti, scegli **Copia**.
1. Per uscire dal modello, scegli **Annulla**.
Dopo aver personalizzato il CloudFormation modello come necessario per il tuo caso d'uso, puoi utilizzarlo per [creare](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) pile in. CloudFormation
## Considerazioni sull'utilizzo di CloudFormation modelli generati da Amazon EventBridge
Quando utilizzi un CloudFormation modello generato da EventBridge te, considera i seguenti fattori:
+ EventBridge non include alcuna password nel modello generato.
Puoi modificare il modello per includere [parametri del modello](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) che consentono agli utenti di specificare password o altre informazioni riservate quando utilizzano il modello per creare o aggiornare uno stack CloudFormation.
Inoltre, gli utenti possono utilizzare Secrets Manager per creare un segreto nella Regione desiderata e quindi modificare il modello generato per utilizzare [parametri dinamici](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html#dynamic-references-secretsmanager).
+ Le destinazioni nel modello generato rimangono esattamente come specificate nel router di eventi originale. Se il modello non viene modificato in modo appropriato prima di utilizzarlo per creare stack in altre Regioni, è possibile che si abbiano problemi in più Regioni.
Inoltre, il modello generato non creerà automaticamente destinazioni a valle.