Notify an Amazon SNS Topic
The Amazon SNS (Simple Notification Service) external action receives messages and sends them to an Amazon SNS topic. Amazon SNS topics serve as access points for subscribers to register for notifications and publishers to send messages. For more information about topics or other features of Amazon SNS, see the Amazon SNS Getting Started Guide.
The Amazon SNS external action has two output ports. The success port (✔) can send a message if the Amazon SNS topic is notified successfully. The failure port (x) can send a message if the notification fails.
Requirements
To use the Amazon SNS external action, you need:
- Amazon Web Services (AWS) security credentials.
- Ownership of the topic to be published to or permission to publish to the topic.
- The Amazon Resource Name (ARN) for the topic to be published to.
Assuming you are the topic owner, you can find the Topic ARN by navigating to your topic through the AWS Management Console (see below). Otherwise, ask the topic owner for the Topic ARN.
Parameters
Note: See also Working with Parameters in Automations Workflows.
Tip: To test that your parameters work as expected, click Validate.
- Provide the Topic Amazon Resource Name (ARN).
- Provide the AWS Access Key ID and AWS Secret Access Key fields. For more information, see AWS Security Credentials.
- The Subject field is optional.
- Notification Content Template contains the default message you want to publish to the Amazon SNS topic. The message can be up to 64 KB of Unicode text.
Output Keys
See Also
| Key | Description |
|---|---|
| time | Event time |
| source | Event type |
| sns.messageId | (Success port only) Message ID |
| error.type | (Failure port only) Error type |
| error.message | (Failure port only) Error message |
| aws.requestId | (Failure port only) AWS Request ID |
| aws.status | (Failure port only) AWS Status Code |
| aws.errorCode | (Failure port only) AWS Error Code |