In this article
You can use this Snap to update and remove attributes and tags in a topic in Amazon SNS. Provide details of the attributes and tag attributes that you want to update or remove from the topic.
Valid AWS Account and SNS access.
Authentication such as IAM Role access, Access key, and Security Access key.
Create Topic to manage a topic.
Works in Ultra Pipelines.
None.
The Snap does not generate errors when a non-existing tag is removed.
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| Topic Arn, region, attributes and tag attributes that you want to update or modify in the topic. |
Output | Document |
|
| The updated topic is displayed. |
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. |
Icons used in the interface
|
Field Name | Field Type | Description |
---|---|---|
Label* | String | Specify a unique 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. Default Value: N/A |
Region | String | Specify the AWS region where the application is implemented. This is a suggestible field and suggestions will be populated based on the Account settings. If the region field is empty, then the Snap evaluates the region in the following sequence: It is a best practice to provide the value for Region field. It is a best practice to provide the value for Region field. Default value: None |
Topic Arn* | String | Specify the Amazon Resource Name of the topic. This is a suggestible field and suggestions will be populated based on the Account settings. Default Value: N/A |
Operation | Dropdown list | Select one of the three options for which you want the Snap to manage attributes or tags. Available options are:
|
Update topic attribute | Select to update the topic attributes. This field set consists of the following fields:
| |
Attribute Name | String | Enter the name of the attribute in the topic. This is a suggestible field and suggestions will be populated based on the Account settings. Default Value: N/A |
Attribute Value | Integer | Enter the value of the attribute in the topic. Default Value: N/A |
Update tag attributes | Select to update the tag attributes. This field set consists of the following fields:
| |
Tag Name | String | Specify a name for the tag attribute. |
Value | String | Specify a name for the tag value. |
Remove tag attributes | Select to remove the tag attributes. This field set consists Remove Tag Names field. | |
Remove Tag Names | String | Enter the names of the tag to remove from the topic. You can add any number of tag names by clicking the icon on the field set. |
Snap Execution | Dropdown | Select one of the three modes in which the Snap executes. Available options are:
|
Error | Reason | Resolution |
---|---|---|
An error occurred while updating a topic with the given topic name in AWS SNS. | Valid information might be missing. | Please check the input data, formats and try again. |
Missing Topic ARN | Topic ARN should not be blank | The topic ARN must be provided. |
In the following example, a topic is created with all the input details and it is updated or managed by adding or removing attributes.
First, a topic is created with the attribute and tag attributes:
Snap Settings | Input View |
---|---|
The Manage Topic Snap is used to perform certain operations like removing attributes and updating tags. Following are the Snap Settings:
Snap Settings | Input View |
---|---|
Provide links to the endpoint's official documentation, any relevant or related internal documentation, and any other links you have referred to on this page. Care should be taken when referencing external sites/documentation that it is an official site/documentation. Do not refer to forums such as stackoverflow.
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