Overview

You can use this Snap to subscribe to a topic on Amazon SNS. To receive messages published to a topic, you must subscribe an endpoint (for example, HTTP/HTTPS) to the topic. When you subscribe an endpoint to a topic, the endpoint receives messages published to the associated topic.

Prerequisites

For an Amazon SNS topic to be able to send messages to a queue, you should set a policy on the queue that allows the Amazon SNS topic to perform the SQS: SendMessage action before subscribing a queue to a topic. See Subscribing an Amazon SQS queue to an Amazon SNS topic - Amazon Simple Notification Service for further information.
Create an endpoint and topic and configure before you Subscribe Topic.

Support for Ultra Pipelines

Works in Ultra Pipelines.

Limitations

None.

Known Issues

None.

Snap Input and Output

Input/Output	Type of View	Number of Views	Examples of Upstream and Downstream Snaps	Description

Input/Output

Type of View

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input

Document

Min: 0
Max: 1

Mapper

The topic Arn, attributes, protocol and endpoint details of the topic.

Output

Document

Min: 0
Max: 1

Copy

The endpoint details that is subscribed to the topic.

Error

Error handling is to have a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that might arise while running the Pipeline by choosing one of the options from the When errors occur section under the Views tab.

The options available are:

Stop Pipeline Execution: Stops the current pipeline execution when an error arises.
Discard Error Data and Continue: Ignores an error completely, discard that record, and continue with the rest of the records.
Route Error Data to Error View: Routes the data to an error view of the Snap and then decides what to do with the error.

See Error View in Pipeline in examples to understand the Snap error view settings and error output. For more information on the error view and handling error output in a Pipeline, see Error handling in Pipelines.

Snap Settings

Asterisk (*): Indicates a mandatory field.
Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.
Expression icon (): Indicates whether the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.
Add icon (): Indicates that you can add fields in the field set.
Remove icon (): Indicates that you can remove fields from the field set.

Field Name		Field Type	Description

Subscribe Topic