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

# Tutorial: usa i trasformatori di input per trasformare gli eventi in EventBridge
<a name="eb-input-transformer-tutorial"></a>

[Puoi utilizzare il [trasformatore di input](eb-transform-target-input.md) EventBridge per personalizzare il testo di un [evento](eb-events.md) prima di inviarlo alla destinazione di una regola.](eb-rules.md) 

A questo proposito, definisci percorsi JSON dall'evento e assegni i relativi output a variabili diverse. Puoi quindi utilizzare quelle variabili nel modello di input. I caratteri < and > non possono avere caratteri di escape. Per ulteriori informazioni, consulta [Trasformazione degli EventBridge input di Amazon](eb-transform-target-input.md)

**Nota**  
Se specifichi una variabile per abbinare un percorso JSON che non esiste nell'evento, quella variabile non viene creata e non appare nell'output.

In questo tutorial, crei una regola che corrisponde a un evento con `detail-type: "customerCreated"`. Il trasformatore di input mappa la variabile `type` al percorso JSON \$1.detail-type dall'evento. Quindi EventBridge inserisce la variabile nel modello di input «Questo evento è stato»<type>. Il risultato è il seguente messaggio di Amazon SNS.

```
"This event was of customerCreated type."
```

**Topics**
+ [Passaggio 1: creare un argomento Amazon SNS](#eb-input-transformer-tutorial-create-topic)
+ [Passaggio 2: creare una sottoscrizione Amazon SNS](#eb-input-transformer-tutorial-create-sns)
+ [Passaggio 3: creare una regola](#eb-input-transformer-create-rule)
+ [Passaggio 4: inviare eventi di test](#eb-input-transformer-send-test-events)
+ [Passaggio 5: verificare il corretto completamento del tutorial](#success)
+ [Fase 6: eliminare le risorse](#cleanup)

## Passaggio 1: creare un argomento Amazon SNS
<a name="eb-input-transformer-tutorial-create-topic"></a>

Crea un argomento da cui ricevere gli eventi EventBridge.

**Per creare un argomento**

1. [Apri la console Amazon SNS nella versione v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)

1. Nel pannello di navigazione, scegli **Topics** (Argomenti).

1. Scegli **Create topic** (Crea argomento).

1. Per **Tipo**, scegliere **Standard**.

1. Immetti **eventbridge-IT-test** come nome dell'argomento.

1. Scegli **Create topic** (Crea argomento).

## Passaggio 2: creare una sottoscrizione Amazon SNS
<a name="eb-input-transformer-tutorial-create-sns"></a>

Creazione di una sottoscrizione per ricevere e-mail con le informazioni trasformate.

**Creazione di una sottoscrizione**

1. [Apri la console Amazon SNS nella versione v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)

1. Nel riquadro di navigazione scegliere **Subscriptions (Iscrizioni)**.

1. Scegli **Crea sottoscrizione**.

1. In **ARN argomento**, scegli l'argomento creato in Passaggio 1. Per questo tutorial, scegli **eventbridge-IT-test**.

1. Per **Protocollo**, scegli **E-mail**.

1. Per **Endpoint**, immettere il proprio indirizzo e-mail.

1. Scegli **Crea sottoscrizione**.

1. Conferma la sottoscrizione scegliendo **Conferma sottoscrizione** nell'e-mail che ricevi dalle notifiche AWS .

## Passaggio 3: creare una regola
<a name="eb-input-transformer-create-rule"></a>

Crea una regola per utilizzare il trasformatore di input per personalizzare le informazioni sullo stato dell'istanza inviate a una destinazione.

**Per creare una 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 **Create rule** (Crea regola).

1. Immettere un nome e una descrizione per la regola. Ad esempio, assegnale il nome `ARTestRule`.

1. Per **Select event bus** (Seleziona bus di eventi), scegli il bus di eventi che desideri associare a questa regola. Se vuoi che questa regola corrisponda agli eventi provenienti dal tuo account, seleziona **Predefinito**. Quando un servizio di AWS nell'account emette un evento, passa sempre al bus di eventi predefinito dell'account.

1. Per **Rule type** (Tipo di regola), scegli **Rule with an event pattern** (Regola con un modello di eventi).

1. Scegli **Next (Successivo)**.

1. In **Event source** (Origine eventi), scegli **Other** (Altro).

1. In **Modello di eventi**, immetti quanto segue:

   ```
   {
     "detail-type": [
       "customerCreated"
     ]
   }
   ```

1. Scegli **Next (Successivo)**.

1. Per **Target types** (Tipi di destinazione), scegli **AWS service** (Servizio ).

1. In **Seleziona una destinazione**, scegli l'**argomento SNS** dall'elenco a discesa.

1. In **Argomento**, seleziona l'argomento Amazon SNS che hai creato in Passaggio 1. Per questo tutorial, scegli **eventbridge-IT-test**.

1. In **Impostazioni aggiuntive**, procedi come segue:

   1. In **Configura l'input di destinazione**, scegli **Trasformatore di input** dall'elenco a discesa.

   1. Scegli **Configura il trasformatore di input**.

   1. In **Eventi di esempio**, immetti quanto segue:

      ```
      {
        "detail-type": "customerCreated"
      }
      ```

   1. In **Trasformatore di input di destinazione**, procedi come segue:

      1. In **Percorso di input**, immetti quanto segue:

         ```
         {"detail-type":"$.detail-type"}
         ```

      1. In **Modello di input**, immetti quanto segue:

         ```
         "This event was of <detail-type> type."
         ```

   1. Scegli **Conferma**.

1. Scegli **Next (Successivo)**.

1. Scegli **Next (Successivo)**.

1. Rivedi i dettagli della regola e scegli **Create rule** (Crea regola).

## Passaggio 4: inviare eventi di test
<a name="eb-input-transformer-send-test-events"></a>

Ora che hai impostato l'argomento SNS e la regola, invieremo eventi di test per assicurarci che la regola funzioni correttamente.

**Per inviare eventi di test (console)**

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, scegliere **Event history (Cronologia eventi)**.

1. Nel riquadro **Bus di eventi predefinito**, scegli **Azioni**, **Invia eventi**.

1. Immetti un'origine per gli eventi. Ad esempio `TestEvent`.

1. In **Tipo di dettaglio**, immetti `customerCreated`.

1. In **dettagli dell'evento**, immetti `{}`.

1. Scegli **Invia**.

## Passaggio 5: verificare il corretto completamento del tutorial
<a name="success"></a>

Se ricevi un'e-mail dalle AWS notifiche che corrisponde all'output previsto, hai completato con successo il tutorial.

## Fase 6: eliminare le risorse
<a name="cleanup"></a>

Ora è possibile eliminare le risorse create per questo tutorial, a meno che non si voglia conservarle. Eliminando AWS le risorse che non utilizzi più, eviti addebiti inutili sul tuo AWS account.

**Per eliminare l'argomento SNS**

1. Apri la [pagina Argomenti](https://console.aws.amazon.com/sns/v3/home#/topics) nella console SNS.

1. Seleziona l'argomento creato.

1. Scegli **Elimina**.

1. Specificare **delete me**.

1. Scegli **Elimina**.

**Per eliminare la sottoscrizione SNS**

1. Apri la [pagina Sottoscrizioni](https://console.aws.amazon.com/sns/v3/home#/subscriptions) della console SNS.

1. Seleziona la sottoscrizione creata.

1. Scegli **Elimina**.

1. Scegli **Elimina**.

**Per eliminare la/le EventBridge regola/e**

1. Apri la [pagina Regole](https://console.aws.amazon.com/events/home#/rules) della EventBridge console.

1. Seleziona la regola che hai creato.

1. Scegli **Elimina**.

1. Scegli **Delete** (Elimina).