Creazione di una EventBridge regola Amazon che viene eseguita secondo 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 EventBridge regola Amazon che viene eseguita secondo 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

Sebbene sia possibile creare regole che vengono eseguite secondo una pianificazione, EventBridge ora offre un modo più flessibile e potente per creare, eseguire e gestire le attività pianificate centralmente: Pianificatore EventBridge. Con Pianificatore EventBridge, puoi creare pianificazioni utilizzando le espressioni cron e rate per modelli ricorrenti o configurare chiamate una tantum. Puoi configurare finestre temporali flessibili per la consegna, definire limiti per nuovi tentativi e impostare il tempo massimo di conservazione per invocazioni API non riuscite.

Scheduler è altamente personalizzabile e offre una migliore scalabilità rispetto alle regole pianificate, con un set più ampio di operazioni e servizi API target. AWS Ti consigliamo di utilizzare Scheduler per richiamare gli obiettivi in base a una pianificazione.

Per ulteriori informazioni, consulta Creare una pianificazione..

In EventBridge, puoi 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 una precisione di secondo livello nelle espressioni di pianificazione. La risoluzione più alta che utilizza un'espressione Cron è un minuto. A causa della natura distribuita dei servizi di destinazione EventBridge e dei servizi di destinazione, può verificarsi un ritardo di diversi secondi tra l'attivazione della regola pianificata 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 EventBridge regola che venga eseguita secondo 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. Apri la EventBridge console Amazon all'indirizzo https://console.aws.amazon.com/events/.

  2. Nel pannello di navigazione, scegli Regole.

  3. Scegli 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 nello stesso 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 secondo una pianificazione o utilizzare Amazon EventBridge Scheduler.

  8. Scegli come vuoi continuare:

    • Usa EventBridge Scheduler per creare la tua pianificazione

      Nota

      EventBridge Scheduler è uno strumento di pianificazione senza server che 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. EventBridge Scheduler è altamente personalizzabile e offre una migliore scalabilità rispetto alle regole EventBridge pianificate, con un set più ampio di operazioni e servizi API mirati. AWS

      Ti consigliamo di utilizzare EventBridge Scheduler per richiamare gli obiettivi in base a una pianificazione. Per ulteriori informazioni, consulta Cos'è Amazon EventBridge Scheduler? nella Amazon EventBridge Scheduler User Guide.

      1. Seleziona Continua in Scheduler EventBridge

        EventBridge apre la console EventBridge Scheduler alla pagina Crea pianificazione.

      2. Crea la pianificazione nella console EventBridge Scheduler.

    • Continua a utilizzare EventBridge per creare una regola pianificata per il bus degli 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. Per l'espressione Cron, specifica i campi per definire l'espressione cron da EventBridge utilizzare per determinare quando eseguire questa regola pianificata.

      Dopo aver specificato tutti i campi, EventBridge mostra le dieci date successive in cui EventBridge verrà eseguita questa 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. Per l'espressione della velocità, specifica i campi Valore e Unità per definire la velocità alla quale EventBridge eseguire questa regola pianificata.

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

  2. Seleziona Successivo.

Selezionare le destinazioni

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

Per selezionare le destinazioni

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

    Event bus

    Per selezionare un bus di EventBridge eventi, seleziona EventBridge Event bus, quindi procedi come segue:

    API destination

    Per utilizzare una destinazione EventBridge API, seleziona Destinazione EventBridge API, 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 una 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 oggetto, EventBridge sono necessarie le autorizzazioni per inviare eventi alla destinazione. In questi casi, EventBridge può 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. Inserisci un nome per questo ruolo di esecuzione o usa 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) Per la coda di lettere non scritte, scegli se utilizzare una coda Amazon SQS standard come coda di lettere non scritte. EventBridge invia gli eventi che corrispondono a questa regola alla coda di lettere non scritte se non vengono consegnati correttamente alla destinazione. Esegui una di queste 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 allegare alla coda una politica basata sulle risorse che conceda l'autorizzazione a inviare messaggi alla coda. EventBridge

      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. Seleziona una delle seguenti opzioni:

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

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

        In Specificate la parte dell'evento corrispondente, specificate un percorso JSON che definisce la parte dell'evento che desiderate inviare EventBridge 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 Specificate la costante in JSON, specificate il testo JSON che desiderate inviare EventBridge alla destinazione anziché all'evento.

      • Trasformatore di input: configura un trasformatore di input per personalizzare il testo che desideri EventBridge 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 Politica Riprova, specificate come EventBridge ripetere l'invio di un evento a una destinazione dopo che si è verificato un errore.

      • Età massima dell'evento: immettete il periodo di tempo massimo (in ore, minuti e secondi) per EventBridge conservare gli eventi non elaborati. Il valore predefinito è 24 ore.

      • Tentativi di nuovo tentativo: immettete il numero massimo di volte in cui è EventBridge necessario riprovare a inviare un evento alla destinazione dopo che si è verificato un errore. L'impostazione predefinita è 185 volte.

    3. (Facoltativo) Per la coda di lettere non scritte, scegli se utilizzare una coda Amazon SQS standard come coda di lettere non scritte. EventBridge invia gli eventi che corrispondono a questa regola alla coda di lettere non scritte se non vengono consegnati correttamente alla destinazione. Esegui una di queste operazioni:

      • Scegli Nessuna per non utilizzare una coda DLQ.

      • Scegli Seleziona una coda Amazon SQS nell' AWS account corrente da utilizzare come coda di lettere non scritte, quindi seleziona la coda da utilizzare dall'elenco 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 allegare alla coda una policy basata sulle risorse che conceda l'autorizzazione a inviarle messaggi. EventBridge

        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. Seleziona una delle seguenti opzioni:

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

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

        In Specificate la parte dell'evento corrispondente, specificate un percorso JSON che definisce la parte dell'evento che desiderate inviare EventBridge 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 Specificate la costante in JSON, specificate il testo JSON che desiderate inviare EventBridge alla destinazione anziché all'evento.

      • Trasformatore di input: configura un trasformatore di input per personalizzare il testo che desideri EventBridge 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 Politica Riprova, specificate come EventBridge ripetere l'invio di un evento a una destinazione dopo che si è verificato un errore.

      • Età massima dell'evento: immettete il periodo di tempo massimo (in ore, minuti e secondi) per EventBridge conservare gli eventi non elaborati. Il valore predefinito è 24 ore.

      • Tentativi di nuovo tentativo: immettete il numero massimo di volte in cui è EventBridge necessario riprovare a inviare un evento alla destinazione dopo che si è verificato un errore. L'impostazione predefinita è 185 volte.

    3. (Facoltativo) Per la coda di lettere non scritte, scegli se utilizzare una coda Amazon SQS standard come coda di lettere non scritte. EventBridge invia gli eventi che corrispondono a questa regola alla coda di lettere non scritte se non vengono consegnati correttamente alla destinazione. Esegui una di queste operazioni:

      • Scegli Nessuna per non utilizzare una coda DLQ.

      • Scegli Seleziona una coda Amazon SQS nell' AWS account corrente da utilizzare come coda di lettere non scritte, quindi seleziona la coda da utilizzare dall'elenco 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 allegare alla coda una policy basata sulle risorse che conceda l'autorizzazione a inviarle messaggi. EventBridge

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

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

  5. Seleziona 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 la pagina EventBridge Etichette Amazon.

  2. Seleziona Next (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.