In this article
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.
Valid AWS Account and SNS access.
Works in Ultra Pipelines.
None.
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 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. |
|
Field Name | Field Type | Field Dependency | Description | |
---|---|---|---|---|
Label* Default Value: Create topic | String | None | Specify the unique name of 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 Default Value: N/A | String/Suggestion | None | 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:
It is a best practice to provide value for the Region field. It is a best practice to provide value for the Region field. | |
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. | |||
Attribute Name Default Value: N/A | String/Suggestion | None | Choose the attribute name:
| |
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. | |||
Tag Name Default Value: N/A | 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 list | Select one of the three modes in which the Snap executes. Available options are:
|
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. |
The following example Pipeline demonstrates how to create a topic with the attribute name, tag attributes, and other 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.
Next, we configure Create Topic Snap with the following attributes and tag attributes.
The output view of the Snap is displayed as follows:
The topic is created with the given details.
|
https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/1439233/Glossary
Getting Started with SnapLogic
https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/1439233/Glossary