Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS
  3. API Docs
  4. sns
  5. Topic
AWS v6.73.0 published on Wednesday, Mar 19, 2025 by Pulumi
pulumi/pulumi-aws

aws.sns.Topic

Explore with Pulumi AI

aws logo
AWS v6.73.0 published on Wednesday, Mar 19, 2025 by Pulumi
pulumi/pulumi-aws

    Provides an SNS topic resource

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const userUpdates = new aws.sns.Topic("user_updates", {name: "user-updates-topic"});

    import pulumi
import pulumi_aws as aws

user_updates = aws.sns.Topic("user_updates", name="user-updates-topic")

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/sns"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := sns.NewTopic(ctx, "user_updates", &sns.TopicArgs{
			Name: pulumi.String("user-updates-topic"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var userUpdates = new Aws.Sns.Topic("user_updates", new()
    {
        Name = "user-updates-topic",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.sns.Topic;
import com.pulumi.aws.sns.TopicArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var userUpdates = new Topic("userUpdates", TopicArgs.builder()
            .name("user-updates-topic")
            .build());

    }
}

    resources:
  userUpdates:
    type: aws:sns:Topic
    name: user_updates
    properties:
      name: user-updates-topic

    Example with Delivery Policy

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const userUpdates = new aws.sns.Topic("user_updates", {
    name: "user-updates-topic",
    deliveryPolicy: `{
  "http": {
    "defaultHealthyRetryPolicy": {
      "minDelayTarget": 20,
      "maxDelayTarget": 20,
      "numRetries": 3,
      "numMaxDelayRetries": 0,
      "numNoDelayRetries": 0,
      "numMinDelayRetries": 0,
      "backoffFunction": "linear"
    },
    "disableSubscriptionOverrides": false,
    "defaultThrottlePolicy": {
      "maxReceivesPerSecond": 1
    }
  }
}
`,
});

    import pulumi
import pulumi_aws as aws

user_updates = aws.sns.Topic("user_updates",
    name="user-updates-topic",
    delivery_policy="""{
  "http": {
    "defaultHealthyRetryPolicy": {
      "minDelayTarget": 20,
      "maxDelayTarget": 20,
      "numRetries": 3,
      "numMaxDelayRetries": 0,
      "numNoDelayRetries": 0,
      "numMinDelayRetries": 0,
      "backoffFunction": "linear"
    },
    "disableSubscriptionOverrides": false,
    "defaultThrottlePolicy": {
      "maxReceivesPerSecond": 1
    }
  }
}
""")

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/sns"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := sns.NewTopic(ctx, "user_updates", &sns.TopicArgs{
			Name: pulumi.String("user-updates-topic"),
			DeliveryPolicy: pulumi.String(`{
  "http": {
    "defaultHealthyRetryPolicy": {
      "minDelayTarget": 20,
      "maxDelayTarget": 20,
      "numRetries": 3,
      "numMaxDelayRetries": 0,
      "numNoDelayRetries": 0,
      "numMinDelayRetries": 0,
      "backoffFunction": "linear"
    },
    "disableSubscriptionOverrides": false,
    "defaultThrottlePolicy": {
      "maxReceivesPerSecond": 1
    }
  }
}
`),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var userUpdates = new Aws.Sns.Topic("user_updates", new()
    {
        Name = "user-updates-topic",
        DeliveryPolicy = @"{
  ""http"": {
    ""defaultHealthyRetryPolicy"": {
      ""minDelayTarget"": 20,
      ""maxDelayTarget"": 20,
      ""numRetries"": 3,
      ""numMaxDelayRetries"": 0,
      ""numNoDelayRetries"": 0,
      ""numMinDelayRetries"": 0,
      ""backoffFunction"": ""linear""
    },
    ""disableSubscriptionOverrides"": false,
    ""defaultThrottlePolicy"": {
      ""maxReceivesPerSecond"": 1
    }
  }
}
",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.sns.Topic;
import com.pulumi.aws.sns.TopicArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var userUpdates = new Topic("userUpdates", TopicArgs.builder()
            .name("user-updates-topic")
            .deliveryPolicy("""
{
  "http": {
    "defaultHealthyRetryPolicy": {
      "minDelayTarget": 20,
      "maxDelayTarget": 20,
      "numRetries": 3,
      "numMaxDelayRetries": 0,
      "numNoDelayRetries": 0,
      "numMinDelayRetries": 0,
      "backoffFunction": "linear"
    },
    "disableSubscriptionOverrides": false,
    "defaultThrottlePolicy": {
      "maxReceivesPerSecond": 1
    }
  }
}
            """)
            .build());

    }
}

    resources:
  userUpdates:
    type: aws:sns:Topic
    name: user_updates
    properties:
      name: user-updates-topic
      deliveryPolicy: |
        {
          "http": {
            "defaultHealthyRetryPolicy": {
              "minDelayTarget": 20,
              "maxDelayTarget": 20,
              "numRetries": 3,
              "numMaxDelayRetries": 0,
              "numNoDelayRetries": 0,
              "numMinDelayRetries": 0,
              "backoffFunction": "linear"
            },
            "disableSubscriptionOverrides": false,
            "defaultThrottlePolicy": {
              "maxReceivesPerSecond": 1
            }
          }
        }

    Example with Server-side encryption (SSE)

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const userUpdates = new aws.sns.Topic("user_updates", {
    name: "user-updates-topic",
    kmsMasterKeyId: "alias/aws/sns",
});

    import pulumi
