Guida introduttiva a EventBridge Scheduler - EventBridge Pianificatore
PrerequisitiUso della consoleUtilizzo di AWS CLIUso degli SDK Fasi successive

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

Guida introduttiva a EventBridge Scheduler

Questo argomento descrive la creazione di una nuova pianificazione Scheduler. EventBridge Utilizza la console EventBridge Scheduler, AWS Command Line Interface (AWS CLI) o AWS gli SDK per creare una pianificazione con un target Amazon SQS basato su modelli. Quindi, configurerai la registrazione, configurerai i nuovi tentativi e stabilirai un tempo massimo di conservazione per le attività non riuscite. Dopo aver creato la pianificazione, verificherai che la pianificazione richiami correttamente la destinazione e invii un messaggio alla coda delle destinazioni.

Nota

Per seguire questa guida, ti consigliamo di configurare gli utenti IAM con le autorizzazioni minime richieste descritte in. Utilizzo di policy basate su identità Dopo aver creato e configurato un utente, esegui il comando seguente per impostare le credenziali di accesso. Avrai bisogno dell'ID della chiave di accesso e della chiave di accesso segreta per configurare. AWS CLI 

$ aws configure
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Default region name [None]: us-west-2
Default output format [None]: json

Per ulteriori informazioni sui diversi modi in cui è possibile impostare le credenziali, vedere Impostazioni di configurazione e priorità nella Guida per l'AWS Command Line Interfaceutente della versione 2.

Prerequisiti

Prima di eseguire i passaggi descritti in questa sezione, è necessario effettuare le seguenti operazioni:

Crea una pianificazione utilizzando la console EventBridge Scheduler

