Package software.amazon.awscdk.services.scheduler

Class Schedule

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.Resource
software.amazon.awscdk.services.scheduler.Schedule
All Implemented Interfaces:
IResource, ISchedule, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)", date="2025-10-29T11:15:48.437Z") @Stability(Stable) public class Schedule extends Resource implements ISchedule
An EventBridge Schedule.

Example: 

 import software.amazon.awscdk.services.kinesisfirehose.*;
 IDeliveryStream deliveryStream;
 Map<String, String> payload = Map.of(
         "Data", "record");
 Schedule.Builder.create(this, "Schedule")
         .schedule(ScheduleExpression.rate(Duration.minutes(60)))
         .target(FirehosePutRecord.Builder.create(deliveryStream)
                 .input(ScheduleTargetInput.fromObject(payload))
                 .build())
         .build();

  • Field Details

    • PROPERTY_INJECTION_ID

      @Stability(Stable) public static final String PROPERTY_INJECTION_ID
      Uniquely identifies this class.

  • Constructor Details

    • Schedule

      protected Schedule(software.amazon.jsii.JsiiObjectRef objRef)

    • Schedule

      protected Schedule(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • Schedule

      @Stability(Stable) public Schedule(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull ScheduleProps props)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      props - This parameter is required.

  • Method Details

    • fromScheduleArn

      @Stability(Stable) @NotNull public static ISchedule fromScheduleArn(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull String scheduleArn)
      Import an existing schedule using the ARN.

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      scheduleArn - This parameter is required.

    • metricAll

      @Stability(Stable) @NotNull public static Metric metricAll(@NotNull String metricName, @Nullable MetricOptions props)
      Return the given named metric for all schedules.

      Default: - sum over 5 minutes

      Parameters:
      metricName - This parameter is required.
      props -

    • metricAll

      @Stability(Stable) @NotNull public static Metric metricAll(@NotNull String metricName)
      Return the given named metric for all schedules.

      Default: - sum over 5 minutes

      Parameters:
      metricName - This parameter is required.

    • metricAllAttempts

      @Stability(Stable) @NotNull public static Metric metricAllAttempts(@Nullable MetricOptions props)
      Metric for all invocation attempts across all schedules.

      Default: - sum over 5 minutes

      Parameters:
      props -

    • metricAllAttempts

      @Stability(Stable) @NotNull public static Metric metricAllAttempts()
      Metric for all invocation attempts across all schedules.

      Default: - sum over 5 minutes

    • metricAllDropped

      @Stability(Stable) @NotNull public static Metric metricAllDropped(@Nullable MetricOptions props)
      Metric for dropped invocations when EventBridge Scheduler stops attempting to invoke the target after a schedule's retry policy has been exhausted.

      Metric is calculated for all schedules.

      Default: - sum over 5 minutes

      Parameters:
      props -

    • metricAllDropped

      @Stability(Stable) @NotNull public static Metric metricAllDropped()
      Metric for dropped invocations when EventBridge Scheduler stops attempting to invoke the target after a schedule's retry policy has been exhausted.

      Metric is calculated for all schedules.

      Default: - sum over 5 minutes

    • metricAllErrors

      @Stability(Stable) @NotNull public static Metric metricAllErrors(@Nullable MetricOptions props)
      Emitted when the target returns an exception after EventBridge Scheduler calls the target API across all schedules.

      Default: - sum over 5 minutes

      Parameters:
      props -

    • metricAllErrors

      @Stability(Stable) @NotNull public static Metric metricAllErrors()
      Emitted when the target returns an exception after EventBridge Scheduler calls the target API across all schedules.

      Default: - sum over 5 minutes

    • metricAllFailedToBeSentToDLQ

      @Stability(Stable) @NotNull public static Metric metricAllFailedToBeSentToDLQ(@Nullable String errorCode, @Nullable MetricOptions props)
      Metric for failed invocations that also failed to deliver to DLQ across all schedules.

      Default: - sum over 5 minutes

      Parameters:
      errorCode -
      props -

    • metricAllFailedToBeSentToDLQ

      @Stability(Stable) @NotNull public static Metric metricAllFailedToBeSentToDLQ(@Nullable String errorCode)
      Metric for failed invocations that also failed to deliver to DLQ across all schedules.

      Default: - sum over 5 minutes

      Parameters:
      errorCode -

    • metricAllFailedToBeSentToDLQ

      @Stability(Stable) @NotNull public static Metric metricAllFailedToBeSentToDLQ()
      Metric for failed invocations that also failed to deliver to DLQ across all schedules.

      Default: - sum over 5 minutes

    • metricAllSentToDLQ

      @Stability(Stable) @NotNull public static Metric metricAllSentToDLQ(@Nullable MetricOptions props)
      Metric for invocations delivered to the DLQ across all schedules.

      Default: - sum over 5 minutes

      Parameters:
      props -

    • metricAllSentToDLQ

      @Stability(Stable) @NotNull public static Metric metricAllSentToDLQ()
      Metric for invocations delivered to the DLQ across all schedules.

      Default: - sum over 5 minutes

    • metricAllSentToDLQTruncated

      @Stability(Stable) @NotNull public static Metric metricAllSentToDLQTruncated(@Nullable MetricOptions props)
      Metric for delivery of failed invocations to DLQ when the payload of the event sent to the DLQ exceeds the maximum size allowed by Amazon SQS.

      Metric is calculated for all schedules.

      Default: - sum over 5 minutes

      Parameters:
      props -

    • metricAllSentToDLQTruncated

      @Stability(Stable) @NotNull public static Metric metricAllSentToDLQTruncated()
      Metric for delivery of failed invocations to DLQ when the payload of the event sent to the DLQ exceeds the maximum size allowed by Amazon SQS.

      Metric is calculated for all schedules.

      Default: - sum over 5 minutes

    • metricAllTargetThrottled

      @Stability(Stable) @NotNull public static Metric metricAllTargetThrottled(@Nullable MetricOptions props)
      Metric for invocation failures due to API throttling by the target across all schedules.

      Default: - sum over 5 minutes

      Parameters:
      props -

    • metricAllTargetThrottled

      @Stability(Stable) @NotNull public static Metric metricAllTargetThrottled()
      Metric for invocation failures due to API throttling by the target across all schedules.

      Default: - sum over 5 minutes

    • metricAllThrottled

      @Stability(Stable) @NotNull public static Metric metricAllThrottled(@Nullable MetricOptions props)
      Metric for the number of invocations that were throttled across all schedules.

      Default: - sum over 5 minutes

      Parameters:
      props -
      See Also:

    • metricAllThrottled

      @Stability(Stable) @NotNull public static Metric metricAllThrottled()
      Metric for the number of invocations that were throttled across all schedules.

      Default: - sum over 5 minutes

      See Also:

    • getScheduleArn

      @Stability(Stable) @NotNull public String getScheduleArn()
      The arn of the schedule.
      Specified by:
      getScheduleArn in interface ISchedule

    • getScheduleName

      @Stability(Stable) @NotNull public String getScheduleName()
      The name of the schedule.
      Specified by:
      getScheduleName in interface ISchedule

    • getKey

      @Stability(Stable) @Nullable public IKey getKey()
      The customer managed KMS key that EventBridge Scheduler will use to encrypt and decrypt your data.

    • getScheduleGroup

      @Stability(Stable) @Nullable public IScheduleGroup getScheduleGroup()
      The schedule group associated with this schedule.
      Specified by:
      getScheduleGroup in interface ISchedule