Managing a schedule - EventBridge Scheduler

Managing a schedule

A schedule is the main resource you create, configure, and manage using Amazon EventBridge Scheduler.

Every schedule has a schedule expression that determines when, and with what frequency, the schedule runs. EventBridge Scheduler supports three types of schedules: rate, cron, and one-time schedules. For more information about different schedule types, see Schedule types on EventBridge Scheduler.

When you create a schedule, you configure a target for the schedule to invoke. A target is an API operation that EventBridge Scheduler calls on your behalf every time your schedule runs. EventBridge Scheduler supports two types of targets: templated targets call common API operations across a core groups of services, and the universal target parameter (UTP) that you can use to call more than 6,000 operations across over 270 services. For more information about configuring targets, see Managing targets.

You configure how your schedule handles failures, when EventBridge Scheduler is unable to deliver an event successfully to a target, by using two primary mechanisms: a retry policy, and a dead-letter queue (DLQ). A retry policy determines the number of times EventBridge Scheduler must retry a failed event, and how long to keep an unprocessed event. A DLQ is a standard Amazon SQS queue EventBridge Scheduler uses to deliver failed events to, after the retry policy has been exhausted. You can use a DLQ to troubleshoot issues with your schedule or its downstream target. For more information about, see Configuring a dead-letter queue for a schedule.

In this section, you can find examples for managing your EventBridge Scheduler schedules using the console, the AWS CLI and the EventBridge Scheduler SDKs.

What's next?

  • For more information on how you can configure templated targets for Lambda and Step Functions, and to learn about using the universal target parameter, see Managing targets.

  • For more information about the EventBridge Scheduler data types and API operations, see the EventBridge Scheduler API Reference.