As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Gerenciar eventos baseados em tempo com o EventBridge Scheduler no AWS SAM

O conteúdo deste tópico fornece detalhes sobre o que é o Agendador do Amazon EventBridge, que suporte o AWS SAM oferece, como você pode criar eventos do Agendador e a que exemplos você pode fazer referência ao criar eventos do Agendador.

O que é o Agendador do Amazon EventBridge?

Use o Agendador do EventBridge para agendar eventos nos modelos do AWS SAM. O Agendador do Amazon EventBridge é um serviço de agendamento que permite criar, iniciar e gerenciar dezenas de milhões de eventos e tarefas em todos os serviços AWS. Esse serviço é particularmente útil para eventos relacionados a tempo. Você pode usá-lo para agendar eventos e invocações recorrentes baseadas em tempo. Ele também oferece suporte a eventos únicos, bem como a expressões de taxa e cron com horários de início e de término.

Para saber mais sobre o Agendador do Amazon EventBridge, consulte O que é o Agendador do Amazon EventBridge? no Guia do usuário do Agendador EventBridge.

Suporte ao EventBridge Scheduler no AWS SAM

A especificação do modelo AWS Serverless Application Model (AWS SAM) fornece uma sintaxe simples e abreviada que você pode usar para agendar eventos com o EventBridge Scheduler para AWS Lambda e AWS Step Functions.

Criação de eventos do EventBridge Scheduler no AWS SAM

Defina a propriedade ScheduleV2 como o tipo de evento em seu modelo AWS SAM para definir seu evento do EventBridge Scheduler. Essa propriedade oferece suporte aos tipos de recurso AWS::Serverless::Function e AWS::Serverless::StateMachine.

MyFunction:
  Type: AWS::Serverless::Function
  Properties:
    Events:
      CWSchedule:
        Type: ScheduleV2
        Properties:
          ScheduleExpression: 'rate(1 minute)'
          Name: TestScheduleV2Function
          Description: Test schedule event
                    
MyStateMachine:
  Type: AWS::Serverless::StateMachine
  Properties:
    Events:
      CWSchedule:
        Type: ScheduleV2
        Properties:
          ScheduleExpression: 'rate(1 minute)'
          Name: TestScheduleV2StateMachine
          Description: Test schedule event

O agendamento de eventos do EventBridge Scheduler também suporta filas de mensagens não entregues (DLQ) para eventos não processados. Para obter mais informações sobre filas de mensagens não entregues, consulte Configurando uma fila de mensagens não entregues para o EventBridge Scheduler no Guia do Usuário do EventBridge Scheduler.

Quando um ARN de DLQ é especificado, AWS SAM configura permissões para que o agendador envie mensagens para o DLQ. Quando um ARN de DLQ não for especificado, AWS SAM criará o recurso de DLQ.

Exemplos

Exemplo básico de definição de um evento do EventBridge Scheduler com AWS SAM

Transform: AWS::Serverless-2016-10-31
Resources:
  MyLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: index.handler
      Runtime: python3.8
      InlineCode: |
        def handler(event, context):
            print(event)
            return {'body': 'Hello World!', 'statusCode': 200}
      MemorySize: 128
      Events:
        Schedule:
          Type: ScheduleV2
          Properties:
            ScheduleExpression: rate(1 minute)
            Input: '{"hello": "simple"}'
 
  MySFNFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: index.handler
      Runtime: python3.8
      InlineCode: |
        def handler(event, context):
            print(event)
            return {'body': 'Hello World!', 'statusCode': 200}
      MemorySize: 128
 
  StateMachine:
    Type: AWS::Serverless::StateMachine
    Properties:
      Type: STANDARD
      Definition:
        StartAt: MyLambdaState
        States:
          MyLambdaState:
            Type: Task
            Resource: !GetAtt MySFNFunction.Arn
            End: true
      Policies:
        - LambdaInvokePolicy:
            FunctionName: !Ref MySFNFunction
      Events:
        Schedule:
          Type: ScheduleV2
          Properties:
            ScheduleExpression: rate(1 minute)
            Input: '{"hello": "simple"}'

Saiba mais

Para saber mais sobre a definição da propriedade ScheduleV2 EventBridge Scheduler, consulte: