Creazione di una regola Amazon EventBridge eseguita in base a una pianificazione - Amazon EventBridge
Creazione di una regola eseguita in base a una pianificazione

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 una regola Amazon EventBridge eseguita in base a una pianificazione

Una regola può essere eseguita in risposta a un evento o a determinati intervalli di tempo. Ad esempio, per eseguire periodicamente una funzione AWS Lambda, puoi creare una regola eseguita in base a una pianificazione.

Nota

EventBridge offre Pianificatore Amazon EventBridge, un pianficatore serverless che ti consente di creare, eseguire e gestire attività da un unico servizio gestito centralizzato. Pianificatore EventBridge è un servizio altamente personalizzabile che offre una migliore scalabilità rispetto alle regole pianificate EventBridge, con una gamma più ampia di operazioni API e servizi AWS di destinazione.

Ti consigliamo di utilizzare il Pianificatore EventBridge per richiamare le destinazioni su una pianificazione. Per ulteriori informazioni, consulta Utilizzo di Pianificatore Amazon EventBridge con Amazon EventBridge.

In EventBridge, è possibile creare due tipi di regole pianificate:

  • Regole che vengono eseguite a una frequenza regolare

    EventBridge esegue queste regole a intervalli regolari, ad esempio ogni 20 minuti.

    Per specificare la frequenza per una regola pianificata, devi definire un'espressione della frequenza.

  • Regole che vengono eseguite in orari specifici

    EventBridge esegue queste regole in orari e date specifici, ad esempio, alle 8:00. PST il primo lunedì di ogni mese.

    Per specificare l'ora e le date di esecuzione di una regola pianificata, si definisce un'espressione Cron.

Le espressioni della frequenza sono più semplici da definire, mentre le espressioni Cron offrono un controllo dettagliato della pianificazione. Ad esempio, con un'espressione Cron, puoi definire una regola che viene eseguita a una determinata ora di un giorno specifico di ciascuna settimana o mese. Al contrario, le espressioni della frequenza eseguono una regola a intervalli regolari, ad esempio una volta all'ora o una volta al giorno.

Tutte gli eventi pianificati utilizzano il fuso orario UTC+0 e la precisione minima per le pianificazioni è un minuto.

Nota

EventBridge non fornisce precisione a livello di secondo nelle espressioni di pianificazione. La risoluzione più alta che utilizza un'espressione Cron è un minuto. A causa della natura distribuita di EventBridge e dei servizi di destinazione, è possibile che vi sia un ritardo di vari secondi tra il momento in cui la regola pianificata viene attivata e il momento in cui il servizio di destinazione esegue la risorsa di destinazione.

Il video seguente fornisce una panoramica delle attività di pianificazione:

Argomenti

Creazione di una regola eseguita in base a una pianificazione

I passaggi seguenti illustrano come creare una regola EventBridge che viene eseguita in base a una pianificazione regolare.

Nota

Puoi creare regole pianificate solo utilizzando il router di eventi predefinito.

Definizione della regola

Innanzitutto, immetti un nome e una descrizione per la regola in modo da identificarla.

Per definire i dettagli della regola

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

  2. Nel pannello di navigazione, scegliere Rules (Regole).

  3. Scegli Create rule (Crea regola).

  4. 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 nella stessa Regione AWS e sullo stesso bus di eventi.

  5. In Router di eventi, scegli il router di eventi predefinito. Puoi creare regole pianificate solo utilizzando il router di eventi predefinito.

  6. Affinché la regola abbia effetto non appena la crei, assicurati che l'opzione Abilita la regola sul bus di eventi selezionato sia abilitata.

  7. Per Rule type (Tipo di regola), scegli Schedule (Pianifica).

    A questo punto, puoi scegliere di continuare a creare una regola che viene eseguita in base a una pianificazione oppure utilizzare Pianificatore Amazon EventBridge.

  8. Scegli come vuoi continuare:

    • Utilizza Pianificatore EventBridge per creare la pianificazione

      Nota

      Pianificatore EventBridge è un pianificatore serverless che ti consente di creare, eseguire e gestire attività da un unico servizio gestito centralizzato. Offre funzionalità di pianificazione una tantum e ricorrenti che non dipendono da regole e router di eventi. Pianificatore EventBridge è un servizio altamente personalizzabile che offre una migliore scalabilità rispetto alle regole pianificate EventBridge, con una gamma più ampia di operazioni API e servizi AWS di destinazione.

      Ti consigliamo di utilizzare il Pianificatore EventBridge per richiamare le destinazioni su una pianificazione. Per ulteriori informazioni, consulta Che cos'è Pianificatore Amazon EventBridge? nella Guida per l'utente di Pianificatore Amazon EventBridge.

      1. Seleziona Continua nel pianificatore EventBridge

        EventBridge apre la pagina Crea pianificazione nella console Pianificatore EventBridge.

      2. Crea la pianificazione nella console Pianificatore EventBridge.

    • Continua a utilizzare EventBridge per creare una regola pianificata per il router di eventi predefinito

      1. Seleziona Continua per creare una regola.

