Tutorial: usa i trasformatori di input per trasformare gli eventi in 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à.

Tutorial: usa i trasformatori di input per trasformare gli eventi in EventBridge

Puoi utilizzare il trasformatore di input EventBridge per personalizzare il testo di un evento prima di inviarlo alla destinazione di una regola.

A tale scopo, definite i JSON percorsi a partire dall'evento e assegnate i relativi output a diverse variabili. 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

Nota

Se specificate una variabile in modo che corrisponda a un JSON percorso 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 type variabile sul percorso $.detail-type JSON dell'evento. <type>Quindi EventBridge inserisce la variabile nel modello di input «Questo evento è stato». Il risultato è il seguente SNS messaggio Amazon.

"This event was of customerCreated type."

Passaggio 1: creare un SNS argomento Amazon

Crea un argomento da cui ricevere gli eventi EventBridge.

Per creare un argomento
  1. Apri la SNS console Amazon su https://console.aws.amazon.com/sns/v3/home.

  2. Nel pannello di navigazione, scegli Topics (Argomenti).

  3. Scegli Create topic (Crea argomento).

  4. Per Tipo, scegliere Standard.

  5. Immetti eventbridge-IT-test come nome dell'argomento.

  6. Scegli Create topic (Crea argomento).

Passaggio 2: creare un SNS abbonamento Amazon

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

Creazione di una sottoscrizione
  1. Apri la SNS console Amazon su https://console.aws.amazon.com/sns/v3/home.

  2. Nel riquadro di navigazione scegliere Subscriptions (Iscrizioni).

  3. Scegli Crea sottoscrizione.

  4. Per Argomento ARN, scegli l'argomento che hai creato nel passaggio 1. Per questo tutorial, scegli eventbridge-IT-test.

  5. Per Protocollo, scegli E-mail.

  6. Per Endpoint, immettere il proprio indirizzo e-mail.

  7. Scegli Crea sottoscrizione.

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

Passaggio 3: creare una regola

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

  2. Nel pannello di navigazione, scegli Regole.

  3. Scegli Create rule (Crea regola).

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

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

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

  7. Seleziona Successivo.

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

  9. In Modello di eventi, immetti quanto segue:

    { "detail-type": [ "customerCreated" ] }
  10. Seleziona Successivo.

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

  12. Per Seleziona un obiettivo, scegli l'SNSargomento dall'elenco a discesa.

  13. Per Argomento, seleziona l'SNSargomento Amazon che hai creato nel passaggio 1. Per questo tutorial, scegli eventbridge-IT-test.

  14. In Impostazioni aggiuntive, procedi come segue:

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

    2. Scegli Configura il trasformatore di input.

    3. In Eventi di esempio, immetti quanto segue:

      { "detail-type": "customerCreated" }
    4. In Trasformatore di input di destinazione, procedi come segue:

      1. In Percorso di input, immetti quanto segue:

        {"detail-type":"$.detail-type"}
      2. In Modello di input, immetti quanto segue:

        "This event was of <detail-type> type."
    5. Scegli Conferma.

  15. Seleziona Successivo.

  16. Seleziona Successivo.

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

Passaggio 4: inviare eventi di test

Ora che hai impostato l'SNSargomento e la regola, invieremo gli 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/.

  2. Nel riquadro di navigazione, scegliere Event history (Cronologia eventi).

  3. Nel riquadro Bus di eventi predefinito, scegli Azioni, Invia eventi.

  4. Immetti un'origine per gli eventi. Ad esempio, TestEvent.

  5. In Tipo di dettaglio, immetti customerCreated.

  6. In dettagli dell'evento, immetti {}.

  7. Scegli Invia.

Passaggio 5: verificare il corretto completamento del tutorial

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

Fase 6: eliminare le risorse

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 della SNS console.

  2. Seleziona l'argomento creato.

  3. Scegli Elimina.

  4. Specificare delete me.

  5. Scegli Elimina.

Per eliminare l'SNSabbonamento
  1. Apri la pagina Abbonamenti della SNS console.

  2. Seleziona la sottoscrizione creata.

  3. Scegliere Delete (Elimina).

  4. Scegliere Delete (Elimina).

Per eliminare le EventBridge regole
  1. Apri la pagina Regole della EventBridge console.

  2. Seleziona la regola che hai creato.

  3. Scegliere Delete (Elimina).

  4. Scegli Delete (Elimina).