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 EventBridge pianificazione Scheduler. Puoi utilizzare la console EventBridge Scheduler, AWS Command Line Interface (AWS CLI) o AWS SDKs per creare una pianificazione con un target Amazon SQS basato su modelli. Quindi, configurerai la registrazione, configurerai i nuovi tentativi e imposterai 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 IAM gli utenti con le autorizzazioni minime richieste descritte in. Utilizzo di politiche basate sull'identità in Scheduler EventBridge 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 Interface utente della versione 2.
Argomenti
Prerequisiti
Prima di eseguire i passaggi descritti in questa sezione, è necessario effettuare le seguenti operazioni:
-
Completare le attività descritte in Configurazione di Amazon EventBridge Scheduler
Crea una pianificazione utilizzando la console EventBridge Scheduler
Per creare una nuova pianificazione utilizzando la console
-
Nota
Puoi cambiare la tua usando il selettore Regione AWS della regione. AWS Management Console
-
Nella pagina Pianificazioni, scegli Crea pianificazione.
-
Nella pagina Specifica i dettagli della pianificazione, nella sezione Nome e descrizione della pianificazione, effettua le seguenti operazioni:
-
Per Nome pianificazione, inserisci un nome per la pianificazione. Ad esempio,
MyTestSchedule
. -
Per Descrizione: facoltativo, inserisci una descrizione per il tuo programma. Ad esempio
My first schedule
. -
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.
-
-
Nella sezione Schema di pianificazione, procedi come segue:
-
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
Scegliete una pianificazione basata su CRON per configurare una pianificazione utilizzando un'espressione. cron 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 in EventBridge Scheduler
-
-
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.
-
-
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.
-
Scegli Next (Successivo).
-
Nella pagina Seleziona destinazione, procedi come segue:
-
Seleziona obiettivi basati su modelli e scegli un obiettivo. API Per questo esempio, sceglieremo il target basato su SQS
SendMessage
modelli Amazon. -
Nella SendMessagesezione, per la SQScoda, scegli una SQS coda Amazon esistente, ARN ad esempio
arn:aws:sqs:
dall'elenco a discesa. Per creare una nuova coda, scegli Crea nuova SQS coda per accedere alla console AmazonSQS. Dopo aver completato la creazione di una coda, torna alla console EventBridge Scheduler e aggiorna il menu a discesa. La nuova coda ARN viene visualizzata e può essere selezionata.us-west-2
:123456789012
:TestQueue
-
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.
-
-
Scegli Avanti, quindi nella pagina Impostazioni - opzionale, procedi come segue:
-
-
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.
-
Nella sezione Azione dopo il completamento della pianificazione, configura l'azione intrapresa dallo EventBridge Scheduler dopo il completamento della pianificazione:
-
Scegli DELETEse 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 NONEo non scegliete un valore se non desiderate che EventBridge Scheduler intraprenda alcuna azione dopo il completamento della pianificazione.
-
-
Nella sezione Criteri di riprova e coda lettere morte (DLQ), per Criterio Riprova, attiva Riprova per configurare un criterio di riprova 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.
-
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.
-
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.
-
Per Dead-letter queue (DLQ), scegliete una delle seguenti opzioni:
-
Nessuno: scegliete questa opzione se non desiderate configurare un. DLQ
-
Seleziona una SQS coda Amazon nel mio AWS account come DLQ: scegli questa opzione, quindi seleziona una coda ARN dall'elenco a discesa, configurane una DLQ Account AWS uguale a quella in cui stai creando la pianificazione.
-
Specificare una SQS coda Amazon in un altro AWS account come DLQ: scegli questa opzione, quindi inserisci la ARN coda configurata comeDLQ, se la coda si trova in un altro. Account AWS Devi inserire l'esatto ARN per la coda per utilizzare questa opzione.
-
-
Nella sezione Crittografia, scegli Personalizza le impostazioni di crittografia (avanzate) per utilizzare una KMS chiave gestita dal cliente per crittografare l'input di destinazione. Se scegli questa opzione, inserisci una KMS chiave esistente ARN o scegli Crea una AWS KMS chiave per accedere alla AWS KMS console. Per ulteriori informazioni su come EventBridge Scheduler crittografa i dati inattivi, consulta. Crittografia inattiva in Scheduler EventBridge
-
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 IAM console 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.
-
-
Scegli Next (Successivo).
-
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.
-
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.
-
Per verificare che la tua pianificazione richiami il SQS target Amazon, apri la SQS console Amazon ed esegui le seguenti operazioni:
-
Scegli la coda di destinazione dall'elenco delle code.
-
Scegli Invia e ricevi messaggi.
-
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-schedule
--name — Inserisci un nome per la pianificazione.
RoleArn— Inserisci ARN il ruolo di esecuzione che desideri associare alla pianificazione.
Arn — Inserite il valore ARN per la destinazione. In questo caso, l'obiettivo è una SQS coda Amazon.
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 lo Scheduler EventBridge SDKs
Nell'esempio seguente, utilizzi EventBridge Scheduler SDKs per creare una EventBridge pianificazione Scheduler con un target Amazon basato su modelli. SQS
Esempio Python SDK
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 Java SDK
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 lo EventBridge SchedulerSDK, consultaGestione di una pianificazione in EventBridge Scheduler. AWS CLI
-
Per ulteriori informazioni su come configurare gli obiettivi basati su modelli e sull'utilizzo del parametro universal target, vedere. Gestione degli obiettivi in EventBridge Scheduler