2.185.0

interface SnsPublishJsonPathProps

LanguageType name
.NETAmazon.CDK.AWS.StepFunctions.Tasks.SnsPublishJsonPathProps
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsstepfunctionstasks#SnsPublishJsonPathProps
Javasoftware.amazon.awscdk.services.stepfunctions.tasks.SnsPublishJsonPathProps
Pythonaws_cdk.aws_stepfunctions_tasks.SnsPublishJsonPathProps
TypeScript (source)aws-cdk-lib » aws_stepfunctions_tasks » SnsPublishJsonPathProps

Properties for publishing a message to an SNS topic using JSONPath.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as cdk from 'aws-cdk-lib';
import { aws_sns as sns } from 'aws-cdk-lib';
import { aws_stepfunctions as stepfunctions } from 'aws-cdk-lib';
import { aws_stepfunctions_tasks as stepfunctions_tasks } from 'aws-cdk-lib';

declare const assign: any;
declare const resultSelector: any;
declare const taskInput: stepfunctions.TaskInput;
declare const taskRole: stepfunctions.TaskRole;
declare const timeout: stepfunctions.Timeout;
declare const topic: sns.Topic;
declare const value: any;
const snsPublishJsonPathProps: stepfunctions_tasks.SnsPublishJsonPathProps = {
  message: taskInput,
  topic: topic,

  // the properties below are optional
  assign: {
    assignKey: assign,
  },
  comment: 'comment',
  credentials: {
    role: taskRole,
  },
  heartbeat: cdk.Duration.minutes(30),
  heartbeatTimeout: timeout,
  inputPath: 'inputPath',
  integrationPattern: stepfunctions.IntegrationPattern.REQUEST_RESPONSE,
  messageAttributes: {
    messageAttributesKey: {
      value: value,

      // the properties below are optional
      dataType: stepfunctions_tasks.MessageAttributeDataType.STRING,
    },
  },
  messageDeduplicationId: 'messageDeduplicationId',
  messageGroupId: 'messageGroupId',
  messagePerSubscriptionType: false,
  outputPath: 'outputPath',
  queryLanguage: stepfunctions.QueryLanguage.JSON_PATH,
  resultPath: 'resultPath',
  resultSelector: {
    resultSelectorKey: resultSelector,
  },
  stateName: 'stateName',
  subject: 'subject',
  taskTimeout: timeout,
  timeout: cdk.Duration.minutes(30),
};

Properties

NameTypeDescription
messageTaskInputThe message you want to send.
topicITopicThe SNS topic that the task will publish to.
assign?{ [string]: any }Workflow variables to store in this step.
comment?stringA comment describing this state.
credentials?CredentialsCredentials for an IAM Role that the State Machine assumes for executing the task.
heartbeat?⚠️DurationTimeout for the heartbeat.
heartbeatTimeout?TimeoutTimeout for the heartbeat.
inputPath?stringJSONPath expression to select part of the state to be the input to this state.
integrationPattern?IntegrationPatternAWS Step Functions integrates with services directly in the Amazon States Language.
messageAttributes?{ [string]: MessageAttribute }Add message attributes when publishing.
messageDeduplicationId?stringThis parameter applies only to FIFO topics.
messageGroupId?stringThis parameter applies only to FIFO topics.
messagePerSubscriptionType?booleanSend different messages for each transport protocol.
outputPath?stringJSONPath expression to select part of the state to be the output to this state.
queryLanguage?QueryLanguageThe name of the query language used by the state.
resultPath?stringJSONPath expression to indicate where to inject the state's output.
resultSelector?{ [string]: any }The JSON that will replace the state's raw result and become the effective result before ResultPath is applied.
stateName?stringOptional name for this state.
subject?stringUsed as the "Subject" line when the message is delivered to email endpoints.
taskTimeout?TimeoutTimeout for the task.
timeout?⚠️DurationTimeout for the task.

message

Type: TaskInput

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.

topic

Type: ITopic

The SNS topic that the task will publish to.

assign?

Type: { [string]: any } (optional, default: Not assign variables)

