Topic

AWS v5.43.0 (5.x), Mar 10 26

Viewing docs for AWS v5.43.0 (Older version)
published on Tuesday, Mar 10, 2026 by Pulumi

Go to latest version

Schema (JSON)

pulumi/pulumi-aws

Viewing docs for AWS v5.43.0 (Older version)
published on Tuesday, Mar 10, 2026 by Pulumi

Go to latest version

Schema (JSON)

pulumi/pulumi-aws

Example with Delivery Policy

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

const userUpdates = new aws.sns.Topic("userUpdates", {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("userUpdates", delivery_policy="""{
  "http": {
    "defaultHealthyRetryPolicy": {
      "minDelayTarget": 20,
      "maxDelayTarget": 20,
      "numRetries": 3,
      "numMaxDelayRetries": 0,
      "numNoDelayRetries": 0,
      "numMinDelayRetries": 0,
      "backoffFunction": "linear"
    },
    "disableSubscriptionOverrides": false,
    "defaultThrottlePolicy": {
      "maxReceivesPerSecond": 1
    }
  }
}

""")

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

return await Deployment.RunAsync(() => 
{
    var userUpdates = new Aws.Sns.Topic("userUpdates", new()
    {
        DeliveryPolicy = @"{
  ""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/v5/go/aws/sns"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := sns.NewTopic(ctx, "userUpdates", &sns.TopicArgs{
			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
	})
}

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()        
            .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
    properties:
      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("userUpdates", {kmsMasterKeyId: "alias/aws/sns"});

import pulumi
import pulumi_aws as aws

user_updates = aws.sns.Topic("userUpdates", kms_master_key_id="alias/aws/sns")

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

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

});

package main

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

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

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()        
            .kmsMasterKeyId("alias/aws/sns")
            .build());

    }
}

resources:
  userUpdates:
    type: aws:sns:Topic
    properties:
      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("userUpdates", {
    contentBasedDeduplication: true,
    fifoTopic: true,
});

import pulumi
import pulumi_aws as aws

user_updates = aws.sns.Topic("userUpdates",
    content_based_deduplication=True,
    fifo_topic=True)

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

return await Deployment.RunAsync(() => 
{
    var userUpdates = new Aws.Sns.Topic("userUpdates", new()
    {
        ContentBasedDeduplication = true,
        FifoTopic = true,
    });

});

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := sns.NewTopic(ctx, "userUpdates", &sns.TopicArgs{
			ContentBasedDeduplication: pulumi.Bool(true),
			FifoTopic:                 pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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()        
            .contentBasedDeduplication(true)
            .fifoTopic(true)
            .build());

    }
}

resources:
  userUpdates:
    type: aws:sns:Topic
    properties:
      contentBasedDeduplication: true
      fifoTopic: 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.

Example Usage

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

return await Deployment.RunAsync(() => 
{
    var userUpdates = new Aws.Sns.Topic("userUpdates");

});

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := sns.NewTopic(ctx, "userUpdates", nil)
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.sns.Topic;
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");

    }
}

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

const userUpdates = new aws.sns.Topic("userUpdates", {});

import pulumi
import pulumi_aws as aws

user_updates = aws.sns.Topic("userUpdates")

resources:
  userUpdates:
    type: aws:sns:Topic

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

return await Deployment.RunAsync(() => 
{
    var userUpdates = new Aws.Sns.Topic("userUpdates", new()
    {
        DeliveryPolicy = @"{
  ""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/v5/go/aws/sns"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := sns.NewTopic(ctx, "userUpdates", &sns.TopicArgs{
			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
	})
}

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()        
            .deliveryPolicy("""
{
  "http": {
    "defaultHealthyRetryPolicy": {
      "minDelayTarget": 20,
      "maxDelayTarget": 20,
      "numRetries": 3,
      "numMaxDelayRetries": 0,
      "numNoDelayRetries": 0,
      "numMinDelayRetries": 0,
      "backoffFunction": "linear"
    },
    "disableSubscriptionOverrides": false,
    "defaultThrottlePolicy": {
      "maxReceivesPerSecond": 1
    }
  }
}

            """)
            .build());

    }
}

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

const userUpdates = new aws.sns.Topic("userUpdates", {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("userUpdates", delivery_policy="""{
  "http": {
    "defaultHealthyRetryPolicy": {
      "minDelayTarget": 20,
      "maxDelayTarget": 20,
      "numRetries": 3,
      "numMaxDelayRetries": 0,
      "numNoDelayRetries": 0,
      "numMinDelayRetries": 0,
      "backoffFunction": "linear"
    },
    "disableSubscriptionOverrides": false,
    "defaultThrottlePolicy": {
      "maxReceivesPerSecond": 1
    }
  }
}

""")

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

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

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

});