Definizione della pianificazione

Ora è necessario definire il modello di pianificazione.

Per definire il modello di pianificazione

  1. In Modello di pianificazione, scegli se eseguire la pianificazione venga eseguita a un orario specifico o a una frequenza normale:

    Specific time

    1. Scegli Una pianificazione dettagliata che viene eseguita a un'ora specifica, ad esempio alle 8:00. PST il primo lunedì di ogni mese.

    2. In Espressione cron, specifica i campi per definire l'espressione Cron che EventBridge deve utilizzare per determinare quando eseguire questa regola pianificata.

      Dopo aver specificato tutti i campi, EventBridge mostra le dieci date successive in cui EventBridge eseguirà la regola pianificata. Puoi scegliere se visualizzare tali date nel fuso orario UTC o nel Fuso orario locale.

      Per ulteriori informazioni sulla creazione di un'espressione Cron, consulta Riferimento alle espressioni Cron.

    Regular rate

    1. Scegli Una pianificazione che viene eseguita a una frequenza regolare, ad esempio ogni 10 minuti.

    2. In Espressione rate, specifica i campi Valore e Unità per definire la frequenza alla quale EventBridge deve eseguire questa regola pianificata.

      Per ulteriori informazioni sulla creazione di un'espressione della frequenza, consulta Riferimento alle espressioni della frequenza.

  2. Scegli Successivo.

Selezionare le destinazioni

Scegli una o più destinazioni per ricevere eventi che corrispondono al modello specificato. Le destinazioni possono includere un router di eventi EventBridge, destinazioni API di EventBridge, inclusi partner SaaS come Salesforce, o un altro Servizio AWS.