Per creare una nuova pianificazione utilizzando la console

  1. Accedi aAWS Management Console, quindi scegli il seguente link per aprire la sezione EventBridge Scheduler della EventBridge console: https://us-west-2.console.aws.amazon.com/scheduler/home?region=us-west-2#home

    Nota

    Puoi cambiare la tua Regione AWS utilizzando il selettore AWS Management Console della regione.

  2. Nella pagina Pianificazioni, scegli Crea pianificazione.

  3. Nella pagina Specifica i dettagli della pianificazione, nella sezione Nome e descrizione della pianificazione, effettua le seguenti operazioni:

    1. Per Nome pianificazione, inserisci un nome per la pianificazione. Ad esempio, MyTestSchedule

    2. Per Descrizione: facoltativo, inserisci una descrizione per il tuo programma. Ad esempio, My first schedule.

    3. Per il gruppo di pianificazione, scegli un gruppo di pianificazione dalle opzioni a discesa. Se in precedenza non hai creato alcun gruppo di pianificazione, puoi scegliere il default gruppo per la tua pianificazione. Per creare un nuovo gruppo di pianificazione, scegli il link Crea la tua pianificazione nella descrizione della console. I gruppi di pianificazione vengono utilizzati per aggiungere tag a gruppi di pianificazioni.

  4. Nella sezione Schema di pianificazione, procedi come segue:

    1. Per Occorrenza, scegliete una delle seguenti opzioni di pattern. Le opzioni di configurazione cambiano a seconda del pattern selezionato.

      • Pianificazione unica: una pianificazione unica richiama un obiettivo solo una volta alla data e all'ora specificate.

        Per Data e ora, inserisci una data valida nel formato. YYYY/MM/DD Quindi, specifica un timestamp in formato 24 orehh:mm. Infine, scegli un fuso orario dalle opzioni a discesa.

      • Pianificazione ricorrente: una pianificazione ricorrente richiama un obiettivo a una frequenza specificata utilizzando un'espressione o un'espressione di frequenza. cron

        Scegli una pianificazione basata su CRON per configurare una pianificazione utilizzando un'espressionecron. Per utilizzare un'espressione di tasso, scegli Pianificazione basata sulla tariffa e inserisci un numero positivo per Valore, quindi scegli un'unità dalle opzioni a discesa.

      Per ulteriori informazioni sull'utilizzo delle espressioni cron e rate, consulta. Tipi di pianificazione su EventBridge Scheduler

    2. Per Finestra temporale flessibile, scegli Off per disattivare l'opzione o scegli una delle finestre temporali predefinite dall'elenco a discesa. Ad esempio, se scegli 15 minuti e imposti una pianificazione ricorrente per il richiamo della destinazione ogni ora, la pianificazione viene eseguita entro 15 minuti dall'inizio di ogni ora.

  5. Nota

    La funzione Finestra temporale flessibile non è disponibile con pianificazioni una tantum.

    Se hai scelto Pianificazione ricorrente nel passaggio precedente, nella sezione Intervallo di tempo, specifica un fuso orario e, facoltativamente, imposta una data e un'ora di inizio e una data e ora di fine per la pianificazione. Una pianificazione ricorrente senza una data di inizio avrà inizio non appena verrà creata e sarà disponibile. Una pianificazione ricorrente senza una data di fine continuerà a richiamare il suo obiettivo a tempo indeterminato.

  6. Seleziona Successivo.

  7. Nella pagina Seleziona destinazione, procedi come segue:

    1. Seleziona Target basati su modelli e scegli un'API di destinazione. Per questo esempio, sceglieremo il target basato su SendMessage modelli di Amazon SQS.

    2. SendMessageNella sezione, per la coda SQS, scegli un ARN di coda Amazon SQS esistente, arn:aws:sqs:us-west-2:123456789012:TestQueue ad esempio dall'elenco a discesa. Per creare una nuova coda, scegli Crea nuova coda SQS per accedere alla console Amazon SQS. Dopo aver completato la creazione di una coda, torna alla console EventBridge Scheduler e aggiorna il menu a discesa. Il nuovo ARN della coda viene visualizzato e può essere selezionato.

    3. Per Target, inserisci il payload che desideri che EventBridge Scheduler distribuisca alla destinazione. Per questo esempio, invieremo il seguente messaggio alla coda di destinazione: Hello, it's EventBridge Scheduler.

  8. Scegli Avanti, quindi nella pagina Impostazioni - opzionale, procedi come segue:

    1. Nella sezione Stato di pianificazione, per Abilita pianificazione, attiva o disattiva la funzione utilizzando l'interruttore. Per impostazione predefinita, lo EventBridge Scheduler abilita la tua pianificazione.

    2. Nella sezione Azione dopo il completamento della pianificazione, configura l'azione intrapresa dallo EventBridge Scheduler dopo il completamento della pianificazione:

      • Scegli ELIMINA se desideri che la pianificazione venga eliminata automaticamente. Per le pianificazioni una tantum, ciò si verifica dopo che la pianificazione ha richiamato l'obiettivo una volta. Per le pianificazioni ricorrenti, ciò si verifica dopo l'ultima chiamata pianificata della pianificazione. Per ulteriori informazioni sull'eliminazione automatica, vedere. Eliminazione dopo il completamento della pianificazione

      • Scegliete NESSUNO o non scegliete un valore se non desiderate che EventBridge Scheduler intraprenda alcuna azione dopo il completamento della pianificazione.

    3. Nella sezione Criteri di riprova e coda lettere scadenti (DLQ), per Politica Riprova, attiva Riprova per configurare una politica di ripetizione dei tentativi per la tua pianificazione. Con le politiche di riprova, se una pianificazione non riesce a richiamare il suo obiettivo, Scheduler esegue nuovamente la pianificazione. EventBridge Se configurato, è necessario impostare il tempo di conservazione massimo e i nuovi tentativi per la pianificazione.

    4. Per Età massima dell'evento, facoltativo, inserisci il numero massimo di ore e minuti in cui EventBridge Scheduler deve conservare un evento non elaborato.

      Nota

      Il valore massimo è 24 ore.

    5. Per Numero massimo di tentativi, inserisci il numero massimo di volte in cui EventBridge Scheduler riprova la pianificazione se la destinazione restituisce un errore.

      Nota

      Il valore massimo è 185 tentativi.

    6. Per Dead-letter queue (DLQ), scegliete una delle seguenti opzioni:

      • Nessuna: scegliete questa opzione se non desiderate configurare un DLQ.

      • Seleziona una coda Amazon SQS nel mio AWS account come DLQ: scegli questa opzione, quindi seleziona un ARN di coda dall'elenco a discesa, configura un DLQ Account AWS uguale a quello in cui stai creando la pianificazione.

      • Specificare una coda Amazon SQS in un altro AWS account come DLQ: scegli questa opzione, quindi inserisci l'ARN della coda configurata come DLQ, se la coda si trova in un'altra. Account AWS È necessario inserire l'ARN esatto per la coda per utilizzare questa opzione.

    7. Nella sezione Crittografia, scegli Personalizza le impostazioni di crittografia (avanzate) per utilizzare una chiave KMS gestita dal cliente per crittografare l'input di destinazione. Se scegli questa opzione, inserisci una chiave KMS esistente (ARN) o scegli Crea AWS una chiave KMS per accedere alla console. AWS KMS Per ulteriori informazioni su come EventBridge Scheduler crittografa i dati inattivi, consulta. Crittografia dei dati a riposo

    8. Per Autorizzazioni, scegli Usa il ruolo esistente, quindi seleziona il ruolo che hai creato durante la procedura di configurazione dall'elenco a discesa. Puoi anche scegliere Vai alla console IAM per creare un nuovo ruolo.

      Se desideri che EventBridge Scheduler crei un nuovo ruolo di esecuzione per te, scegli invece Crea nuovo ruolo per questa pianificazione. Inserisci, quindi, un nome per Nome ruolo. Se scegli questa opzione, EventBridge Scheduler aggiunge al ruolo le autorizzazioni necessarie per la destinazione basata sul modello.

  10. Seleziona Successivo.

  11. Nella pagina Rivedi e crea pianificazione, rivedi i dettagli della pianificazione. In ogni sezione, scegli Modifica per tornare a tale passaggio e modificarne i dettagli.

  12. Scegli Crea pianificazione per completare la creazione della nuova pianificazione. Puoi visualizzare un elenco delle pianificazioni nuove ed esistenti nella pagina Pianificazioni. Nella colonna Stato, accertati che la nuova pianificazione sia Abilitata.

  13. Per verificare che la tua pianificazione richiami il target Amazon SQS, apri la console Amazon SQS ed esegui le seguenti operazioni:

    1. Scegli la coda di destinazione dall'elenco delle code.

    2. Scegli Invia e ricevi messaggi.

    3. Nella pagina Invia e ricevi messaggi, in Ricevi messaggi, scegli Esamina messaggi per recuperare i messaggi di test che la tua pianificazione ha inviato alla coda di destinazione.

