software.amazon.awscdk.services.stepfunctions.tasks

Interface SnsPublishProps

All Superinterfaces:

TaskStateBaseProps

All Known Implementing Classes:

SnsPublishProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-14T16:25:36.265Z")
public interface SnsPublishProps
extends TaskStateBaseProps

Properties for publishing a message to an SNS topic.

Example:

 EvaluateExpression convertToSeconds = EvaluateExpression.Builder.create(this, "Convert to seconds")
         .expression("$.waitMilliseconds / 1000")
         .resultPath("$.waitSeconds")
         .build();
 EvaluateExpression createMessage = EvaluateExpression.Builder.create(this, "Create message")
         // Note: this is a string inside a string.
         .expression("`Now waiting ${$.waitSeconds} seconds...`")
         .runtime(Runtime.NODEJS_14_X)
         .resultPath("$.message")
         .build();
 SnsPublish publishMessage = SnsPublish.Builder.create(this, "Publish message")
         .topic(new Topic(this, "cool-topic"))
         .message(TaskInput.fromJsonPathAt("$.message"))
         .resultPath("$.sns")
         .build();
 Wait wait = Wait.Builder.create(this, "Wait")
         .time(WaitTime.secondsPath("$.waitSeconds"))
         .build();
 StateMachine.Builder.create(this, "StateMachine")
         .definition(convertToSeconds.next(createMessage).next(publishMessage).next(wait))
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static SnsPublishProps.Builder	builder()
TaskInput	getMessage() The message you want to send.
default java.util.Map<java.lang.String,MessageAttribute>	getMessageAttributes() Add message attributes when publishing.
default java.lang.Boolean	getMessagePerSubscriptionType() Send different messages for each transport protocol.
default java.lang.String	getSubject() Used as the "Subject" line when the message is delivered to email endpoints.
ITopic	getTopic() The SNS topic that the task will publish to.

Methods inherited from interface software.amazon.awscdk.services.stepfunctions.TaskStateBaseProps

getComment, getHeartbeat, getInputPath, getIntegrationPattern, getOutputPath, getResultPath, getResultSelector, getTimeout

Method Detail

getMessage

TaskInput getMessage()

The message you want to send.

With the exception of SMS, messages must be UTF-8 encoded strings and at most 256 KB in size. For SMS, each message can contain up to 140 characters.

getTopic

ITopic getTopic()

The SNS topic that the task will publish to.

getMessageAttributes

default java.util.Map<java.lang.String,MessageAttribute> getMessageAttributes()

Add message attributes when publishing.

These attributes carry additional metadata about the message and may be used for subscription filters.

Default: {}

See Also:

https://docs.aws.amazon.com/sns/latest/dg/sns-message-attributes.html

getMessagePerSubscriptionType

default java.lang.Boolean getMessagePerSubscriptionType()

Send different messages for each transport protocol.

For example, you might want to send a shorter message to SMS subscribers and a more verbose message to email and SQS subscribers.

Your message must be a JSON object with a top-level JSON key of "default" with a value that is a string You can define other top-level keys that define the message you want to send to a specific transport protocol (i.e. "sqs", "email", "http", etc)

Default: false

See Also:

https://docs.aws.amazon.com/sns/latest/api/API_Publish.html#API_Publish_RequestParameters

getSubject

default java.lang.String getSubject()

Used as the "Subject" line when the message is delivered to email endpoints.

This field will also be included, if present, in the standard JSON messages delivered to other endpoints.

Default: - No subject

builder

static SnsPublishProps.Builder builder()

Specified by:

builder in interface TaskStateBaseProps

Returns:

a SnsPublishProps.Builder of SnsPublishProps