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
<a name="eb-create-rule-visual"></a>

## Prerequisiti
<a name="eb-create-rule-prerequisites"></a>

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
<a name="eb-create-rule-overview"></a>

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
<a name="eb-create-rule-source"></a>

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
<a name="eb-create-rule-event-pattern-visual"></a>

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)
<a name="eb-create-rule-event-pattern-steps"></a>

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
<a name="eb-create-rule-event-pattern-test"></a>

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)
<a name="eb-create-rule-event-pattern-test-steps"></a>

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
<a name="eb-create-rule-target-visual"></a>

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
<a name="eb-create-rule-target-transform"></a>

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)
<a name="eb-create-rule-target-transform-steps"></a>

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
<a name="eb-create-rule-configure"></a>

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
<a name="eb-create-rule-next-steps"></a>

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
<a name="eb-create-rule-additional-resources"></a>

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)