Workflow variables to store in this step.

Using workflow variables, you can store data in a step and retrieve that data in future steps.

See also: https://docs.aws.amazon.com/step-functions/latest/dg/workflow-variables.html

comment?

Type: string (optional, default: No comment)

A comment describing this state.

credentials?

Type: Credentials (optional, default: None (Task is executed using the State Machine's execution role))

Credentials for an IAM Role that the State Machine assumes for executing the task.

This enables cross-account resource invocations.

See also: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-access-cross-acct-resources.html

heartbeat?⚠️

⚠️ Deprecated: use heartbeatTimeout

Type: Duration (optional, default: None)

Timeout for the heartbeat.

heartbeatTimeout?

Type: Timeout (optional, default: None)

Timeout for the heartbeat.

[disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface

inputPath?

Type: string (optional, default: $)

JSONPath expression to select part of the state to be the input to this state.

May also be the special value JsonPath.DISCARD, which will cause the effective input to be the empty object {}.

integrationPattern?

Type: IntegrationPattern (optional, default: IntegrationPattern.REQUEST_RESPONSE for most tasks. IntegrationPattern.RUN_JOB for the following exceptions: BatchSubmitJob, EmrAddStep, EmrCreateCluster, EmrTerminationCluster, and EmrContainersStartJobRun.)

AWS Step Functions integrates with services directly in the Amazon States Language.

You can control these AWS services using service integration patterns.

Depending on the AWS Service, the Service Integration Pattern availability will vary.

See also: https://docs.aws.amazon.com/step-functions/latest/dg/connect-supported-services.html

messageAttributes?

Type: { [string]: MessageAttribute } (optional, default: {})

Add message attributes when publishing.

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

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

messageDeduplicationId?

Type: string (optional, default: Not used for standard topics, required for FIFO topics with ContentBasedDeduplication disabled.)

This parameter applies only to FIFO topics.

Every message must have a unique MessageDeduplicationId, which is a token used for deduplication of sent messages. If a message with a particular MessageDeduplicationId is sent successfully, any message sent with the same MessageDeduplicationId during the 5-minute deduplication interval is treated as a duplicate.

If the topic has ContentBasedDeduplication set, the system generates a MessageDeduplicationId based on the contents of the message. Your MessageDeduplicationId overrides the generated one.

messageGroupId?

Type: string (optional, default: Not used for standard topics, required for FIFO topics.)

This parameter applies only to FIFO topics.

The MessageGroupId is a tag that specifies that a message belongs to a specific message group. Messages that belong to the same message group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). Every message must include a MessageGroupId.

messagePerSubscriptionType?

Type: boolean (optional, default: false)

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)

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

outputPath?

Type: string (optional, default: $)

JSONPath expression to select part of the state to be the output to this state.

May also be the special value JsonPath.DISCARD, which will cause the effective output to be the empty object {}.

queryLanguage?

Type: QueryLanguage (optional, default: JSONPath)

The name of the query language used by the state.

If the state does not contain a queryLanguage field, then it will use the query language specified in the top-level queryLanguage field.

resultPath?

Type: string (optional, default: $)

JSONPath expression to indicate where to inject the state's output.

May also be the special value JsonPath.DISCARD, which will cause the state's input to become its output.

resultSelector?

Type: { [string]: any } (optional, default: None)

The JSON that will replace the state's raw result and become the effective result before ResultPath is applied.

You can use ResultSelector to create a payload with values that are static or selected from the state's raw result.

See also: https://docs.aws.amazon.com/step-functions/latest/dg/input-output-inputpath-params.html#input-output-resultselector

stateName?

Type: string (optional, default: The construct ID will be used as state name)

Optional name for this state.

subject?

Type: string (optional, default: No subject)

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.

taskTimeout?

Type: Timeout (optional, default: None)

Timeout for the task.

[disable-awslint:duration-prop-type] is needed because all props interface in aws-stepfunctions-tasks extend this interface

timeout?⚠️

⚠️ Deprecated: use taskTimeout

Type: Duration (optional, default: None)

Timeout for the task.

← PreviousNext →