Test di un pattern di eventi utilizzando la Sandbox EventBridge

Le regole utilizzano modelli di eventi per selezionare eventi e inviarli alle destinazioni. I modelli di eventi hanno la stessa struttura degli eventi a cui corrispondono. Un modello di eventi può corrispondere o meno a un evento.

La definizione di un modello di eventi fa in genere parte del processo più ampio di creazione di una nuova regola o di modifica di una regola esistente. Utilizzando la Sandbox in EventBridge, tuttavia, è possibile definire rapidamente un pattern di eventi e utilizzare un evento di esempio per confermare che il pattern corrisponda agli eventi desiderati, senza dover creare o modificare una regola. Dopo aver testato il modello di evento, EventBridge avrai la possibilità di creare una nuova regola utilizzando quel modello di evento direttamente dalla sandbox.

Per ulteriori informazioni sui modelli di eventi, consulta Modelli di EventBridge eventi Amazon.

Importante

Inoltre EventBridge, è possibile creare regole che possono comportare higher-than-expected addebiti e limitazioni. Ad esempio, puoi creare inavvertitamente una regola che genera un ciclo infinito, in cui una regola viene attivata in modo ricorsivo senza fine. Ad esempio, hai creato una regola per rilevare eventuali modifiche alle liste di controllo degli accessi (ACL) in un bucket S3 e attivare un programma software che le imposti sullo stato desiderato. Se la regola non è scritta con attenzione, la successiva modifica alle ACL la riattiva, creando un loop infinito.

Per indicazioni su come scrivere regole e modelli di eventi precisi per ridurre al minimo tali risultati imprevisti, consulta Best practice per la definizione di regole Amazon EventBridge e Le migliori pratiche per la definizione dei modelli di EventBridge eventi Amazon.

Per testare un pattern di eventi utilizzando la sandbox EventBridge

1. Apri la EventBridge console Amazon all'indirizzo https://console.aws.amazon.com/events/.

2. Nel riquadro di navigazione, scegli Risorse per gli sviluppatori, quindi seleziona Sandbox e nella pagina Sandbox scegli la scheda Modello di eventi.

3. Per Event source, scegli AWS eventi o eventi EventBridge partner.

4. Nella sezione Eventi di esempio, scegli un Tipo evento di esempio in base al quale desideri testare 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.

     2. Nell'elenco a discesa Eventi di esempio, seleziona l'evento da utilizzare come riferimento per l'evento personalizzato.

        EventBridge visualizza l'evento di esempio.

     3. Seleziona Copia.

     4. Seleziona Inserisci il mio in Tipo di evento.

     5. Elimina la struttura degli eventi di esempio nel riquadro di modifica JSON e incolla l'evento AWS o il partner al suo posto.

     6. Modifica il testo JSON dell'evento per creare il tuo evento di esempio.

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

   2. Nella sezione Modello di eventi, in Tipo di schema, seleziona Seleziona lo schema dal registro schemi.

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

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

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

   6. Scegli Genera un modello di eventi in JSON per generare e convalidare il modello di eventi come testo JSON.

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

   2. Nella sezione Modello di eventi, in Tipo di schema, scegli Inserisci schema.

   3. Immetti lo schema nella casella di testo. Devi formattarlo come testo JSON valido.

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

   5. Scegli Genera un modello di eventi in JSON per generare e convalidare il modello di eventi come testo JSON.

   6. 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).

   2. In Modello di eventi, immetti il modello di eventi personalizzato in testo in formato JSON.

   3. 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 di aprire Pattern Builder.

6. (Facoltativo) Per creare una regola con questo modello di eventi e assegnarla a un router di eventi specifico, scegli Creazione di una regola con modello.

   EventBridge ti porta alla Fase 1 di Create rule, che puoi usare per creare una regola e assegnarla al bus di eventi di tua scelta.

   Nota che la sezione Passaggio 2: creare un modello di eventi contiene le informazioni sul modello di eventi che hai già specificato e che puoi accettare o aggiornare.

   Per ulteriori informazioni su come creare regole, consulta Creazione di regole Amazon EventBridge che reagiscono agli eventi.