In this article
Overview
You can use this Snap to allow a subscription owner to set an attribute of the subscription to a new value.
Prerequisites
Valid AWS Account and SNS access.
Create Topic and Subscribe Topic to an endpoint (SQS/Email/Email-JSON etc) before performing the Set Subscription action.
Support for Ultra Pipelines
Works in Ultra Pipelines.
Limitations
None.
Known Issues
None.
Snap Input and Output
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| Subscribe Arn, region and attributes that you want to update or modify in the topic. |
Output | Document |
|
| The updated 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:
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
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 | Description |
---|---|---|
Label* | String | 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. Default Value: N/A |
Region | String | Specify the AWS region where the application is implemented. If the region field is not present, then the region will be evaluated in the following sequence by the Snap:
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 |
Subscribe Arn* | String | Specify the ARN of the subscription you want to delete. Default Value: N/A |
Attribute Name | String | Enter the name of the attribute in the topic. Following attributes are available:
Specifying a valid ARN for this attribute is required for Kinesis Data Firehose delivery stream subscriptions. For more information, see Fanout to Kinesis Data Firehose delivery streams in the Amazon SNS Developer Guide. Default Value: N/A |
Attribute Value | Integer | Enter the value of the attribute in the topic. Default Value: N/A |
Snap Execution | Dropdown list | Select one of the three modes in which the Snap executes. Available options are:
|
Troubleshooting
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 Subscribe ARN | Subscribe ARN is missing | The Subscribe ARN must be provide |
Examples
This example demonstrates how to set subscription attributes, once you create the topic and subscribe the endpoint to a topic.
For creating a topic and confirming an endpoint subscription to a topic, see https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/2361098961/Confirm+Subscription#Examples. Once the subscription is confirmed, the attributes in the subscription are managed with the help of Set Subscription attributes Snap.
After subscribing to the topic, the subscription attributes are managed with the Set Subscription Attributes Snap by providing the Subscription Arn. The Snap Settings and output view of the Snap are displayed as follows:
Downloads
Important steps to successfully reuse Pipelines
Snap Pack History
Release | Snap Pack Version | Date | Type | Updates |
---|---|---|---|---|
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