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 función sin servidor como el destino 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 Configurar una cola de letra muerta para Scheduler en la Guía del usuario de Scheduler EventBridge . EventBridge

nota

El tipo de recurso AWS::Serverless::Function tiene un tipo de datos similar, DeadLetterQueue, que gestiona los errores que se producen tras la invocación correcta de la función de Lambda de destino. Entre los ejemplos de estos tipos de errores se incluyen la limitación de Lambda o los errores devueltos por la función de destino de Lambda. Para obtener más información sobre la propiedad DeadLetterQueue de la función, consulta Colas de mensajes fallidos en la Guía para desarrolladores de AWS Lambda .

Tipo: DeadLetterConfig

Obligatorio: no

AWS CloudFormation compatibilidad: esta propiedad es similar a la DeadLetterConfig propiedad del tipo de datos. AWS::Scheduler::Schedule Target 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 especifica 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 Function-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 de<Function-logical-ID><event-source-name>. 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 transfiere 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 el evento programado.

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 especifica 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 de la programación del programador.

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

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

El ID físico generado de ScheduleV2 no incluye el nombre de la pila.