Publish Message
- Shilpa
- Amritesh Singh
- Lakshmi Manda
In this article
Overview
You can use this Snap to send a message to an Amazon SNS topic. The message can be a text message (SMS message) directly to a phone number, or a message to a mobile platform endpoint (when you specify the TargetArn ). If you send a message to a topic, Amazon SNS delivers the message to each endpoint that is subscribed to the topic.
When you use this Snap to publish a message, that message can be consumed through various means, including subscription through the SQS Consumer Snap, email, or HTTP endpoint. If the message is under 256 KB, you can view it directly in the output preview. However, if it exceeds 256KB, the message's content does not display. Instead, a reference to the message is provided, typically in the form of an array of JSON object ontaining an S3 Key and S3 Bucket Name. To read the message, use the S3 File Reader, Email Reader, or S3 Download or S3 Select Snaps downstream of the Publish Message Snap. Refer to the following examples:
Prerequisites
Valid AWS Account and SNS access.
Authentication such as IAM Role access, Access key, and Security Access key.
Create Topic and Subscribe Topic to an endpoint (SQS/Email/Email-JSON etc) before performing the Publish Message action.
Set Attribute Name in Set Subscription Attribute to
FilterPolicyif you want to select Number, String, or String Array data types under Message attributes in Publish Message Snap.
Support for Ultra Pipelines
Works in Ultra Pipelines.
Limitations
The SnapLogic user interface (UI) has a maximum limit of 200 MB on the size of messages you can copy in the Message field of the Publish Message Snap. If the message size exceeds this limit, the Snap fails and displays an error message stating that the: 'update' command document is too large
Work-around: To publish messages greater than 200 MB, you can use upstream Snaps and input the message into the Publish Message Snap.
Known Issues
The Snap’s performance might decrease if you do not provide a value in the Region field. As a workaround, provide a value in the Region field for optimal performance of the Snap.
Snap Views
Input/Output | Type of View | Number of Views | Examples of Upstream and Downstream Snaps | Description |
|---|---|---|---|---|
Input | Document |
| Mapper | Region, ARN of the topic and the text message that you want to publish. |
Output | Document |
| Copy | Published message |
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: | |||