AWS Fundamentals Logo
AWS Fundamentals
L2 Construct

Schedule

An EventBridge Schedule.

Import

import { Schedule } from 'aws-cdk-lib/aws-scheduler';

Or use the module namespace:

import * as scheduler from 'aws-cdk-lib/aws-scheduler';
// scheduler.Schedule

Properties

Configuration passed to the constructor as ScheduleProps.

scheduleRequired
ScheduleExpression

The expression that defines when the schedule runs. Can be either a `at`, `rate` or `cron` expression.

targetRequired
IScheduleTarget

The schedule's target details.

descriptionOptional
string

The description you specify for the schedule.

Default: - no value

enabledOptional
boolean

Indicates whether the schedule is enabled.

Default: true

endOptional
date

The date, in UTC, before which the schedule can invoke its target. EventBridge Scheduler ignores end for one-time schedules.

Default: - no value

keyOptional
IKey

The customer managed KMS key that EventBridge Scheduler will use to encrypt and decrypt your data.

Default: - All events in Scheduler are encrypted with a key that AWS owns and manages.

scheduleGroupOptional
IScheduleGroup

The schedule's group.

Default: - By default a schedule will be associated with the `default` group.

scheduleNameOptional
string

The name of the schedule. Up to 64 letters (uppercase and lowercase), numbers, hyphens, underscores and dots are allowed.

Default: - A unique name will be generated

startOptional
date

The date, in UTC, after which the schedule can begin invoking its target. EventBridge Scheduler ignores start for one-time schedules.

Default: - no value

timeWindowOptional
TimeWindow

A time window during which EventBridge Scheduler invokes the schedule.

Default: TimeWindow.off()

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

LevelL2 (Higher-level)
Moduleaws-scheduler
Properties10

External Links