Per selezionare le destinazioni

  1. In Tipi di destinazione, scegli uno dei seguenti tipi di destinazione:

    Event bus

    Per selezionare un router di eventi EventBridge, seleziona Bus di eventi EventBridge, quindi procedi come segue:

    API destination

    Per utilizzare una destinazione API di EventBridge, seleziona Destinazione API di EventBridge, quindi esegui una delle seguenti operazioni:

    • Per utilizzare una destinazione API esistente, seleziona Utilizza una destinazione API esistente. Quindi seleziona una destinazione API dall'elenco a discesa.

    • Per creare una nuova destinazione API, seleziona Crea una nuova destinazione API. Fornisci quindi i seguenti dettagli per la destinazione:

      • Nome: immetti un nome per la destinazione.

        I nomi devono essere univoci nel tuo Account AWS. I nomi possono avere fino a 64 caratteri. I caratteri validi sono A-Z, a-z, 0-9 e . _ - (trattino).

      • (Facoltativo) Descrizione: immetti una descrizione per la destinazione.

        La descrizione può avere un massimo di 512 caratteri.

      • Endpoint di destinazione API: l'endpoint URL per la destinazione.

        L'URL dell'endpoint deve iniziare con https. Puoi includere il carattere jolly * come parametro di percorso. Puoi impostare i parametri di percorso dall'attributo HttpParameters della destinazione.

      • Metodo HTTP: seleziona il metodo HTTP utilizzato quando richiami l'endpoint.

      • (Facoltativo) Limite di velocità di invocazione al secondo: immetti il numero massimo di invocazioni accettate al secondo per la destinazione.

        Questo valore deve essere maggiore di zero. Per impostazione predefinita, è 300.

      • Connessione: scegli questa opzione per utilizzare una connessione nuova o esistente:

        • Per utilizzare una connessione esistente, seleziona Utilizza una connessione esistente e seleziona la connessione dall'elenco a discesa.

        • Per creare una nuova connessione per questa destinazione, seleziona Crea una nuova connessione, quindi definisci Nome, Tipo di destinazione e Tipo di autorizzazione della connessione. Eventualmente, puoi anche aggiungere una Descrizione per la connessione.

    Per ulteriori informazioni, consulta Destinazioni API.

    Servizio AWS

    Per utilizzare un Servizio AWS, seleziona Servizio AWS, quindi procedi come segue:

    1. In Seleziona una destinazione, seleziona un Servizio AWS da utilizzare come destinazione. Fornisci le informazioni richieste per il servizio selezionato.

      Nota

      I campi visualizzati variano a seconda del servizio selezionato. Per ulteriori informazioni sulle destinazioni disponibili, consulta Obiettivi disponibili nella EventBridge console.

  2. Per molti tipi di destinazione, EventBridge necessita di autorizzazioni per l'invio degli eventi alla destinazione. In questi casi, EventBridge è in grado di creare il ruolo IAM necessario per l'esecuzione della regola.

    In Ruolo di esecuzione, esegui una delle seguenti operazioni:

    • Per creare un nuovo ruolo di esecuzione per questa regola:

      1. Seleziona Crea un nuovo ruolo per questa risorsa specifica.

      2. Immetti un nome per questo ruolo di esecuzione o utilizza il nome generato da EventBridge.

    • Per utilizzare un ruolo di esecuzione esistente per questa regola:

      1. Seleziona Utilizza un ruolo esistente.

      2. Immetti o seleziona il nome del ruolo di esecuzione da utilizzare dall'elenco a discesa.

  3. (Facoltativo) In Impostazioni aggiuntive, specifica una delle impostazioni facoltative disponibili per il tipo di destinazione:

    Event bus

    (Facoltativo) In Coda DLQ scegli se utilizzare una coda Amazon SQS standard come coda DLQ. EventBridge invia eventi che corrispondono a questa regola alla coda DLQ se non vengono recapitati correttamente alla destinazione. Completa una delle seguenti operazioni:

    • Scegli Nessuna per non utilizzare una coda DLQ.

    • Scegli Seleziona una coda Amazon SQS nell'account AWS corrente da utilizzare come coda DLQ, quindi seleziona la coda da utilizzare dal menu a discesa.

    • Scegli Seleziona una coda Amazon SQS in un altro account AWS come coda DLQ e specifica l'ARN della coda da utilizzare. È necessario collegare alla coda una policy basata su risorse che concede l'autorizzazione EventBridge per l'invio di messaggi.

      Per ulteriori informazioni, consulta Concessione delle autorizzazioni per la coda DLQ.

    API destination

    1. (Facoltativo) In Configura l'input di destinazione, scegli come personalizzare il testo inviato alla destinazione per gli eventi corrispondenti. Scegli una delle seguenti opzioni:

      • Eventi corrispondenti: EventBridge invia l'intero evento di origine originale alla destinazione. Questa è l'impostazione predefinita.

      • Parte degli eventi corrispondenti: EventBridge invia solo la parte specificata dell'evento di origine originale alla destinazione.

        In Specifica la parte dell'evento corrispondente, specifica un percorso JSON che definisce la parte dell'evento che EventBridge deve inviare alla destinazione.

      • Costante (testo JSON): EventBridge invia solo il testo JSON specificato alla destinazione. Non viene inviata alcuna parte dell'evento di origine originale.

        In Specifica la costante in JSON, specifica il testo JSON che EventBridge deve inviare alla destinazione anziché all'evento.

      • Trasformatore di input: configura un trasformatore di input per personalizzare il testo che EventBridge deve inviare alla destinazione. Per ulteriori informazioni, consulta Trasformazione degli EventBridge input di Amazon.

        1. Seleziona Configura il trasformatore di input.

        2. Configura il trasformatore di input seguendo la procedura descritta in Configurazione di un trasformatore di input come parte della creazione di una regola.

    2. (Facoltativo) In Policy di ripetizione, specifica in che modo EventBridge deve ritentare l'invio di un evento a una destinazione dopo che si è verificato un errore.

      • Durata massima dell'evento: immetti il periodo di tempo massimo (in ore, minuti e secondi) durante il quale EventBridge deve mantenere gli eventi non elaborati. Il valore predefinito è 24 ore.

      • Nuovi tentativi: immetti il numero massimo di volte in cui EventBridge deve riprovare a inviare un evento alla destinazione dopo che si è verificato un errore. L'impostazione predefinita è 185 volte.

    3. (Facoltativo) In Coda DLQ scegli se utilizzare una coda Amazon SQS standard come coda DLQ. EventBridge invia eventi che corrispondono a questa regola alla coda DLQ se non vengono recapitati correttamente alla destinazione. Completa una delle seguenti operazioni:

      • Scegli Nessuna per non utilizzare una coda DLQ.

      • Scegli Seleziona una coda Amazon SQS nell'account AWS corrente da utilizzare come coda DLQ, quindi seleziona la coda da utilizzare dal menu a discesa.

      • Scegli Seleziona una coda Amazon SQS in un altro account AWS come coda DLQ e specifica l'ARN della coda da utilizzare. È necessario collegare alla coda una policy basata su risorse che concede l'autorizzazione EventBridge per l'invio di messaggi.

        Per ulteriori informazioni, consulta Concessione delle autorizzazioni per la coda DLQ.

    AWS service

    Tieni presente che EventBridge potrebbe non visualizzare tutti i seguenti campi per un determinato servizio AWS.

    1. (Facoltativo) In Configura l'input di destinazione, scegli come personalizzare il testo inviato alla destinazione per gli eventi corrispondenti. Scegli una delle seguenti opzioni:

      • Eventi corrispondenti: EventBridge invia l'intero evento di origine originale alla destinazione. Questa è l'impostazione predefinita.

      • Parte degli eventi corrispondenti: EventBridge invia solo la parte specificata dell'evento di origine originale alla destinazione.

        In Specifica la parte dell'evento corrispondente, specifica un percorso JSON che definisce la parte dell'evento che EventBridge deve inviare alla destinazione.

      • Costante (testo JSON): EventBridge invia solo il testo JSON specificato alla destinazione. Non viene inviata alcuna parte dell'evento di origine originale.

        In Specifica la costante in JSON, specifica il testo JSON che EventBridge deve inviare alla destinazione anziché all'evento.

      • Trasformatore di input: configura un trasformatore di input per personalizzare il testo che EventBridge deve inviare alla destinazione. Per ulteriori informazioni, consulta Trasformazione degli EventBridge input di Amazon.

        1. Seleziona Configura il trasformatore di input.

        2. Configura il trasformatore di input seguendo la procedura descritta in Configurazione di un trasformatore di input come parte della creazione di una regola.

    2. (Facoltativo) In Policy di ripetizione, specifica in che modo EventBridge deve ritentare l'invio di un evento a una destinazione dopo che si è verificato un errore.

      • Durata massima dell'evento: immetti il periodo di tempo massimo (in ore, minuti e secondi) durante il quale EventBridge deve mantenere gli eventi non elaborati. Il valore predefinito è 24 ore.

      • Nuovi tentativi: immetti il numero massimo di volte in cui EventBridge deve riprovare a inviare un evento alla destinazione dopo che si è verificato un errore. L'impostazione predefinita è 185 volte.

    3. (Facoltativo) In Coda DLQ scegli se utilizzare una coda Amazon SQS standard come coda DLQ. EventBridge invia eventi che corrispondono a questa regola alla coda DLQ se non vengono recapitati correttamente alla destinazione. Completa una delle seguenti operazioni:

      • Scegli Nessuna per non utilizzare una coda DLQ.

      • Scegli Seleziona una coda Amazon SQS nell'account AWS corrente da utilizzare come coda DLQ, quindi seleziona la coda da utilizzare dal menu a discesa.

      • Scegli Seleziona una coda Amazon SQS in un altro account AWS come coda DLQ e specifica l'ARN della coda da utilizzare. È necessario collegare alla coda una policy basata su risorse che concede l'autorizzazione EventBridge per l'invio di messaggi.

        Per ulteriori informazioni, consulta Concessione delle autorizzazioni per la coda DLQ.

  4. (Facoltativo) Scegli Aggiungi un'altra destinazione per aggiungere un'altra destinazione per questa regola.

  5. Scegli Successivo.

Configurazione di tag e revisione della regola

Infine, immetti i tag desiderati per la regola, quindi rivedi e crea la regola.

Per configurare i tag e rivedere e creare la regola

  1. (Facoltativo) Inserire uno o più tag per la regola. Per ulteriori informazioni, consulta EventBridge Etichette Amazon.

  2. Scegli Successivo.

  3. Rivedi i dettagli della nuova regola. Per apportare modifiche a una qualsiasi sezione, scegli il pulsante Modifica accanto alla sezione in questione.

    Quando sei soddisfatto dei dettagli della regola, scegli Crea regola.