package main

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

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

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()        
            .kmsMasterKeyId("alias/aws/sns")
            .build());

    }
}

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

const userUpdates = new aws.sns.Topic("userUpdates", {kmsMasterKeyId: "alias/aws/sns"});

import pulumi
import pulumi_aws as aws

user_updates = aws.sns.Topic("userUpdates", kms_master_key_id="alias/aws/sns")

resources:
  userUpdates:
    type: aws:sns:Topic
    properties:
      kmsMasterKeyId: alias/aws/sns

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

return await Deployment.RunAsync(() => 
{
    var userUpdates = new Aws.Sns.Topic("userUpdates", new()
    {
        ContentBasedDeduplication = true,
        FifoTopic = true,
    });

});

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := sns.NewTopic(ctx, "userUpdates", &sns.TopicArgs{
			ContentBasedDeduplication: pulumi.Bool(true),
			FifoTopic:                 pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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()        
            .contentBasedDeduplication(true)
            .fifoTopic(true)
            .build());

    }
}

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

const userUpdates = new aws.sns.Topic("userUpdates", {
    contentBasedDeduplication: true,
    fifoTopic: true,
});

import pulumi
import pulumi_aws as aws

user_updates = aws.sns.Topic("userUpdates",
    content_based_deduplication=True,
    fifo_topic=True)

resources:
  userUpdates:
    type: aws:sns:Topic
    properties:
      contentBasedDeduplication: true
      fifoTopic: true

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,
          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,
    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),
	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)
    .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,
    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,
    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
    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
ContentBasedDeduplication bool: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
DeliveryPolicy string: The SNS delivery policy. More on 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 (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
ContentBasedDeduplication bool: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
DeliveryPolicy string: The SNS delivery policy. More on 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 (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
contentBasedDeduplication Boolean: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
deliveryPolicy String: The SNS delivery policy. More on 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 (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
contentBasedDeduplication boolean: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
deliveryPolicy string: The SNS delivery policy. More on 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 (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
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 on 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 (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
contentBasedDeduplication Boolean: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
deliveryPolicy String: The SNS delivery policy. More on 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 (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)
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.

Arn string: The ARN of the SNS topic, as a more obvious property (clone of id)
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.

arn String: The ARN of the SNS topic, as a more obvious property (clone of id)
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.

arn ARN: The ARN of the SNS topic, as a more obvious property (clone of id)
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.

arn str: The ARN of the SNS topic, as a more obvious property (clone of id)
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.

arn: The ARN of the SNS topic, as a more obvious property (clone of id)
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.

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,
        arn: 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
Arn string: The ARN of the SNS topic, as a more obvious property (clone of id)
ContentBasedDeduplication bool: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
DeliveryPolicy string: The SNS delivery policy. More on 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 (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.
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
Arn string: The ARN of the SNS topic, as a more obvious property (clone of id)
ContentBasedDeduplication bool: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
DeliveryPolicy string: The SNS delivery policy. More on 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 (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.
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
arn String: The ARN of the SNS topic, as a more obvious property (clone of id)
contentBasedDeduplication Boolean: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
deliveryPolicy String: The SNS delivery policy. More on 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 (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.
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
arn ARN: The ARN of the SNS topic, as a more obvious property (clone of id)
contentBasedDeduplication boolean: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
deliveryPolicy string: The SNS delivery policy. More on 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 (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.
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
arn str: The ARN of the SNS topic, as a more obvious property (clone of id)
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 on 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 (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.
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
arn: The ARN of the SNS topic, as a more obvious property (clone of id)
contentBasedDeduplication Boolean: Enables content-based deduplication for FIFO topics. For more information, see the related documentation
deliveryPolicy String: The SNS delivery policy. More on 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 (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.
tracingConfig String: Tracing mode of an Amazon SNS topic. Valid values: "PassThrough", "Active".

Import

SNS Topics can be imported using the topic arn, e.g.,

 $ pulumi import aws:sns/topic:Topic user_updates arn:aws:sns:us-west-2:0123456789012: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.

Viewing docs for AWS v5.43.0 (Older version)
published on Tuesday, Mar 10, 2026 by Pulumi

Go to latest version

Schema (JSON)

pulumi/pulumi-aws

aws.sns.Topic

On this page

On this page

Example with Delivery Policy

Example with Server-side encryption (SSE)

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

Message Delivery Status Arguments

Example Usage

Create Topic Resource

Constructor syntax

Parameters

Constructor example

Topic Resource Properties

Inputs

Outputs

Look up Existing Topic Resource

Import

Package Details

On this page

On this page