ScheduleV2 - AWS Serverless Application Model
SintaxisPropiedadesEjemplos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

ScheduleV2

El objeto que describe un tipo de fuente de ScheduleV2 eventos, que establece su máquina de estados como el objetivo de un evento de Amazon EventBridge Scheduler que se desencadena de forma programada. Para obtener más información, consulte ¿Qué es Amazon EventBridge Scheduler? en la Guía del usuario de EventBridge Scheduler.

AWS Serverless Application Model (AWS SAM) genera un AWS::Scheduler::Schedulerecurso cuando se establece este tipo de evento.

Sintaxis

Para declarar esta entidad en tu plantilla AWS Serverless Application Model (AWS SAM), usa la siguiente sintaxis.

Propiedades

DeadLetterConfig

Configure la cola del Amazon Simple Queue Service (Amazon SQS), desde la que EventBridge se envían los eventos tras una invocación de destino fallida. La invocación puede fallar, por ejemplo, cuando se envía un evento a una función de Lambda que no existe o EventBridge cuando no hay permisos suficientes para invocar la función de Lambda. Para obtener más información, consulte Configuración de una cola de letra muerta para Scheduler en la Guía del usuario de Scheduler EventBridge . EventBridge

Tipo: DeadLetterConfig

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad es similar a la DeadLetterConfig propiedad del tipo de AWS::Scheduler::Schedule Target datos. La AWS SAM versión de esta propiedad incluye subpropiedades adicionales, por si AWS SAM quiere crear automáticamente una cola de texto sin procesar.

Description

Una descripción del programa.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se transfiere directamente a la Description propiedad de un recurso. AWS::Scheduler::Schedule

EndDate

La fecha, en UTC, antes de la cual la programación puede invocar su destino. Según la expresión de recurrencia de la programación, las invocaciones se pueden detener en la EndDate que especifique o antes de ella.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la EndDate propiedad de un AWS::Scheduler::Schedule recurso.

FlexibleTimeWindow

Permite configurar una ventana en la cual se puede invocar una programación.

Tipo: FlexibleTimeWindow

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la FlexibleTimeWindow propiedad de un AWS::Scheduler::Schedule recurso.

GroupName

El nombre de grupo de programación asociado a esta programación. Si no está definido, se utiliza el grupo predeterminado.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la GroupName propiedad de un AWS::Scheduler::Schedule recurso.

Input

Texto JSON válido transmitido al destino. Si utiliza esta propiedad, no se transmitirá nada del propio texto del evento al destino.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la Input propiedad de un AWS::Scheduler::Schedule Target recurso.

KmsKeyArn

El ARN de una clave de KMS que se utiliza para cifrar datos personalizados.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la KmsKeyArn propiedad de un AWS::Scheduler::Schedule recurso.

Name

El nombre de la programación. Si no especifica un nombre, AWS SAM genera un nombre en el formato StateMachine-Logical-IDEvent-Source-Name y usa ese ID como nombre del programa.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se transfiere directamente a la Name propiedad de un AWS::Scheduler::Schedule recurso.

OmitName

De forma predeterminada, AWS SAM genera y usa un nombre de programación con el formato <S tate-machine-logical event-source-name -ID>< >. Establezca esta propiedad true para AWS CloudFormation generar un identificador físico único y utilícelo en su lugar para el nombre del programa.

Tipo: Booleano

Obligatorio: no

Valor predeterminado: false

AWS CloudFormation compatibilidad: esta propiedad es exclusiva de AWS SAM y no tiene un AWS CloudFormation equivalente.

PermissionsBoundary

El ARN de la política que se utilizará para definir el límite de los permisos para el rol.

nota

Si PermissionsBoundary está definido, AWS SAM aplicará los mismos límites a la función de IAM objetivo del programador.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se transfiere directamente a la PermissionsBoundary propiedad de un AWS::IAM::Role recurso.

RetryPolicy

Objeto de la RetryPolicy que incluye información acerca de la configuración de la política de reintentos.

Tipo: RetryPolicy

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la RetryPolicy propiedad del tipo de AWS::Scheduler::Schedule Target datos.

RoleArn

El ARN de la función de IAM que EventBridge Scheduler utilizará para el destino cuando se invoque la programación.

Tipo: RoleArn

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la RoleArn propiedad del tipo de AWS::Scheduler::Schedule Target datos.

ScheduleExpression

La expresión de programación que determina cuándo y con qué frecuencia se ejecuta la programación.

Tipo: cadena

Obligatorio: sí

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la ScheduleExpression propiedad de un AWS::Scheduler::Schedule recurso.

ScheduleExpressionTimezone

La zona horaria en la que se evalúa la expresión de programación.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la ScheduleExpressionTimezone propiedad de un AWS::Scheduler::Schedule recurso.

StartDate

La fecha, en UTC, después de la cual la programación puede invocar un objetivo. Según la expresión de recurrencia de la programación, las invocaciones se pueden realizar en la StartDate que especifique o después de ella.

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la StartDate propiedad de un AWS::Scheduler::Schedule recurso.

State

Estado del programa.

Valores aceptados: DISABLED | ENABLED

Tipo: cadena

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad se pasa directamente a la State propiedad de un AWS::Scheduler::Schedule recurso.

Ejemplos

Ejemplo básico de definición de un recurso de ScheduleV2

StateMachine:
  Type: AWS::Serverless::StateMachine
  Properties:
    Name: MyStateMachine
    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
    DefinitionUri:
      Bucket: sam-demo-bucket
      Key: my-state-machine.asl.json
      Version: 3
    Policies:
      - LambdaInvokePolicy:
          FunctionName: !Ref MyFunction