Learn R Programming

paws.application.integration (version 0.1.5)

sns_create_topic: Creates a topic to which notifications can be published

Description

Creates a topic to which notifications can be published. Users can create at most 100,000 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.

Usage

sns_create_topic(Name, Attributes, Tags)

Arguments

Name

[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.

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.

  • 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.

Tags

The list of tags to add to a new topic.

Request syntax

svc$create_topic(
  Name = "string",
  Attributes = list(
    "string"
  ),
  Tags = list(
    list(
      Key = "string",
      Value = "string"
    )
  )
)