ScheduleV2 - AWS Serverless Application Model
SintassiProprietàEsempi

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

ScheduleV2

L'oggetto che descrive un tipo di origine ScheduleV2 dell'evento, che imposta la funzione serverless come destinazione di un evento Amazon EventBridge Scheduler che si attiva in base a una pianificazione. Per ulteriori informazioni, consulta Cos'è Amazon EventBridge Scheduler? nella Guida per l'utente di EventBridge Scheduler.

AWS Serverless Application Model (AWS SAM) genera un AWS::Scheduler::Schedulerisorsa quando questo tipo di evento è impostato.

Sintassi

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

Proprietà

DeadLetterConfig

Configura la coda Amazon Simple Queue Service (Amazon SQS) a EventBridge cui invia gli eventi dopo una chiamata di destinazione non riuscita. L'invocazione può fallire, ad esempio, quando si invia un evento a una funzione Lambda che non esiste o quando EventBridge le autorizzazioni sono insufficienti per richiamare la funzione Lambda. Per ulteriori informazioni, consulta Configurazione di una coda di lettere non scritte per Scheduler nella Scheduler User Guide. EventBridge EventBridge

Nota

Il tipo di AWS::Serverless::Function risorsa ha un tipo di dati simileDeadLetterQueue, che gestisce gli errori che si verificano dopo una chiamata riuscita della funzione Lambda di destinazione. Esempi di questi tipi di errori includono la limitazione Lambda o gli errori restituiti dalla funzione di destinazione Lambda. Per ulteriori informazioni sulla DeadLetterQueue proprietà della funzione, consulta Dead-letter queues nella Developer Guide.AWS Lambda

Tipo: DeadLetterConfig

Required: No

CloudFormation compatibilità: questa proprietà è simile alla DeadLetterConfig proprietà del tipo di dati. AWS::Scheduler::Schedule Target La AWS SAM versione di questa proprietà include sottoproprietà aggiuntive, nel caso in cui si desideri AWS SAM creare automaticamente la coda di lettere non scritte.

Description

Una descrizione della pianificazione.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Description proprietà di una AWS::Scheduler::Schedule risorsa.

EndDate

La data, in UTC, prima della quale la pianificazione può richiamare il suo obiettivo. A seconda dell'espressione di ricorrenza della pianificazione, le chiamate potrebbero interrompersi nel momento in cui specifichi EndDate o prima.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla EndDate proprietà di una AWS::Scheduler::Schedule risorsa.

FlexibleTimeWindow

Consente la configurazione di una finestra all'interno della quale è possibile richiamare una pianificazione.

Tipo: FlexibleTimeWindow

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla FlexibleTimeWindow proprietà di una AWS::Scheduler::Schedule risorsa.

GroupName

Il nome del gruppo di pianificazioni da associare a questa pianificazione. Se non è definito, viene utilizzato il gruppo predefinito.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla GroupName proprietà di una AWS::Scheduler::Schedule risorsa.

Input

Testo JSON valido passato al target. Se utilizzi questa proprietà, al target non viene passata alcuna informazione sul testo dell'evento.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Input proprietà di una AWS::Scheduler::Schedule Target risorsa.

KmsKeyArn

L'ARN per una chiave KMS che verrà utilizzata per crittografare i dati dei clienti.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla KmsKeyArn proprietà di una risorsa. AWS::Scheduler::Schedule

Name

Il nome della pianificazione. Se non specifichi un nome, AWS SAM genera un nome nel formato Function-Logical-IDEvent-Source-Name e utilizza quell'ID per il nome della pianificazione.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Name proprietà di una AWS::Scheduler::Schedule risorsa.

OmitName

Per impostazione predefinita, AWS SAM genera e utilizza un nome di pianificazione nel formato di<Function-logical-ID><event-source-name>. Imposta questa proprietà in true modo da CloudFormation generare un ID fisico univoco e utilizzalo invece per il nome della pianificazione.

Tipo: Booleano

Required: No

Default: false

CloudFormation compatibilità: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

PermissionsBoundary

L'ARN della policy utilizzata per impostare il limite delle autorizzazioni per il ruolo.

Nota

Se PermissionsBoundary definito, AWS SAM applicherà gli stessi limiti al ruolo IAM di destinazione della pianificazione dello scheduler.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla PermissionsBoundary proprietà di una AWS::IAM::Role risorsa.

RetryPolicy

Un oggetto RetryPolicy che include informazioni sulle impostazioni dei criteri di nuovi tentativi.

Tipo: RetryPolicy

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla RetryPolicy proprietà del tipo di AWS::Scheduler::Schedule Target dati.

RoleArn

L'ARN del ruolo IAM che EventBridge Scheduler utilizzerà per la destinazione quando viene richiamata la pianificazione.

Tipo: RoleArn

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla RoleArn proprietà del tipo di dati. AWS::Scheduler::Schedule Target

ScheduleExpression

L'espressione di pianificazione che determina quando e con quale frequenza viene eseguito l'evento di pianificazione dello scheduler.

Tipo: Stringa

Campo obbligatorio: sì

CloudFormation compatibilità: questa proprietà viene passata direttamente alla ScheduleExpression proprietà di una AWS::Scheduler::Schedule risorsa.

ScheduleExpressionTimezone

Il fuso orario in cui viene valutata l'espressione di pianificazione.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla ScheduleExpressionTimezone proprietà di una AWS::Scheduler::Schedule risorsa.

StartDate

La data, in UTC, dopo la quale la pianificazione può iniziare a richiamare un obiettivo. A seconda dell'espressione di ricorrenza della pianificazione, le chiamate potrebbero interrompersi nel momento in cui specifichi StartDate o dopo.

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla StartDate proprietà di una AWS::Scheduler::Schedule risorsa.

State

Lo stato della pianificazione dello Scheduler.

Valori accettati: DISABLED | ENABLED

Tipo: Stringa

Required: No

CloudFormation compatibilità: questa proprietà viene passata direttamente alla State proprietà di una AWS::Scheduler::Schedule risorsa.

Esempi

Esempio di base di definizione di una risorsa ScheduleV2

Resources:
  Function:
    Properties:
      ...
      Events:
        ScheduleEvent:
          Type: ScheduleV2
          Properties:
            ScheduleExpression: "rate(1 minute)"
        ComplexScheduleEvent:
          Type: ScheduleV2
          Properties:
            ScheduleExpression: rate(1 minute)
            FlexibleTimeWindow:
              Mode: FLEXIBLE
              MaximumWindowInMinutes: 5
            StartDate: '2022-12-28T12:00:00.000Z'
            EndDate: '2023-01-28T12:00:00.000Z'
            ScheduleExpressionTimezone: UTC
            RetryPolicy:
              MaximumRetryAttempts: 5
              MaximumEventAgeInSeconds: 300
            DeadLetterConfig:
              Type: SQS
Nota

L'ID fisico generato di ScheduleV2 non include il nome dello stack.