Configurazione di un trasformatore di input come parte della creazione di una regola

Come parte della creazione di una regola, è possibile specificare un trasformatore di input EventBridge da utilizzare per elaborare gli eventi di corrispondenza prima di inviarli alla destinazione specificata. È possibile configurare trasformatori di input per destinazioni che sono AWS servizi o destinazioni API.

Per creare un trasformatore di input di destinazione come parte di una regola

1. Segui i passaggi per creare una regola come descritto in Creazione di regole Amazon EventBridge che reagiscono agli eventi.

2. In Passaggio 3: selezionare le destinazioni, espandi Impostazioni aggiuntive.

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

   Fai clic su Configura il trasformatore di input.

   EventBridge visualizza la finestra di dialogo Configura trasformatore di ingresso.

4. Nella sezione Evento di esempio, scegli un Tipo evento di esempio in base al quale desideri testare il modello di eventi. Puoi scegliere un AWS evento, un evento partner o inserire il tuo evento personalizzato.

   AWS events

   Seleziona uno degli eventi emessi dai Servizi AWS supportati.

   1. Seleziona Eventi AWS .

   2. In Eventi di esempio, scegli l' AWS evento desiderato. Gli eventi sono organizzati per AWS servizio.

      Quando si seleziona un evento, EventBridge compila l'evento di esempio.

      Ad esempio, se scegliete S3 Object Created, EventBridge visualizza un esempio di evento S3 Object Created.

   3. (Facoltativo) Puoi anche selezionare Copia per copiare l'evento di esempio negli appunti del dispositivo.

   Partner events

   Seleziona tra gli eventi emessi da servizi di terze parti che supportano EventBridge, come Salesforce.

   1. Seleziona EventBridge gli eventi dei partner.

   2. In Eventi di esempio, scegli l'evento partner desiderato. Gli eventi sono organizzati per partner.

      Quando si seleziona un evento, EventBridge compila l'evento di esempio.

   3. (Facoltativo) Puoi anche selezionare Copia per copiare l'evento di esempio negli appunti del dispositivo.

   Enter your own

   Immetti il tuo evento in formato JSON.

   1. Seleziona Inserisci il mio.

   2. EventBridge compila l'evento di esempio con un modello di attributi di evento obbligatori.

   3. Modifica e aggiungi all'evento di esempio come desiderato. L'evento di esempio deve essere JSON valido.

   4. (Facoltativo) È 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.

5. (Facoltativo) Espandi la sezione Esempi di percorsi di input, modelli e output per visualizzare esempi di:

   • Come vengono utilizzati i percorsi JSON per definire variabili che rappresentano i dati degli eventi

   • Come possono essere utilizzate queste variabili in un modello di trasformatore di input

   • L'output risultante che EventBridge viene inviato alla destinazione

   Per esempi più dettagliati di trasformazioni di input, consulta Esempi di trasformazione di input.

6. Nella sezione Transformatore di input di destinazione, definisci le variabili che desideri utilizzare nel modello di input.

   Le variabili utilizzano il percorso JSON per fare riferimento ai valori nell'origine dell'evento originale. È quindi possibile fare riferimento a tali variabili nel modello di input per includere i dati dell'evento di origine originale nell'evento trasformato che EventBridge passa alla destinazione. Puoi definire fino a 100 variabili. Il trasformatore di input deve essere in formato JSON valido.

   Ad esempio, supponete di aver scelto l' AWS evento S3 Object Created come evento di esempio per questo trasformatore di input. Puoi quindi definire le seguenti variabili da utilizzare nel modello:

   {
     "requester": "$.detail.requester",
     "key": "$.detail.object.key",
     "bucket": "$.detail.bucket.name"
   }

   (Facoltativo) Puoi anche scegliere Copia per copiare il trasformatore di input negli appunti del tuo dispositivo.

7. Nella sezione Modello, componi il modello che desideri utilizzare per determinare cosa EventBridge passare al bersaglio.

   Puoi usare JSON, stringhe, informazioni statiche, variabili che hai definito e variabili riservate. Per esempi più dettagliati di trasformazioni di input, consulta Esempi di trasformazione di input.

   Ad esempio, supponiamo che hai definito le variabili nell'esempio precedente. È quindi possibile comporre il seguente modello, che fa riferimento a tali variabili, nonché a variabili riservate e ad informazioni statiche.

   {
       "message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
       "RuleName": <aws.events.rule-name>,
       "ruleArn" : <aws.events.rule-arn>,
       "Transformed": "Yes"
   }

   (Facoltativo) Puoi anche scegliere Copia per copiare il modello negli appunti del tuo dispositivo.

8. Per testare il modello, seleziona Genera output.

   EventBridge elabora l'evento di esempio in base al modello di input e visualizza l'output trasformato generato in Output. Queste sono le informazioni che EventBridge verranno passate alla destinazione al posto dell'evento di origine originale.

   L'output generato per il modello di input di esempio descritto sopra sarebbe il come segue:

   {
       "message": "123456789012 has created the object "example-key" in the bucket "example-bucket"",
       "RuleName": rule-name,
       "ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
       "Transformed": "Yes"
   }

   (Facoltativo) Puoi anche scegliere Copia per copiare l'output generato negli appunti del tuo dispositivo.

9. Seleziona Conferma.

10. Segui gli altri passaggi per creare una regola come descritto in Creazione di regole Amazon EventBridge che reagiscono agli eventi.