# Invocación de una función de Lambda según una programación
<a name="with-eventbridge-scheduler"></a>

El [Programador de Amazon EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html) es un programador sin servidor que puede usar para crear, ejecutar y administrar tareas desde un único servicio administrado y central. Con el Programador de EventBridge, puede crear programadores mediante expresiones cron y rate para patrones recurrentes, o configurar invocaciones únicas. Puede configurar intervalos de tiempo flexibles para la entrega, definir límites de reintentos y establecer el tiempo máximo de retención para los eventos sin procesar.

Al configurar el Programador de EventBridge con Lambda, el Programador de EventBridge invoca la función de Lambda de forma asíncrona. Puede crear una programación desde la consola de Lambda (mediante el flujo Agregar desencadenador), la consola del Programador de EventBridge, la AWS CLI o CloudFormation. En esta página, se explica cómo utilizar el Programador de EventBridge para invocar una función de Lambda según una programación.

## Configurar el rol de ejecución
<a name="using-eventbridge-scheduler-execution-role"></a>

 Al crear una programación nueva, el Programador de EventBridge debe tener permiso para invocar la operación de la API de destino en su nombre. Estos permisos se conceden al Programador de EventBridge mediante un *rol de ejecución*. La política de permisos que adjunta al rol de ejecución de su programación define los permisos necesarios. Estos permisos dependen de la API de destino que quiera que invoque el Programador de EventBridge.

 Al crear una programación mediante la consola de Lambda o la consola del Programador de EventBridge, el Programador de EventBridge configura automáticamente un rol de ejecución en función del destino seleccionado. Si desea crear una programación con uno de los SDK del Programador de EventBridge, la AWS CLI o CloudFormation, debe tener un rol de ejecución existente que conceda los permisos que el Programador de EventBridge requiere para invocar un destino. A fin de obtener más información sobre cómo configurar de forma manual un rol de ejecución para su programación, consulte [Setting up the execution role](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html#setting-up-execution-role) en *EventBridge Scheduler User Guide*. 

## Creación de una programación desde la consola de Lambda
<a name="create-schedule-lambda-console"></a>

Utilice el flujo **Agregar desencadenador** de la consola de Lambda para crear una programación del Programador de EventBridge sin salir de la consola.

**Creación de un desencadenador del Programador mediante la consola de Lambda**

1. Abra la página de [Funciones](https://console.aws.amazon.com/lambda/home#/functions) en la consola de Lambda.

1. Elija la función que desea programar.

1. En el panel **Información general de la función**, elija **Agregar desencadenador**.

1. En el menú desplegable de orígenes desencadenantes, seleccione **Programador**.

1. Configure los ajustes de la programación:

   1. **Nombre de la programación**: escriba un nombre para la programación.

   1. **Grupo de programaciones**: elija un grupo de programaciones o use `default`.

   1. **Tipo de programación**: elija una de las siguientes opciones:
      + **Programación única**: invoca la función una vez en la fecha y hora especificadas.
      + **Programación recurrente**: invoca la función varias veces mediante una expresión de frecuencia o una expresión cron.

   1. (Opcional) Ingrese una carga útil de JSON. Si no ingresa una carga útil, el Programador de EventBridge utilizará un evento vacío para invocar la función.

   1. Configure el rol de ejecución. Para que el Programador de EventBridge cree un rol de ejecución nuevo en su nombre, elija **Crear un nuevo rol para esta programación**. A continuación, ingrese un nombre para el **Nombre de rol**. Si elige esta opción, el Programador de EventBridge crea una política con los permisos necesarios y la adjunta al rol.

1. Elija **Agregar**.

**sugerencia**  
También puede buscar **schedule**, **cron**, **time** o **recurring** para encontrar este desencadenador en el flujo Agregar desencadenador.

También puede usar la [consola del Programador de EventBridge](https://console.aws.amazon.com/scheduler/home) para crear una programación. Con la consola del Programador de EventBridge, puede configurar opciones adicionales, como ventanas de tiempo flexibles y colas de mensajes fallidos.

## Visualización de los desencadenadores del Programador de EventBridge
<a name="viewing-scheduler-triggers"></a>

Todas las programaciones del Programador de EventBridge relacionadas con su función aparecen en la sección **Desencadenadores** de la página de configuración de la función, en la etiqueta **Programador**. Esto incluye las programaciones creadas a partir de cualquiera de los siguientes orígenes:
+ La consola de Lambda (flujo Agregar desencadenadores)
+ La consola del Programador de EventBridge
+ La AWS CLI, SDK, CloudFormation, AWS SAM (mediante el tipo de evento `ScheduleV2`) o AWS CDK (mediante el módulo `aws-scheduler`)

**nota**  
Si una programación utiliza una clave administrada por el cliente para el cifrado con un destino de invocación de destino universal (UTI), es posible que no aparezca en la lista de desencadenadores. Para ver estas programaciones, utilice la [consola del Programador de EventBridge](https://console.aws.amazon.com/scheduler/home).

Para confirmar que el Programador de EventBridge ha invocado la función, [compruebe Registros de Amazon CloudWatch de la función](monitoring-cloudwatchlogs-view.md#monitoring-cloudwatchlogs-console).

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

 Para obtener más información sobre el Programador de EventBridge, consulte lo siguiente: 
+ [Guía del usuario del Programador de EventBridge](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)
+ [Referencia de la API del Programador de EventBridge](https://docs.aws.amazon.com/scheduler/latest/APIReference/Welcome.html)
+ [Precios del Programador de EventBridge](https://aws.amazon.com/eventbridge/pricing/#Scheduler)