AWS::SNS::Topic

SNS Topic

The AWS::SNS::Topic resource creates a topic to which notifications can be published. One account can create a maximum of 100,000 standard topics and 1,000 FIFO topics. For more information, see [endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/sns.html) in the *General Reference*. The structure of AUTHPARAMS depends on the .signature of the API request. For more information, see [Examples of the complete Signature Version 4 signing process](https://docs.aws.am...

Properties

13 configurable properties. Click a row to see details.

Filter:

Property	Type	Flags
`ArchivePolicy`	`object`
`ContentBasedDeduplication`	`boolean`
`DataProtectionPolicy`	`object`
`DeliveryStatusLogging`	`Array<LoggingConfig>`
`DisplayName`	`string`
`FifoThroughputScope`	`string`
`FifoTopic`	`boolean`	Create-only
`KmsMasterKeyId`	`string`
`SignatureVersion`	`string`
`Subscription`	`Array<Subscription>`
`Tags`	`Array<Tag>`
`TopicName`	`string`	Create-only
`TracingConfig`	`string`

Return Values

Values returned after the resource is created. Access these with Fn::GetAtt.

Attribute	Type	Description
`TopicArn`	`string`	-

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml

AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::SNS::Topic

Resources:
  MyResource:
    Type: AWS::SNS::Topic
    Properties:
      Tags:
        - Key: Environment
          Value: Production

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

create

sns:CreateTopicsns:TagResourcesns:Subscribesns:GetTopicAttributessns:PutDataProtectionPolicyiam:GetRoleiam:PassRole

read

sns:GetTopicAttributessns:ListTagsForResourcesns:ListSubscriptionsByTopicsns:GetDataProtectionPolicy

update

sns:SetTopicAttributessns:TagResourcesns:UntagResourcesns:Subscribesns:Unsubscribesns:GetTopicAttributessns:ListTagsForResourcesns:ListSubscriptionsByTopic

delete

sns:GetTopicAttributessns:DeleteTopic

list

sns:ListTopics

Get the SNS Cheat Sheet

Everything you need to know about SNS on one page. HD quality, print-friendly.

Download Free Infographic

Quick Facts

ServiceSNS

Properties14

Required0

TaggingSupported

Primary IDTopicArn

Supported Operations

CreateReadUpdateDeleteList

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

TopicNameFifoTopic

Related Resources

External Links

AWS Documentation