Amazon SNS code examples for the SDK for Python

Overview

Shows how to use the AWS SDK for Python (Boto3) to work with Amazon Simple Notification Service (Amazon SNS).

Amazon SNS is a web service that enables applications, end-users, and devices to instantly send and receive notifications from the cloud.

⚠ Important

• Running this code might result in charges to your AWS account. For more details, see AWS Pricing and Free Tier.
• Running the tests might result in charges to your AWS account.
• We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see Grant least privilege.
• This code is not tested in every AWS Region. For more information, see AWS Regional Services.

Code examples

Prerequisites

For prerequisites, see the README in the python folder.

Install the packages required by these examples by running the following in a virtual environment:

python -m pip install -r requirements.txt

Single actions

Code excerpts that show you how to call individual service functions.

• CreateTopic
• DeleteTopic
• ListSubscriptions
• ListTopics
• Publish
• SetSubscriptionAttributes
• Subscribe
• Unsubscribe

Scenarios

Code examples that show you how to accomplish a specific task by calling multiple functions within the same service.

• Create an Amazon Textract explorer application
• Create and publish to a FIFO topic
• Detect people and objects in a video
• Publish an SMS text message
• Publish messages to queues
• Use API Gateway to invoke a Lambda function
• Use scheduled events to invoke a Lambda function

Run the examples

Instructions

Run this example at a command prompt with the following command.

python sns_basics.py

Create an Amazon Textract explorer application

This example shows you how to explore Amazon Textract output through an interactive application.

Create and publish to a FIFO topic

This example shows you how to create and publish to a FIFO Amazon SNS topic.

Start the example by running the following at a command prompt:

python sns_fifo_topic.py

Detect people and objects in a video

This example shows you how to detect people and objects in a video with Amazon Rekognition.

Publish an SMS text message

This example shows you how to publish SMS messages using Amazon SNS.

Start the example by running the following at a command prompt:

python sns_basics.py

Publish messages to queues

This example shows you how to do the following:

• Create topic (FIFO or non-FIFO).
• Subscribe several queues to the topic with an option to apply a filter.
• Publish messages to the topic.
• Poll the queues for messages received.

Start the example by running the following at a command prompt:

python ../../cross_service/topics_and_queues/topics_and_queues_scenario.py

Use API Gateway to invoke a Lambda function

This example shows you how to create an AWS Lambda function invoked by Amazon API Gateway.

Use scheduled events to invoke a Lambda function

This example shows you how to create an AWS Lambda function invoked by an Amazon EventBridge scheduled event.

Tests

⚠ Running tests might result in charges to your AWS account.

To find instructions for running these tests, see the README in the python folder.

Additional resources

• Amazon SNS Developer Guide
• Amazon SNS API Reference
• SDK for Python Amazon SNS reference

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

SPDX-License-Identifier: Apache-2.0