Amazon SNS - Create Topic

Overview

You can use this Snap to create a topic, a logical access point that acts as a communication channel in Amazon Simple Notification Service (Amazon SNS). A topic lets you group multiple endpoints (such as AWS Lambda, Amazon SQS, HTTP/S, or an email address). You can create both Standard and FIFO (first in, first out) topics to broadcast the messages of a message-producer system (for example, an e-commerce website) working with multiple services that require its messages.


Amazon SNS - Create Topic Snap

Supported Accounts

Prerequisites

Valid AWS Account and SNS access.

Snap views

Type Description Examples of upstream and downstream Snaps
Input

Document. This Snap has at most one document input view.

The region, name, attributes, tag attributes, and other details of the topic.
Output

Document. This Snap has at most one document output view.

The created topic meets the required criteria.
Learn more about Error handling.

Snap settings

Note: Learn about the common controls in the Snap settings dialog.
Field/Field set Description

Label

String

 Required.Specify a unique name for the Snap. Modify this to be more appropriate, especially if there are more than one of the same Snap in the pipeline.

Default value: Create Topic

Example: Create Orders Topic
Region

String/Expression/ Suggestion

Specify the AWS region where an application is implemented. If the region field is empty, then the Snap evaluates the region in the following sequence:

  • The Topic ARN or Subscription ARN
  • The region of the EC2 instance.
Note: It is a best practice to provide value for the Region field.

Default value: N/A

Example: us-east-1, us-west-1
Topic Name

String/Expression

Required. Specify the name of the target topic.

Default value: N/A

Example: Topic 1
Attributes

Use this field set to specify the attributes for the topic.
Attribute Name

String/Expression/ Suggestion

Choose the attribute name:

  • DeliveryPolicy: The policy that defines how Amazon SNS retries failed deliveries to HTTP/S endpoints.
  • DisplayName: The display name to use for a topic with SMS subscriptions.
  • FifoTopic: When you select FifoTopic, the topic name should be with the extension .fifo and the Attribute value should be true.
  • Policy: The policy that defines the users who can access your topic. By default, only the topic owner can publish or subscribe to the topic.
  • KmsMasterKeyId: The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK.
  • ContentBasedDeduplication: Enables content-based deduplication for FIFO topics.

Default value: N/A

Example: displayName
Attribute Value

String/Expression

Specify a value for the attribute name.

Default value: N/A

Example: $displayName
Tag Attributes

Use this field set to specify the tag attributes for the topic.
Tag Name

String/Expression

Specify a name for the tag attribute.

Default value: N/A

Example: tag1
Value

String/Expression

Specify a name for the tag value.

Default value: N/A

Example: tag_Name1

Snap execution

Dropdown list
Choose one of the three modes in which the Snap executes. Available options are:
  • Validate & Execute: Performs limited execution of the Snap and generates a data preview during pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during pipeline runtime.
  • Execute only: Performs full execution of the Snap during pipeline execution without generating preview data.
  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Default value: Execute only

Troubleshooting

Error Cause Resolution
An error occurred while creating a topic with the given topic name in AWS SNS. Valid information might be missing. Check the input data, formats and try again.
One or more Pipeline parameters are given in the account. Validation is not applicable for Pipeline parameters. Do not validate the account if Pipeline parameters are provided.