# Invocar uma função do Lambda segundo uma agenda
<a name="with-eventbridge-scheduler"></a>

O [Agendador do Amazon EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html) é 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
<a name="using-eventbridge-scheduler-execution-role"></a>

 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](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html#setting-up-execution-role) no *Guia do usuário do Agendador do EventBridge*. 

## Crie uma programação usando o console do Lambda
<a name="create-schedule-lambda-console"></a>

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](https://console.aws.amazon.com/lambda/home#/functions) do console do Lambda.

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

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

1. No menu suspenso da fonte do gatilho, escolha **Agendador**.

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

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

   1. **Grupo de programações**: escolha um grupo de programações ou use `default`.

   1. **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.

   1. (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.

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

1. 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](https://console.aws.amazon.com/scheduler/home) 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
<a name="viewing-scheduler-triggers"></a>

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](https://console.aws.amazon.com/scheduler/home).

Para confirmar que o Agendador do EventBridge invocou a função, [verifique os logs do Amazon CloudWatch da função](monitoring-cloudwatchlogs-view.md#monitoring-cloudwatchlogs-console).

## Recursos relacionados
<a name="using-eventbridge-scheduler-related-resources"></a>

 Para obter mais informações sobre o Agendador do EventBridge, consulte: 
+ [Guia do usuário do Agendador do EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)
+ [Referência da API do Agendador do EventBridge](https://docs.aws.amazon.com/scheduler/latest/APIReference/Welcome.html)
+ [Preços do Agendador do EventBridge](https://aws.amazon.com/eventbridge/pricing/#Scheduler)