Package software.amazon.awscdk.services.stepfunctions.tasks

Interface EventBridgeSchedulerTargetProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

EventBridgeSchedulerTargetProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.121.0 (build d7af9b9)",
           date="2025-12-18T18:20:18.911Z")
@Stability(Stable)
public interface EventBridgeSchedulerTargetProps
extends software.amazon.jsii.JsiiSerializable

Properties for EventBridgeSchedulerTarget.

Example:

 import software.amazon.awscdk.services.scheduler.*;
 import software.amazon.awscdk.services.kms.*;
 Key key;
 CfnScheduleGroup scheduleGroup;
 Queue targetQueue;
 Queue deadLetterQueue;
 Role schedulerRole = Role.Builder.create(this, "SchedulerRole")
         .assumedBy(new ServicePrincipal("scheduler.amazonaws.com"))
         .build();
 // To send the message to the queue
 // This policy changes depending on the type of target.
 schedulerRole.addToPrincipalPolicy(PolicyStatement.Builder.create()
         .actions(List.of("sqs:SendMessage"))
         .resources(List.of(targetQueue.getQueueArn()))
         .build());
 EventBridgeSchedulerCreateScheduleTask createScheduleTask1 = EventBridgeSchedulerCreateScheduleTask.Builder.create(this, "createSchedule")
         .scheduleName("TestSchedule")
         .actionAfterCompletion(ActionAfterCompletion.NONE)
         .clientToken("testToken")
         .description("TestDescription")
         .startDate(new Date())
         .endDate(new Date(new Date().getTime() + 1000 * 60 * 60))
         .flexibleTimeWindow(Duration.minutes(5))
         .groupName(scheduleGroup.getRef())
         .kmsKey(key)
         .schedule(Schedule.rate(Duration.minutes(5)))
         .timezone("UTC")
         .enabled(true)
         .target(EventBridgeSchedulerTarget.Builder.create()
                 .arn(targetQueue.getQueueArn())
                 .role(schedulerRole)
                 .retryPolicy(RetryPolicy.builder()
                         .maximumRetryAttempts(2)
                         .maximumEventAge(Duration.minutes(5))
                         .build())
                 .deadLetterQueue(deadLetterQueue)
                 .build())
         .build();
 

See Also:

• https://docs.aws.amazon.com/scheduler/latest/APIReference/API_Target.html#API_Target_Contents

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	EventBridgeSchedulerTargetProps.Builder	A builder for EventBridgeSchedulerTargetProps
static final class	EventBridgeSchedulerTargetProps.Jsii$Proxy	An implementation for EventBridgeSchedulerTargetProps

Method Summary

Modifier and Type	Method	Description
static EventBridgeSchedulerTargetProps.Builder	builder()
String	getArn()	The Amazon Resource Name (ARN) of the target.
default IQueue	getDeadLetterQueue()	Dead letter queue for failed events.
default String	getInput()	The input to the target.
default RetryPolicy	getRetryPolicy()	The retry policy settings.
IRole	getRole()	The IAM role that EventBridge Scheduler will use for this target when the schedule is invoked.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getArn

@Stability(Stable)
@NotNull
String getArn()

The Amazon Resource Name (ARN) of the target.

See Also:

• https://docs.aws.amazon.com/scheduler/latest/UserGuide/managing-targets.html

getRole

@Stability(Stable)
@NotNull
IRole getRole()

The IAM role that EventBridge Scheduler will use for this target when the schedule is invoked.

getDeadLetterQueue

@Stability(Stable)
@Nullable
default IQueue getDeadLetterQueue()

Dead letter queue for failed events.

Default: - No dead letter queue

getInput

@Stability(Stable)
@Nullable
default String getInput()

The input to the target.

Default: - EventBridge Scheduler delivers a default notification to the target

getRetryPolicy

@Stability(Stable)
@Nullable
default RetryPolicy getRetryPolicy()

The retry policy settings.

Default: - Do not retry

builder

@Stability(Stable)
static EventBridgeSchedulerTargetProps.Builder builder()

Returns:

a EventBridgeSchedulerTargetProps.Builder of EventBridgeSchedulerTargetProps