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 gli utenti IAM con le autorizzazioni minime richieste descritte in. [Utilizzo di politiche basate sull'identità in Scheduler EventBridge](security_iam_id-based-policy-examples.md) 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 il 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à](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-precedence) nella *Guida per l'AWS Command Line Interface utente della versione 2*. **Topics** + [Prerequisiti](#getting-started-prerequisites) + [Crea una pianificazione utilizzando la console EventBridge Scheduler](#getting-started-console) + [Crea una pianificazione utilizzando il AWS CLI](#getting-started-cli) + [Crea una pianificazione utilizzando lo Scheduler EventBridge SDKs](#getting-started-sdk) + [Fasi successive](#working-with-cli-sdk-whats-next) ## 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](setting-up.md) ## Crea una pianificazione utilizzando la console EventBridge Scheduler **Per creare una nuova pianificazione utilizzando la console** 1. [Accedi a Console di gestione AWS, 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 \$1home](https://us-west-2.console.aws.amazon.com/scheduler/home?region=us-west-2#home) **Nota** Puoi cambiare la tua usando il selettore Regione AWS della regione. Console di gestione AWS 1. Nella pagina **Pianificazioni**, scegli **Crea pianificazione**. 1. 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**. 1. Per **Descrizione: *facoltativo***, inserisci una descrizione per il tuo programma. Ad esempio **My first schedule**. 1. 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. 1. 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 ore`hh: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](schedule-types.md) 1. 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. 1. 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. 1. Scegli **Next (Successivo)**. 1. 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.** 1. **SendMessage**Nella 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. 1. 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.** 1. Scegli **Avanti**, quindi nella pagina **Impostazioni - *opzionale***, procedi come segue: 1. 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. 1. 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](managing-schedule-delete.md#managing-schedule-automatic-deletion) + Scegliete **NESSUNO** o non scegliete un valore se non desiderate che EventBridge Scheduler intraprenda alcuna azione dopo il completamento della pianificazione. 1. 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. 1. 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. 1. 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. 1. 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. 1. 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 inattiva in EventBridge Scheduler](encryption-rest.md) 1. Per **Autorizzazioni**, scegli **Usa il ruolo esistente**, quindi seleziona il ruolo che hai creato durante la procedura di [configurazione](setting-up.md#setting-up-execution-role) 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. 1. Scegli **Next (Successivo)**. 1. 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. 1. 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**. 1. 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.** 1. Scegli **Invia e ricevi messaggi**. 1. 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 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/create-schedule.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/scheduler/create-schedule.html)creare 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 lo Scheduler EventBridge SDKs Nell'esempio seguente, utilizzi EventBridge Scheduler SDKs per creare una EventBridge pianificazione Scheduler con un target Amazon SQS basato su modelli. **Example SDK Python** ``` import boto3 scheduler = boto3.client('scheduler') flex_window = { "Mode": "OFF" } sqs_templated = { "RoleArn": "", "Arn": "", "Input": "Message for scheduleArn: '', scheduledTime: ''" } scheduler.create_schedule( Name="sqs-python-templated", ScheduleExpression="rate(5 minutes)", Target=sqs_templated, FlexibleTimeWindow=flex_window) ``` **Example 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("") .arn("") .input("Message for scheduleArn: '', scheduledTime: ''") .build(); CreateScheduleRequest createScheduleRequest = CreateScheduleRequest.builder() .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 SDK AWS CLI, consulta. [Gestione di una pianificazione in EventBridge Scheduler](managing-schedule.md) + Per ulteriori informazioni su come configurare gli obiettivi basati su modelli e sull'utilizzo del parametro universal target, consulta. [Gestione degli obiettivi in EventBridge Scheduler](managing-targets.md) + Per ulteriori informazioni sui tipi di dati di EventBridge Scheduler e sulle operazioni delle API, consulta lo [EventBridge Scheduler](https://docs.aws.amazon.com/scheduler/latest/APIReference/) API Reference.