Creates a topic to which notifications can be published. Users can create at most 100,000 standard topics (at most 1,000 FIFO topics). For more information, see https://aws.amazon.com/sns. This action is idempotent, so if the requester already owns a topic with the specified name, that topic's ARN is returned without creating a new topic.
sns_create_topic(Name, Attributes, Tags)[required] The name of the topic you want to create.
Constraints: Topic names must be made up of only uppercase and lowercase ASCII letters, numbers, underscores, and hyphens, and must be between 1 and 256 characters long.
For a FIFO (first-in-first-out) topic, the name must end with the
.fifo suffix.
A map of attributes with their corresponding values.
The following lists the names, descriptions, and values of the special
request parameters that the create_topic action
uses:
DeliveryPolicy <U+2013> The policy that defines how Amazon SNS retries
failed deliveries to HTTP/S endpoints.
DisplayName <U+2013> The display name to use for a topic with SMS
subscriptions.
FifoTopic <U+2013> Set to true to create a FIFO topic.
Policy <U+2013> The policy that defines who can access your topic. By
default, only the topic owner can publish or subscribe to the topic.
The following attribute applies only to server-side-encryption:
KmsMasterKeyId <U+2013> The ID of an AWS-managed customer master key
(CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms.
For more examples, see
KeyId
in the AWS Key Management Service API Reference.
The following attributes apply only to FIFO topics:
FifoTopic <U+2013> When this is set to true, a FIFO topic is created.
ContentBasedDeduplication <U+2013> Enables content-based deduplication
for FIFO topics.
By default, ContentBasedDeduplication is set to false. If
you create a FIFO topic and this attribute is false, you must
specify a value for the MessageDeduplicationId parameter for
the publish action.
When you set ContentBasedDeduplication to true, Amazon SNS
uses a SHA-256 hash to generate the MessageDeduplicationId
using the body of the message (but not the attributes of the
message).
(Optional) To override the generated value, you can specify a
value for the the MessageDeduplicationId parameter for the
publish action.
The list of tags to add to a new topic.
To be able to tag a topic on creation, you must have the
sns:CreateTopic and sns:TagResource permissions.
A list with the following syntax:
list( TopicArn = "string" )
svc$create_topic(
Name = "string",
Attributes = list(
"string"
),
Tags = list(
list(
Key = "string",
Value = "string"
)
)
)