In this article
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 other services that require its messages.
Prerequisites
Valid AWS Account and SNS access.
Support for Ultra Pipelines
Works in Ultra Pipelines.
Limitations
None.
Known Issues
None.
Views
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| The region, name, attributes, tag attributes, and other details of the topic. |
Output | Document |
|
| The created topic meets the required criteria. |
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:
See https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/2360902284/Create+Topic#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 Handling Errors with an Error Pipeline. |
Snap Settings
Icons used in the interface
Asterisk (*) - Mandatory fields.
Suggestion icon - Suggestible fields and suggestions will be populated based on the Account settings.
Expression icon - Enable when you want to use expressions as field values.
Field Name | Field Type | Field Dependency | Description |
---|---|---|---|
Label* Default Value: N/A | String | None | The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline. |
Region | String | None | Specify the AWS region where the application is implemented. If the region field is empty, then the Snap evaluates the region in the following sequence:
It is a best practice to provide value for the Region field. |
Default Value: N/A | |||
Topic Name* Default Value: N/A | String | None | Specify the name of the target topic. |
Attributes | Use this field set to define attributes for the new entry. This field set consists of the following fields:
| ||
Attribute Name Default value: N/A | String | None | Select the attribute name. Alternatively, click the Suggestion icon to fetch a list of attribute names associated with the entity type. Options available are:
|
Attribute Value Default value: N/A | String | None | Specify a value for the attribute name. |
Tag Attributes | Use this field set to define tag attributes for the new entry. This field set consists of the following fields:
| ||
Tag Name | String | None | Specify a name for the tag attribute. |
Value | String | None | Specify a name for the tag value. |
Snap Execution Default value: Execute only | Dropdown | Select one of the three modes in which the Snap executes. Available options are:
|
Troubleshooting
Error | Reason | 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 |
Examples
In the following Pipeline, the Create Topic Snap is used to create a topic with the attribute name, tag attributes, and other details. This enables the topic to be created with the given details.
In the following Mapper Snap, the topic name and other details are provided. A topic name and the topic details are given as inputs to the Delete Topic Snap. The Mapper Snap is configured with the following details and the output view is displayed is as follows. Delete Topic Snap is used before Create Topic to avoid overwriting the data in the topic.
After the Mapper Snap, the Create Topic Snap is configured with the following attributes and tag attributes. The output view of the Snap is displayed as follows:
Error View in Pipeline
When encountering an error, if you select Route Error Data to Error View in the Views tab, then the error output is routed to a different output to view the error data upon validation. The main Pipeline does not have any output.
If you select Stop Pipeline Execution in the Views tab, then the Pipeline is not validated.
Downloads
Snap Pack History
Release | Snap Pack Version | Date | Type | Updates |
---|---|---|---|---|
August 2024 | main27765 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
May 2024 | main26341 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
February 2024 | main25112 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
November 2023 | main23721 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
August 2023 | main22460 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
May 2023 | main21015 |
| Stable | Upgraded with the latest SnapLogic Platform release. |
February 2023 | 432patches20327 |
| Latest | The Amazon SNS account is enhanced with the Enable large message support checkbox to support publishing messages larger than 256KB. When you select this checkbox, the Snap displays S3 related properties that enables you to store the messages in the S3 bucket. |
February 2023 | main19844 |
| Stable | Upgraded with the latest SnapLogic Platform release. |
November 2022 | main18944 | 10 Nov 2022 | Stable | Upgraded with the latest SnapLogic Platform release. |
August 2022 | main17386 | 11 Aug 2022 | Stable | Upgraded with the latest SnapLogic Platform release. |
4.29 | main15993 | 14 May 2022 | Stable | Upgraded with the latest SnapLogic Platform release. |
4.28 | main14627 | 12 Feb 2022 | Stable | Upgraded with the latest SnapLogic Platform release. |
4.27 | main12833 |
| Stable | Amazon Simple Notification Service (Amazon SNS) is a managed service that provides message delivery from publishers to subscribers. Amazon SNS Snap Pack has the following Snaps: |
See Also
https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/1439233/Glossary
https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/1438341/Getting+Started
https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/1439233/Glossary