import pulumi_aws as aws

user_updates = aws.sns.Topic("user_updates",
    name="user-updates-topic",
    kms_master_key_id="alias/aws/sns")

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/sns"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := sns.NewTopic(ctx, "user_updates", &sns.TopicArgs{
			Name:           pulumi.String("user-updates-topic"),
			KmsMasterKeyId: pulumi.String("alias/aws/sns"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var userUpdates = new Aws.Sns.Topic("user_updates", new()
    {
        Name = "user-updates-topic",
        KmsMasterKeyId = "alias/aws/sns",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.sns.Topic;
import com.pulumi.aws.sns.TopicArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var userUpdates = new Topic("userUpdates", TopicArgs.builder()
            .name("user-updates-topic")
            .kmsMasterKeyId("alias/aws/sns")
            .build());

    }
}

    resources:
  userUpdates:
    type: aws:sns:Topic
    name: user_updates
    properties:
      name: user-updates-topic
      kmsMasterKeyId: alias/aws/sns

    Example with First-In-First-Out (FIFO)

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const userUpdates = new aws.sns.Topic("user_updates", {
    name: "user-updates-topic.fifo",
    fifoTopic: true,
    contentBasedDeduplication: true,
});

    import pulumi
import pulumi_aws as aws

user_updates = aws.sns.Topic("user_updates",
    name="user-updates-topic.fifo",
    fifo_topic=True,
    content_based_deduplication=True)

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/sns"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := sns.NewTopic(ctx, "user_updates", &sns.TopicArgs{
			Name:                      pulumi.String("user-updates-topic.fifo"),
			FifoTopic:                 pulumi.Bool(true),
			ContentBasedDeduplication: pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var userUpdates = new Aws.Sns.Topic("user_updates", new()
    {
        Name = "user-updates-topic.fifo",
        FifoTopic = true,
        ContentBasedDeduplication = true,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.sns.Topic;
import com.pulumi.aws.sns.TopicArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var userUpdates = new Topic("userUpdates", TopicArgs.builder()
            .name("user-updates-topic.fifo")
            .fifoTopic(true)
            .contentBasedDeduplication(true)
            .build());

    }
}

    resources:
  userUpdates:
    type: aws:sns:Topic
    name: user_updates
    properties:
      name: user-updates-topic.fifo
      fifoTopic: true
      contentBasedDeduplication: true

    Message Delivery Status Arguments

    The <endpoint>_success_feedback_role_arn and <endpoint>_failure_feedback_role_arn arguments are used to give Amazon SNS write access to use CloudWatch Logs on your behalf. The <endpoint>_success_feedback_sample_rate argument is for specifying the sample rate percentage (0-100) of successfully delivered messages. After you configure the <endpoint>_failure_feedback_role_arn argument, then all failed message deliveries generate CloudWatch Logs.

    Create Topic Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Topic(name: string, args?: TopicArgs, opts?: CustomResourceOptions);
    @overload
def Topic(resource_name: str,
          args: Optional[TopicArgs] = None,
          opts: Optional[ResourceOptions] = None)

@overload
def Topic(resource_name: str,
          opts: Optional[ResourceOptions] = None,
          application_failure_feedback_role_arn: Optional[str] = None,
          application_success_feedback_role_arn: Optional[str] = None,
          application_success_feedback_sample_rate: Optional[int] = None,
          archive_policy: Optional[str] = None,
          content_based_deduplication: Optional[bool] = None,
          delivery_policy: Optional[str] = None,
          display_name: Optional[str] = None,
          fifo_topic: Optional[bool] = None,
          firehose_failure_feedback_role_arn: Optional[str] = None,
          firehose_success_feedback_role_arn: Optional[str] = None,
          firehose_success_feedback_sample_rate: Optional[int] = None,
          http_failure_feedback_role_arn: Optional[str] = None,
          http_success_feedback_role_arn: Optional[str] = None,
          http_success_feedback_sample_rate: Optional[int] = None,
          kms_master_key_id: Optional[str] = None,
          lambda_failure_feedback_role_arn: Optional[str] = None,
          lambda_success_feedback_role_arn: Optional[str] = None,
          lambda_success_feedback_sample_rate: Optional[int] = None,
          name: Optional[str] = None,
          name_prefix: Optional[str] = None,
          policy: Optional[str] = None,
          signature_version: Optional[int] = None,
          sqs_failure_feedback_role_arn: Optional[str] = None,
          sqs_success_feedback_role_arn: Optional[str] = None,
          sqs_success_feedback_sample_rate: Optional[int] = None,
          tags: Optional[Mapping[str, str]] = None,
          tracing_config: Optional[str] = None)
    func NewTopic(ctx *Context, name string, args *TopicArgs, opts ...ResourceOption) (*Topic, error)
    public Topic(string name, TopicArgs? args = null, CustomResourceOptions? opts = null)
    public Topic(String name, TopicArgs args)
public Topic(String name, TopicArgs args, CustomResourceOptions options)

    type: aws:sns:Topic
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args TopicArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args TopicArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args TopicArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args TopicArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args TopicArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var topicResource = new Aws.Sns.Topic("topicResource", new()
{
    ApplicationFailureFeedbackRoleArn = "string",
    ApplicationSuccessFeedbackRoleArn = "string",
    ApplicationSuccessFeedbackSampleRate = 0,
    ArchivePolicy = "string",
    ContentBasedDeduplication = false,
    DeliveryPolicy = "string",
    DisplayName = "string",
    FifoTopic = false,
    FirehoseFailureFeedbackRoleArn = "string",
    FirehoseSuccessFeedbackRoleArn = "string",
    FirehoseSuccessFeedbackSampleRate = 0,
    HttpFailureFeedbackRoleArn = "string",
    HttpSuccessFeedbackRoleArn = "string",
    HttpSuccessFeedbackSampleRate = 0,
    KmsMasterKeyId = "string",
    LambdaFailureFeedbackRoleArn = "string",
    LambdaSuccessFeedbackRoleArn = "string",
    LambdaSuccessFeedbackSampleRate = 0,
    Name = "string",
    NamePrefix = "string",
    Policy = "string",
    SignatureVersion = 0,
    SqsFailureFeedbackRoleArn = "string",
    SqsSuccessFeedbackRoleArn = "string",
    SqsSuccessFeedbackSampleRate = 0,
    Tags = 
    {
        { "string", "string" },
    },
    TracingConfig = "string",
});

    example, err := sns.NewTopic(ctx, "topicResource", &sns.TopicArgs{
	ApplicationFailureFeedbackRoleArn:    pulumi.String("string"),
	ApplicationSuccessFeedbackRoleArn:    pulumi.String("string"),
	ApplicationSuccessFeedbackSampleRate: pulumi.Int(0),
	ArchivePolicy:                        pulumi.String("string"),
	ContentBasedDeduplication:            pulumi.Bool(false),
	DeliveryPolicy:                       pulumi.String("string"),
	DisplayName:                          pulumi.String("string"),
	FifoTopic:                            pulumi.Bool(false),
	FirehoseFailureFeedbackRoleArn:       pulumi.String("string"),
	FirehoseSuccessFeedbackRoleArn:       pulumi.String("string"),
	FirehoseSuccessFeedbackSampleRate:    pulumi.Int(0),
	HttpFailureFeedbackRoleArn:           pulumi.String("string"),
	HttpSuccessFeedbackRoleArn:           pulumi.String("string"),
	HttpSuccessFeedbackSampleRate:        pulumi.Int(0),
	KmsMasterKeyId:                       pulumi.String("string"),
	LambdaFailureFeedbackRoleArn:         pulumi.String("string"),
	LambdaSuccessFeedbackRoleArn:         pulumi.String("string"),
	LambdaSuccessFeedbackSampleRate:      pulumi.Int(0),
	Name:                                 pulumi.String("string"),
	NamePrefix:                           pulumi.String("string"),
	Policy:                               pulumi.String("string"),
	SignatureVersion:                     pulumi.Int(0),
	SqsFailureFeedbackRoleArn:            pulumi.String("string"),
	SqsSuccessFeedbackRoleArn:            pulumi.String("string"),
	SqsSuccessFeedbackSampleRate:         pulumi.Int(0),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	TracingConfig: pulumi.String("string"),
})

    var topicResource = new Topic("topicResource", TopicArgs.builder()
    .applicationFailureFeedbackRoleArn("string")
    .applicationSuccessFeedbackRoleArn("string")
    .applicationSuccessFeedbackSampleRate(0)
    .archivePolicy("string")
    .contentBasedDeduplication(false)
    .deliveryPolicy("string")
    .displayName("string")
    .fifoTopic(false)
    .firehoseFailureFeedbackRoleArn("string")
    .firehoseSuccessFeedbackRoleArn("string")
    .firehoseSuccessFeedbackSampleRate(0)
    .httpFailureFeedbackRoleArn("string")
    .httpSuccessFeedbackRoleArn("string")
    .httpSuccessFeedbackSampleRate(0)
    .kmsMasterKeyId("string")
    .lambdaFailureFeedbackRoleArn("string")
    .lambdaSuccessFeedbackRoleArn("string")
    .lambdaSuccessFeedbackSampleRate(0)
    .name("string")
    .namePrefix("string")
    .policy("string")
    .signatureVersion(0)
    .sqsFailureFeedbackRoleArn("string")
    .sqsSuccessFeedbackRoleArn("string")
    .sqsSuccessFeedbackSampleRate(0)
    .tags(Map.of("string", "string"))
    .tracingConfig("string")
    .build());

    topic_resource = aws.sns.Topic("topicResource",
    application_failure_feedback_role_arn="string",
    application_success_feedback_role_arn="string",
    application_success_feedback_sample_rate=0,
    archive_policy="string",
    content_based_deduplication=False,
    delivery_policy="string",
    display_name="string",
    fifo_topic=False,
    firehose_failure_feedback_role_arn="string",
    firehose_success_feedback_role_arn="string",
    firehose_success_feedback_sample_rate=0,
    http_failure_feedback_role_arn="string",
    http_success_feedback_role_arn="string",
    http_success_feedback_sample_rate=0,
    kms_master_key_id="string",
    lambda_failure_feedback_role_arn="string",
    lambda_success_feedback_role_arn="string",
    lambda_success_feedback_sample_rate=0,
    name="string",
    name_prefix="string",
    policy="string",
    signature_version=0,
    sqs_failure_feedback_role_arn="string",
    sqs_success_feedback_role_arn="string",
    sqs_success_feedback_sample_rate=0,
    tags={
        "string": "string",
    },
    tracing_config="string")

    const topicResource = new aws.sns.Topic("topicResource", {
    applicationFailureFeedbackRoleArn: "string",
    applicationSuccessFeedbackRoleArn: "string",
    applicationSuccessFeedbackSampleRate: 0,
    archivePolicy: "string",
    contentBasedDeduplication: false,
    deliveryPolicy: "string",
    displayName: "string",
    fifoTopic: false,
    firehoseFailureFeedbackRoleArn: "string",
    firehoseSuccessFeedbackRoleArn: "string",
    firehoseSuccessFeedbackSampleRate: 0,
    httpFailureFeedbackRoleArn: "string",
    httpSuccessFeedbackRoleArn: "string",
    httpSuccessFeedbackSampleRate: 0,
    kmsMasterKeyId: "string",
    lambdaFailureFeedbackRoleArn: "string",
    lambdaSuccessFeedbackRoleArn: "string",
    lambdaSuccessFeedbackSampleRate: 0,
    name: "string",
    namePrefix: "string",
    policy: "string",
    signatureVersion: 0,
    sqsFailureFeedbackRoleArn: "string",
    sqsSuccessFeedbackRoleArn: "string",
    sqsSuccessFeedbackSampleRate: 0,
    tags: {
        string: "string",
    },
    tracingConfig: "string",
});

    type: aws:sns:Topic
properties:
    applicationFailureFeedbackRoleArn: string
    applicationSuccessFeedbackRoleArn: string
    applicationSuccessFeedbackSampleRate: 0
    archivePolicy: string
    contentBasedDeduplication: false
    deliveryPolicy: string
    displayName: string
    fifoTopic: false
    firehoseFailureFeedbackRoleArn: string
    firehoseSuccessFeedbackRoleArn: string
    firehoseSuccessFeedbackSampleRate: 0
    httpFailureFeedbackRoleArn: string
    httpSuccessFeedbackRoleArn: string
    httpSuccessFeedbackSampleRate: 0
    kmsMasterKeyId: string
    lambdaFailureFeedbackRoleArn: string
    lambdaSuccessFeedbackRoleArn: string
    lambdaSuccessFeedbackSampleRate: 0
    name: string
    namePrefix: string
    policy: string
    signatureVersion: 0
    sqsFailureFeedbackRoleArn: string
    sqsSuccessFeedbackRoleArn: string
    sqsSuccessFeedbackSampleRate: 0
    tags:
        string: string
    tracingConfig: string

    Topic Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Topic resource accepts the following input properties:

    ApplicationFailureFeedbackRoleArn string
    IAM role for failure feedback
    ApplicationSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    ApplicationSuccessFeedbackSampleRate int
    Percentage of success to sample
    ArchivePolicy string
    The message archive policy for FIFO topics. More details in the AWS documentation.
    ContentBasedDeduplication bool
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    DeliveryPolicy string
    The SNS delivery policy. More details in the AWS documentation.
    DisplayName string
    The display name for the topic
    FifoTopic bool
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    FirehoseFailureFeedbackRoleArn string
    IAM role for failure feedback
    FirehoseSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    FirehoseSuccessFeedbackSampleRate int
    Percentage of success to sample
    HttpFailureFeedbackRoleArn string
    IAM role for failure feedback
    HttpSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    HttpSuccessFeedbackSampleRate int
    Percentage of success to sample
    KmsMasterKeyId string
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    LambdaFailureFeedbackRoleArn string
    IAM role for failure feedback
    LambdaSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    LambdaSuccessFeedbackSampleRate int
    Percentage of success to sample
    Name string
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    NamePrefix string
    Creates a unique name beginning with the specified prefix. Conflicts with name
    Policy string
    The fully-formed AWS policy as JSON.
    SignatureVersion int
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    SqsFailureFeedbackRoleArn string
    IAM role for failure feedback
    SqsSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    SqsSuccessFeedbackSampleRate int
    Percentage of success to sample
    Tags Dictionary<string, string>
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TracingConfig string
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    ApplicationFailureFeedbackRoleArn string
    IAM role for failure feedback
    ApplicationSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    ApplicationSuccessFeedbackSampleRate int
    Percentage of success to sample
    ArchivePolicy string
    The message archive policy for FIFO topics. More details in the AWS documentation.
    ContentBasedDeduplication bool
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    DeliveryPolicy string
    The SNS delivery policy. More details in the AWS documentation.
    DisplayName string
    The display name for the topic
    FifoTopic bool
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    FirehoseFailureFeedbackRoleArn string
    IAM role for failure feedback
    FirehoseSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    FirehoseSuccessFeedbackSampleRate int
    Percentage of success to sample
    HttpFailureFeedbackRoleArn string
    IAM role for failure feedback
    HttpSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    HttpSuccessFeedbackSampleRate int
    Percentage of success to sample
    KmsMasterKeyId string
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    LambdaFailureFeedbackRoleArn string
    IAM role for failure feedback
    LambdaSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    LambdaSuccessFeedbackSampleRate int
    Percentage of success to sample
    Name string
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    NamePrefix string
    Creates a unique name beginning with the specified prefix. Conflicts with name
    Policy string
    The fully-formed AWS policy as JSON.
    SignatureVersion int
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    SqsFailureFeedbackRoleArn string
    IAM role for failure feedback
    SqsSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    SqsSuccessFeedbackSampleRate int
    Percentage of success to sample
    Tags map[string]string
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TracingConfig string
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    applicationFailureFeedbackRoleArn String
    IAM role for failure feedback
    applicationSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    applicationSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    archivePolicy String
    The message archive policy for FIFO topics. More details in the AWS documentation.
    contentBasedDeduplication Boolean
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    deliveryPolicy String
    The SNS delivery policy. More details in the AWS documentation.
    displayName String
    The display name for the topic
    fifoTopic Boolean
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    firehoseFailureFeedbackRoleArn String
    IAM role for failure feedback
    firehoseSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    firehoseSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    httpFailureFeedbackRoleArn String
    IAM role for failure feedback
    httpSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    httpSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    kmsMasterKeyId String
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    lambdaFailureFeedbackRoleArn String
    IAM role for failure feedback
    lambdaSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    lambdaSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    name String
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    namePrefix String
    Creates a unique name beginning with the specified prefix. Conflicts with name
    policy String
    The fully-formed AWS policy as JSON.
    signatureVersion Integer
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    sqsFailureFeedbackRoleArn String
    IAM role for failure feedback
    sqsSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    sqsSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    tags Map<String,String>
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tracingConfig String
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    applicationFailureFeedbackRoleArn string
    IAM role for failure feedback
    applicationSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    applicationSuccessFeedbackSampleRate number
    Percentage of success to sample
    archivePolicy string
    The message archive policy for FIFO topics. More details in the AWS documentation.
    contentBasedDeduplication boolean
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    deliveryPolicy string
    The SNS delivery policy. More details in the AWS documentation.
    displayName string
    The display name for the topic
    fifoTopic boolean
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    firehoseFailureFeedbackRoleArn string
    IAM role for failure feedback
    firehoseSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    firehoseSuccessFeedbackSampleRate number
    Percentage of success to sample
    httpFailureFeedbackRoleArn string
    IAM role for failure feedback
    httpSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    httpSuccessFeedbackSampleRate number
    Percentage of success to sample
    kmsMasterKeyId string
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    lambdaFailureFeedbackRoleArn string
    IAM role for failure feedback
    lambdaSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    lambdaSuccessFeedbackSampleRate number
    Percentage of success to sample
    name string
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    namePrefix string
    Creates a unique name beginning with the specified prefix. Conflicts with name
    policy string
    The fully-formed AWS policy as JSON.
    signatureVersion number
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    sqsFailureFeedbackRoleArn string
    IAM role for failure feedback
    sqsSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    sqsSuccessFeedbackSampleRate number
    Percentage of success to sample
    tags {[key: string]: string}
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tracingConfig string
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    application_failure_feedback_role_arn str
    IAM role for failure feedback
    application_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    application_success_feedback_sample_rate int
    Percentage of success to sample
    archive_policy str
    The message archive policy for FIFO topics. More details in the AWS documentation.
    content_based_deduplication bool
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    delivery_policy str
    The SNS delivery policy. More details in the AWS documentation.
    display_name str
    The display name for the topic
    fifo_topic bool
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    firehose_failure_feedback_role_arn str
    IAM role for failure feedback
    firehose_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    firehose_success_feedback_sample_rate int
    Percentage of success to sample
    http_failure_feedback_role_arn str
    IAM role for failure feedback
    http_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    http_success_feedback_sample_rate int
    Percentage of success to sample
    kms_master_key_id str
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    lambda_failure_feedback_role_arn str
    IAM role for failure feedback
    lambda_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    lambda_success_feedback_sample_rate int
    Percentage of success to sample
    name str
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    name_prefix str
    Creates a unique name beginning with the specified prefix. Conflicts with name
    policy str
    The fully-formed AWS policy as JSON.
    signature_version int
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    sqs_failure_feedback_role_arn str
    IAM role for failure feedback
    sqs_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    sqs_success_feedback_sample_rate int
    Percentage of success to sample
    tags Mapping[str, str]
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tracing_config str
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    applicationFailureFeedbackRoleArn String
    IAM role for failure feedback
    applicationSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    applicationSuccessFeedbackSampleRate Number
    Percentage of success to sample
    archivePolicy String
    The message archive policy for FIFO topics. More details in the AWS documentation.
    contentBasedDeduplication Boolean
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    deliveryPolicy String
    The SNS delivery policy. More details in the AWS documentation.
    displayName String
    The display name for the topic
    fifoTopic Boolean
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    firehoseFailureFeedbackRoleArn String
    IAM role for failure feedback
    firehoseSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    firehoseSuccessFeedbackSampleRate Number
    Percentage of success to sample
    httpFailureFeedbackRoleArn String
    IAM role for failure feedback
    httpSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    httpSuccessFeedbackSampleRate Number
    Percentage of success to sample
    kmsMasterKeyId String
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    lambdaFailureFeedbackRoleArn String
    IAM role for failure feedback
    lambdaSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    lambdaSuccessFeedbackSampleRate Number
    Percentage of success to sample
    name String
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    namePrefix String
    Creates a unique name beginning with the specified prefix. Conflicts with name
    policy String
    The fully-formed AWS policy as JSON.
    signatureVersion Number
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    sqsFailureFeedbackRoleArn String
    IAM role for failure feedback
    sqsSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    sqsSuccessFeedbackSampleRate Number
    Percentage of success to sample
    tags Map<String>
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tracingConfig String
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Topic resource produces the following output properties:

    Arn string
    The ARN of the SNS topic, as a more obvious property (clone of id)
    BeginningArchiveTime string
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    Id string
    The provider-assigned unique ID for this managed resource.
    Owner string
    The AWS Account ID of the SNS topic owner
    TagsAll Dictionary<string, string>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    Arn string
    The ARN of the SNS topic, as a more obvious property (clone of id)
    BeginningArchiveTime string
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    Id string
    The provider-assigned unique ID for this managed resource.
    Owner string
    The AWS Account ID of the SNS topic owner
    TagsAll map[string]string
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    arn String
    The ARN of the SNS topic, as a more obvious property (clone of id)
    beginningArchiveTime String
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    id String
    The provider-assigned unique ID for this managed resource.
    owner String
    The AWS Account ID of the SNS topic owner
    tagsAll Map<String,String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    arn ARN
    The ARN of the SNS topic, as a more obvious property (clone of id)
    beginningArchiveTime string
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    id string
    The provider-assigned unique ID for this managed resource.
    owner string
    The AWS Account ID of the SNS topic owner
    tagsAll {[key: string]: string}
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    arn str
    The ARN of the SNS topic, as a more obvious property (clone of id)
    beginning_archive_time str
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    id str
    The provider-assigned unique ID for this managed resource.
    owner str
    The AWS Account ID of the SNS topic owner
    tags_all Mapping[str, str]
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    arn
    The ARN of the SNS topic, as a more obvious property (clone of id)
    beginningArchiveTime String
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    id String
    The provider-assigned unique ID for this managed resource.
    owner String
    The AWS Account ID of the SNS topic owner
    tagsAll Map<String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    Look up Existing Topic Resource

    Get an existing Topic resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: TopicState, opts?: CustomResourceOptions): Topic
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        application_failure_feedback_role_arn: Optional[str] = None,
        application_success_feedback_role_arn: Optional[str] = None,
        application_success_feedback_sample_rate: Optional[int] = None,
        archive_policy: Optional[str] = None,
        arn: Optional[str] = None,
        beginning_archive_time: Optional[str] = None,
        content_based_deduplication: Optional[bool] = None,
        delivery_policy: Optional[str] = None,
        display_name: Optional[str] = None,
        fifo_topic: Optional[bool] = None,
        firehose_failure_feedback_role_arn: Optional[str] = None,
        firehose_success_feedback_role_arn: Optional[str] = None,
        firehose_success_feedback_sample_rate: Optional[int] = None,
        http_failure_feedback_role_arn: Optional[str] = None,
        http_success_feedback_role_arn: Optional[str] = None,
        http_success_feedback_sample_rate: Optional[int] = None,
        kms_master_key_id: Optional[str] = None,
        lambda_failure_feedback_role_arn: Optional[str] = None,
        lambda_success_feedback_role_arn: Optional[str] = None,
        lambda_success_feedback_sample_rate: Optional[int] = None,
        name: Optional[str] = None,
        name_prefix: Optional[str] = None,
        owner: Optional[str] = None,
        policy: Optional[str] = None,
        signature_version: Optional[int] = None,
        sqs_failure_feedback_role_arn: Optional[str] = None,
        sqs_success_feedback_role_arn: Optional[str] = None,
        sqs_success_feedback_sample_rate: Optional[int] = None,
        tags: Optional[Mapping[str, str]] = None,
        tags_all: Optional[Mapping[str, str]] = None,
        tracing_config: Optional[str] = None) -> Topic
    func GetTopic(ctx *Context, name string, id IDInput, state *TopicState, opts ...ResourceOption) (*Topic, error)
    public static Topic Get(string name, Input<string> id, TopicState? state, CustomResourceOptions? opts = null)
    public static Topic get(String name, Output<String> id, TopicState state, CustomResourceOptions options)
    resources:  _:    type: aws:sns:Topic    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    ApplicationFailureFeedbackRoleArn string
    IAM role for failure feedback
    ApplicationSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    ApplicationSuccessFeedbackSampleRate int
    Percentage of success to sample
    ArchivePolicy string
    The message archive policy for FIFO topics. More details in the AWS documentation.
    Arn string
    The ARN of the SNS topic, as a more obvious property (clone of id)
    BeginningArchiveTime string
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    ContentBasedDeduplication bool
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    DeliveryPolicy string
    The SNS delivery policy. More details in the AWS documentation.
    DisplayName string
    The display name for the topic
    FifoTopic bool
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    FirehoseFailureFeedbackRoleArn string
    IAM role for failure feedback
    FirehoseSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    FirehoseSuccessFeedbackSampleRate int
    Percentage of success to sample
    HttpFailureFeedbackRoleArn string
    IAM role for failure feedback
    HttpSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    HttpSuccessFeedbackSampleRate int
    Percentage of success to sample
    KmsMasterKeyId string
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    LambdaFailureFeedbackRoleArn string
    IAM role for failure feedback
    LambdaSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    LambdaSuccessFeedbackSampleRate int
    Percentage of success to sample
    Name string
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    NamePrefix string
    Creates a unique name beginning with the specified prefix. Conflicts with name
    Owner string
    The AWS Account ID of the SNS topic owner
    Policy string
    The fully-formed AWS policy as JSON.
    SignatureVersion int
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    SqsFailureFeedbackRoleArn string
    IAM role for failure feedback
    SqsSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    SqsSuccessFeedbackSampleRate int
    Percentage of success to sample
    Tags Dictionary<string, string>
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll Dictionary<string, string>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    TracingConfig string
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    ApplicationFailureFeedbackRoleArn string
    IAM role for failure feedback
    ApplicationSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    ApplicationSuccessFeedbackSampleRate int
    Percentage of success to sample
    ArchivePolicy string
    The message archive policy for FIFO topics. More details in the AWS documentation.
    Arn string
    The ARN of the SNS topic, as a more obvious property (clone of id)
    BeginningArchiveTime string
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    ContentBasedDeduplication bool
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    DeliveryPolicy string
    The SNS delivery policy. More details in the AWS documentation.
    DisplayName string
    The display name for the topic
    FifoTopic bool
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    FirehoseFailureFeedbackRoleArn string
    IAM role for failure feedback
    FirehoseSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    FirehoseSuccessFeedbackSampleRate int
    Percentage of success to sample
    HttpFailureFeedbackRoleArn string
    IAM role for failure feedback
    HttpSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    HttpSuccessFeedbackSampleRate int
    Percentage of success to sample
    KmsMasterKeyId string
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    LambdaFailureFeedbackRoleArn string
    IAM role for failure feedback
    LambdaSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    LambdaSuccessFeedbackSampleRate int
    Percentage of success to sample
    Name string
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    NamePrefix string
    Creates a unique name beginning with the specified prefix. Conflicts with name
    Owner string
    The AWS Account ID of the SNS topic owner
    Policy string
    The fully-formed AWS policy as JSON.
    SignatureVersion int
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    SqsFailureFeedbackRoleArn string
    IAM role for failure feedback
    SqsSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    SqsSuccessFeedbackSampleRate int
    Percentage of success to sample
    Tags map[string]string
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll map[string]string
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    TracingConfig string
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    applicationFailureFeedbackRoleArn String
    IAM role for failure feedback
    applicationSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    applicationSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    archivePolicy String
    The message archive policy for FIFO topics. More details in the AWS documentation.
    arn String
    The ARN of the SNS topic, as a more obvious property (clone of id)
    beginningArchiveTime String
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    contentBasedDeduplication Boolean
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    deliveryPolicy String
    The SNS delivery policy. More details in the AWS documentation.
    displayName String
    The display name for the topic
    fifoTopic Boolean
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    firehoseFailureFeedbackRoleArn String
    IAM role for failure feedback
    firehoseSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    firehoseSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    httpFailureFeedbackRoleArn String
    IAM role for failure feedback
    httpSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    httpSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    kmsMasterKeyId String
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    lambdaFailureFeedbackRoleArn String
    IAM role for failure feedback
    lambdaSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    lambdaSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    name String
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    namePrefix String
    Creates a unique name beginning with the specified prefix. Conflicts with name
    owner String
    The AWS Account ID of the SNS topic owner
    policy String
    The fully-formed AWS policy as JSON.
    signatureVersion Integer
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    sqsFailureFeedbackRoleArn String
    IAM role for failure feedback
    sqsSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    sqsSuccessFeedbackSampleRate Integer
    Percentage of success to sample
    tags Map<String,String>
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String,String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    tracingConfig String
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    applicationFailureFeedbackRoleArn string
    IAM role for failure feedback
    applicationSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    applicationSuccessFeedbackSampleRate number
    Percentage of success to sample
    archivePolicy string
    The message archive policy for FIFO topics. More details in the AWS documentation.
    arn ARN
    The ARN of the SNS topic, as a more obvious property (clone of id)
    beginningArchiveTime string
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    contentBasedDeduplication boolean
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    deliveryPolicy string
    The SNS delivery policy. More details in the AWS documentation.
    displayName string
    The display name for the topic
    fifoTopic boolean
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    firehoseFailureFeedbackRoleArn string
    IAM role for failure feedback
    firehoseSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    firehoseSuccessFeedbackSampleRate number
    Percentage of success to sample
    httpFailureFeedbackRoleArn string
    IAM role for failure feedback
    httpSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    httpSuccessFeedbackSampleRate number
    Percentage of success to sample
    kmsMasterKeyId string
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    lambdaFailureFeedbackRoleArn string
    IAM role for failure feedback
    lambdaSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    lambdaSuccessFeedbackSampleRate number
    Percentage of success to sample
    name string
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    namePrefix string
    Creates a unique name beginning with the specified prefix. Conflicts with name
    owner string
    The AWS Account ID of the SNS topic owner
    policy string
    The fully-formed AWS policy as JSON.
    signatureVersion number
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    sqsFailureFeedbackRoleArn string
    IAM role for failure feedback
    sqsSuccessFeedbackRoleArn string
    The IAM role permitted to receive success feedback for this topic
    sqsSuccessFeedbackSampleRate number
    Percentage of success to sample
    tags {[key: string]: string}
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll {[key: string]: string}
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    tracingConfig string
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    application_failure_feedback_role_arn str
    IAM role for failure feedback
    application_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    application_success_feedback_sample_rate int
    Percentage of success to sample
    archive_policy str
    The message archive policy for FIFO topics. More details in the AWS documentation.
    arn str
    The ARN of the SNS topic, as a more obvious property (clone of id)
    beginning_archive_time str
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    content_based_deduplication bool
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    delivery_policy str
    The SNS delivery policy. More details in the AWS documentation.
    display_name str
    The display name for the topic
    fifo_topic bool
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    firehose_failure_feedback_role_arn str
    IAM role for failure feedback
    firehose_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    firehose_success_feedback_sample_rate int
    Percentage of success to sample
    http_failure_feedback_role_arn str
    IAM role for failure feedback
    http_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    http_success_feedback_sample_rate int
    Percentage of success to sample
    kms_master_key_id str
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    lambda_failure_feedback_role_arn str
    IAM role for failure feedback
    lambda_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    lambda_success_feedback_sample_rate int
    Percentage of success to sample
    name str
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    name_prefix str
    Creates a unique name beginning with the specified prefix. Conflicts with name
    owner str
    The AWS Account ID of the SNS topic owner
    policy str
    The fully-formed AWS policy as JSON.
    signature_version int
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    sqs_failure_feedback_role_arn str
    IAM role for failure feedback
    sqs_success_feedback_role_arn str
    The IAM role permitted to receive success feedback for this topic
    sqs_success_feedback_sample_rate int
    Percentage of success to sample
    tags Mapping[str, str]
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tags_all Mapping[str, str]
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    tracing_config str
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".
    applicationFailureFeedbackRoleArn String
    IAM role for failure feedback
    applicationSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    applicationSuccessFeedbackSampleRate Number
    Percentage of success to sample
    archivePolicy String
    The message archive policy for FIFO topics. More details in the AWS documentation.
    arn
    The ARN of the SNS topic, as a more obvious property (clone of id)
    beginningArchiveTime String
    The oldest timestamp at which a FIFO topic subscriber can start a replay.
    contentBasedDeduplication Boolean
    Enables content-based deduplication for FIFO topics. For more information, see the related documentation
    deliveryPolicy String
    The SNS delivery policy. More details in the AWS documentation.
    displayName String
    The display name for the topic
    fifoTopic Boolean
    Boolean indicating whether or not to create a FIFO (first-in-first-out) topic. FIFO topics can't deliver messages to customer managed endpoints, such as email addresses, mobile apps, SMS, or HTTP(S) endpoints. These endpoint types aren't guaranteed to preserve strict message ordering. Default is false.
    firehoseFailureFeedbackRoleArn String
    IAM role for failure feedback
    firehoseSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    firehoseSuccessFeedbackSampleRate Number
    Percentage of success to sample
    httpFailureFeedbackRoleArn String
    IAM role for failure feedback
    httpSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    httpSuccessFeedbackSampleRate Number
    Percentage of success to sample
    kmsMasterKeyId String
    The ID of an AWS-managed customer master key (CMK) for Amazon SNS or a custom CMK. For more information, see Key Terms
    lambdaFailureFeedbackRoleArn String
    IAM role for failure feedback
    lambdaSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    lambdaSuccessFeedbackSampleRate Number
    Percentage of success to sample
    name String
    The name of the topic. 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. If omitted, the provider will assign a random, unique name. Conflicts with name_prefix
    namePrefix String
    Creates a unique name beginning with the specified prefix. Conflicts with name
    owner String
    The AWS Account ID of the SNS topic owner
    policy String
    The fully-formed AWS policy as JSON.
    signatureVersion Number
    If SignatureVersion should be 1 (SHA1) or 2 (SHA256). The signature version corresponds to the hashing algorithm used while creating the signature of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS.
    sqsFailureFeedbackRoleArn String
    IAM role for failure feedback
    sqsSuccessFeedbackRoleArn String
    The IAM role permitted to receive success feedback for this topic
    sqsSuccessFeedbackSampleRate Number
    Percentage of success to sample
    tags Map<String>
    Key-value map of resource tags. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String>
    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    tracingConfig String
    Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".

    Import

    Using pulumi import, import SNS Topics using the topic arn. For example:

    $ pulumi import aws:sns/topic:Topic user_updates arn:aws:sns:us-west-2:123456789012:my-topic

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    AWS v6.73.0 published on Wednesday, Mar 19, 2025 by Pulumi
    pulumi/pulumi-aws