View a markdown version of this page

Invocar uma função do Lambda segundo uma agenda - AWS Lambda
Configurar o perfil de execuçãoCrie uma programação usando o console do LambdaVisualização dos gatilhos do Agendador do EventBridgeRecursos relacionados

Invocar uma função do Lambda segundo uma agenda

O Agendador do Amazon EventBridge é um programador sem servidor que permite criar, executar e gerenciar tarefas a partir de um serviço central gerenciado. Com o Agendador do EventBridge, você pode criar programações usando expressões cron e rate para padrões recorrentes ou configurar invocações únicas. Você pode configurar janelas de tempo flexíveis para entrega, definir limites de repetição e definir o tempo máximo de retenção para eventos não processados.

Quando você configura o EventBridge Scheduler com o Lambda, o EventBridge Scheduler invoca a função do Lambda de modo assíncrono. Você pode criar um cronograma no console do Lambda (usando o fluxo Adicionar gatilho), no console do EventBridge Scheduler, na AWS CLI ou no CloudFormation. Esta página explica como usar o Agendador do EventBridge para invocar uma função do Lambda em uma programação.

Configurar o perfil de execução

Quando você cria uma programação, o Agendador do EventBridge deve ter permissão para invocar a operação da API de destino em seu nome. Você concede essas permissões ao Agendador do EventBridge usando um perfil de execução. A política de permissão que você anexa ao perfil de execução da programação define as permissões necessárias. As permissões dependem da API de destino que você deseja que o Agendador do EventBridge invoque.

Quando você cria uma programação usando o console do Lambda ou o console do Agendador do EventBridge, o Agendador do EventBridge configura automaticamente um perfil de execução com base no destino selecionado. Se você quiser criar uma programação usando um dos SDKs do Agendador do EventBridge, a AWS CLI ou o CloudFormation, você deve ter um perfil de execução que conceda as permissões que o Agendador do EventBridge precisa para invocar o destino. Para obter mais informações sobre como configurar manualmente um perfil de execução para programações, consulte Como configurar um perfil de execução no Guia do usuário do Agendador do EventBridge.

Crie uma programação usando o console do Lambda

Use o fluxo Adicionar gatilho no console do Lambda para criar uma programação do Agendador do EventBridge sem sair do console.

Para criar um gatilho do Agendador usando o console do Lambda

  1. Abra a página Funções do console do Lambda.

  2. Escolha a função que deseja programar.

  3. No painel Visão geral da função, escolha Adicionar gatilho.

  4. No menu suspenso da fonte do gatilho, escolha Agendador.

  5. Defina as configurações da programação:

    1. Nome da programação: insira um nome para a programação.

    2. Grupo de programações: escolha um grupo de programações ou use default.

    3. Tipo de programação: escolha uma das opções a seguir:

      • Programação única: invoca a função uma vez na data e hora especificadas.

      • Programação recorrente: invoca a função repetidamente usando uma expressão cron ou rate.

    4. (Opcional) Insira uma carga útil JSON. Se você não inserir uma carga útil, o Agendador do EventBridge usará um evento vazio para invocar a função.

    5. Configure o perfil de execução. Para que o Agendador do EventBridge crie um novo perfil de execução para você, escolha Criar novo perfil para esta programação. Depois, insira um nome em Nome do perfil. Se você escolher essa opção, o Agendador do EventBridge cria uma política com as permissões necessárias e a anexa ao perfil.

  6. Escolha Adicionar.

dica

Você também pode pesquisar por schedule, cron, time, ou recurring para encontrar esse gatilho no fluxo Adicionar gatilho.

Você também pode usar o console do Agendador do EventBridge para criar uma programação. Com o console do Agendador do EventBridge, você consegue configurar opções adicionais, como janelas de tempo flexíveis e filas de mensagens não entregues.

Visualização dos gatilhos do Agendador do EventBridge

Todas as programações do Agendador do EventBridge direcionados à sua função aparecem na seção Gatilhos da página de configuração da função sob o rótulo Agendador. Isso inclui programações criadas a partir de qualquer uma das seguintes origens:

  • O console do Lambda (fluxo Adicionar gatilho)

  • O console do Agendador do EventBridge

  • A AWS CLI, o SDK, o CloudFormation, o AWS SAM (usando o tipo de evento ScheduleV2) ou o AWS CDK (usando o módulo aws-scheduler)

nota

Se uma programação usar uma chave gerenciada pelo cliente para criptografia com um destino Universal Target Invocation (UTI), talvez ela não apareça na lista de gatilhos. Para ver essas programações, use o console do Agendador do EventBridge.

Para confirmar que o Agendador do EventBridge invocou a função, verifique os logs do Amazon CloudWatch da função.

Para obter mais informações sobre o Agendador do EventBridge, consulte: