AWS Fundamentals Logo
AWS Fundamentals
AWS::SNS::Subscription

SNS Subscription

Resource Type definition for AWS::SNS::Subscription

Properties

11 configurable properties. 2 required. Click a row to see details.

Filter:
PropertyTypeFlags
Protocol
string
RequiredCreate-only
TopicArn
string
RequiredCreate-only
DeliveryPolicy
objectstring
Endpoint
string
Create-only
FilterPolicy
objectstring
FilterPolicyScope
string
RawMessageDelivery
boolean
RedrivePolicy
objectstring
Region
string
Write-only
ReplayPolicy
objectstring
SubscriptionRoleArn
string

Return Values

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

AttributeTypeDescription
ArnstringArn of the subscription

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::Subscription

Resources:
  MyResource:
    Type: AWS::SNS::Subscription
    Properties:
      TopicArn: "arn:aws:service:region:account:resource"
      Protocol: "value"

Required IAM Permissions

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

create

iam:GetRoleiam:PassRolesns:Subscribe

read

sns:GetSubscriptionAttributes

update

iam:GetRoleiam:PassRolesns:SetSubscriptionAttributes

delete

sns:Unsubscribesns:GetSubscriptionAttributes

list

sns:ListSubscriptions

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
Properties12
Required2
TaggingNot supported
Primary IDArn

Supported Operations

CreateReadUpdateDeleteList

Immutable After Creation

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

EndpointProtocolTopicArn

Related Resources

External Links