Table of Contents

Class CreateTopicRequest

Namespace
Amazon.SimpleNotificationService.Model
Assembly
AWSSDK.SimpleNotificationService.dll

Container for the parameters to the CreateTopic operation. 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.

public class CreateTopicRequest : AmazonSimpleNotificationServiceRequest
Inheritance
CreateTopicRequest

Constructors

CreateTopicRequest()

Empty constructor used to set properties independently even when a simple constructor is available

public CreateTopicRequest()

CreateTopicRequest(string)

Instantiates CreateTopicRequest with the parameterized properties

public CreateTopicRequest(string name)

Parameters

name string

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.

Properties

Attributes

Gets and sets the property Attributes.

A map of attributes with their corresponding values.

The following lists the names, descriptions, and values of the special request parameters that the 

CreateTopic
action uses: 

  • DeliveryPolicy
    – The policy that defines how Amazon SNS retries failed deliveries to HTTP/S endpoints. 

  • DisplayName
    – The display name to use for a topic with SMS subscriptions. 

  • FifoTopic
    – Set to true to create a FIFO topic. 

  • Policy
    – 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
    – 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
    – When this is set to 
    true
    , a FIFO topic is created. 

  • ContentBasedDeduplication
    – 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. 
public Dictionary<string, string> Attributes { get; set; }

Property Value

Dictionary<string, string>

Name

Gets and sets the property Name.

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. 
public string Name { get; set; }

Property Value

string

Tags

Gets and sets the property Tags.

The list of tags to add to a new topic.

note

To be able to tag a topic on creation, you must have the 

sns:CreateTopic
and 
sns:TagResource
permissions. 
public List<Tag> Tags { get; set; }

Property Value

List<Tag>