Crea una pianificazione utilizzando il AWS CLI

L'esempio seguente mostra come utilizzare il AWS CLI comando per create-schedulecreare una EventBridge pianificazione Scheduler con un target Amazon SQS basato su modelli. Sostituisci i valori segnaposto per i seguenti parametri con le tue informazioni:

  • --name — Inserisci un nome per la pianificazione.

  • RoleArn— Inserire l'ARN per il ruolo di esecuzione che si desidera associare alla pianificazione.

  • Arn: immettere l'ARN per la destinazione. In questo caso, l'obiettivo è una coda Amazon SQS.

  • Input: inserisci un messaggio che EventBridge Scheduler invia alla coda di destinazione.

$ aws scheduler create-schedule --name sqs-templated-schedule --schedule-expression 'rate(5 minutes)' \
--target '{"RoleArn": "ROLE_ARN", "Arn": "QUEUE_ARN", "Input": "TEST_PAYLOAD" }' \
--flexible-time-window '{ "Mode": "OFF"}'

Crea una pianificazione utilizzando gli SDK EventBridge Scheduler

Nell'esempio seguente, utilizzi gli SDK EventBridge Scheduler per creare una EventBridge pianificazione Scheduler con un target Amazon SQS basato su modelli.

Esempio SDK Python
import boto3
scheduler = boto3.client('scheduler')

flex_window = { "Mode": "OFF" }

sqs_templated = {
    "RoleArn": "<ROLE_ARN>",
    "Arn": "<QUEUE_ARN>",
    "Input": "Message for scheduleArn: '<aws.scheduler.schedule-arn>', scheduledTime: '<aws.scheduler.scheduled-time>'"
}

scheduler.create_schedule(
    Name="sqs-python-templated",
    ScheduleExpression="rate(5 minutes)",
    Target=sqs_templated,
    FlexibleTimeWindow=flex_window)
Esempio SDK Java
package com.example;

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.scheduler.SchedulerClient;
import software.amazon.awssdk.services.scheduler.model.*;


public class MySchedulerApp {

    public static void main(String[] args) {
        
        final SchedulerClient client = SchedulerClient.builder()
                .region(Region.US_WEST_2)
                .build();
        
        Target sqsTarget = Target.builder()
                .roleArn("<ROLE_ARN>")
                .arn("<QUEUE_ARN>")
                .input("Message for scheduleArn: '<aws.scheduler.schedule-arn>', scheduledTime: '<aws.scheduler.scheduled-time>'")
                .build();
        
        CreateScheduleRequest createScheduleRequest = CreateScheduleRequest.builder()
                .name("<SCHEDULE NAME>")
                .scheduleExpression("rate(10 minutes)")
                .target(sqsTarget)
                .flexibleTimeWindow(FlexibleTimeWindow.builder()
                        .mode(FlexibleTimeWindowMode.OFF)
                        .build())
                .build();
                
        client.createSchedule(createScheduleRequest);
        System.out.println("Created schedule with rate expression and an Amazon SQS templated target");
    }
}

Fasi successive

  • Per ulteriori informazioni sulla gestione della pianificazione tramite la console o EventBridge Scheduler SDKAWS CLI, consulta. Gestire una pianificazione

  • Per ulteriori informazioni su come configurare gli obiettivi basati su modelli e sull'utilizzo del parametro universal target, consulta. Gestire gli obiettivi

  • Per ulteriori informazioni sui tipi di dati di EventBridge Scheduler e sulle operazioni delle API, consulta lo EventBridge Scheduler API Reference.