AWS Classic v6.13.0, Dec 2 23

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.13.0 published on Saturday, Dec 2, 2023 by Pulumi

pulumi/pulumi-aws

aws.sns.Topic

Explore with Pulumi AI

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.13.0 published on Saturday, Dec 2, 2023 by Pulumi

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/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, "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/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, "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/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, "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/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, "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 pulumi
import pulumi_aws as aws

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

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

const userUpdates = new 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/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, "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 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
    }
  }
}

""")

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
    }
  }
}

`});

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/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, "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 pulumi
import pulumi_aws as aws

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

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

const userUpdates = new aws.sns.Topic("userUpdates", {kmsMasterKeyId: "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/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, "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 pulumi
import pulumi_aws as aws

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

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

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

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

Create Topic Resource

new Topic(name: string, args?: TopicArgs, opts?: CustomResourceOptions);

@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)
@overload
def Topic(resource_name: str,
          args: Optional[TopicArgs] = None,
          opts: Optional[ResourceOptions] = 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.

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.

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

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 (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 (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 (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 (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 (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 (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)

Resource lookup is not supported in YAML

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 (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 (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

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

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 (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

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

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 (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

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

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 (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

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

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 (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

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

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:0123456789012:my-topic

Package Details

Repository: AWS Classic pulumi/pulumi-aws
License: Apache-2.0
Notes: This Pulumi package is based on the aws Terraform Provider.

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.13.0 published on Saturday, Dec 2, 2023 by Pulumi

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

Topic Resource Properties

Inputs

Outputs

Look up Existing Topic Resource

Import

Package Details

On this page

On this page