---
title: SNS Topic
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > SNS Topic
---

# SNS Topic

An SNS Topic in AWS is a communication channel that allows publishers to send messages to multiple subscribers at once. It is part of Amazon Simple Notification Service (SNS) and supports various delivery protocols such as email, SMS, HTTP endpoints, and AWS Lambda. Topics simplify fan-out messaging patterns by decoupling message producers from consumers.

```
aws.sns_topic
```

## Fields

| Title                                    | ID   | Type       | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                 | Description |
| ---------------------------------------- | ---- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                                     | core | string     |
| account_id                               | core | string     |
| application_failure_feedback_role_arn    | core | string     | Indicates failed message delivery status for an Amazon SNS topic that is subscribed to an Amazon Web Services application endpoint.                                                                                                                                                                                                                                                                                       |
| application_success_feedback_role_arn    | core | string     | Indicates successful message delivery status for an Amazon SNS topic that is subscribed to an Amazon Web Services application endpoint.                                                                                                                                                                                                                                                                                   |
| application_success_feedback_sample_rate | core | string     | Indicates percentage of successful messages to sample for an Amazon SNS topic that is subscribed to an Amazon Web Services application endpoint.                                                                                                                                                                                                                                                                          |
| archive_policy                           | core | string     | Adds or updates an inline policy document to archive messages stored in the specified Amazon SNS topic.                                                                                                                                                                                                                                                                                                                   |
| aws_display_name                         | core | string     | The human-readable name used in the From field for notifications to email and email-json endpoints.                                                                                                                                                                                                                                                                                                                       |
| beginning_archive_time                   | core | timestamp  | The earliest starting point at which a message in the topic's archive can be replayed from. This point in time is based on the configured message retention period set by the topic's message archiving policy.                                                                                                                                                                                                           |
| content_based_deduplication              | core | string     | Enables content-based deduplication for FIFO topics.                                                                                                                                                                                                                                                                                                                                                                      |
| delivery_policy                          | core | string     | The JSON serialization of the topic's delivery policy.                                                                                                                                                                                                                                                                                                                                                                    |
| effective_delivery_policy                | core | string     | The JSON serialization of the effective delivery policy, taking system defaults into account.                                                                                                                                                                                                                                                                                                                             |
| fifo_topic                               | core | string     | When this is set to true, a FIFO topic is created.                                                                                                                                                                                                                                                                                                                                                                        |
| firehose_failure_feedback_role_arn       | core | string     | Indicates failed message delivery status for an Amazon SNS topic that is subscribed to an Amazon Kinesis Data Firehose endpoint.                                                                                                                                                                                                                                                                                          |
| firehose_success_feedback_role_arn       | core | string     | Indicates successful message delivery status for an Amazon SNS topic that is subscribed to an Amazon Kinesis Data Firehose endpoint.                                                                                                                                                                                                                                                                                      |
| firehose_success_feedback_sample_rate    | core | string     | Indicates percentage of successful messages to sample for an Amazon SNS topic that is subscribed to an Amazon Kinesis Data Firehose endpoint.                                                                                                                                                                                                                                                                             |
| http_failure_feedback_role_arn           | core | string     | Indicates failed message delivery status for an Amazon SNS topic that is subscribed to an HTTP endpoint.                                                                                                                                                                                                                                                                                                                  |
| http_success_feedback_role_arn           | core | string     | Indicates successful message delivery status for an Amazon SNS topic that is subscribed to an HTTP endpoint.                                                                                                                                                                                                                                                                                                              |
| http_success_feedback_sample_rate        | core | string     | Indicates percentage of successful messages to sample for an Amazon SNS topic that is subscribed to an HTTP endpoint.                                                                                                                                                                                                                                                                                                     |
| kms_master_key_id                        | core | string     | The ID of an Amazon Web Services managed customer master key (CMK) for Amazon SNS or a custom CMK.                                                                                                                                                                                                                                                                                                                        |
| lambda_failure_feedback_role_arn         | core | string     | Indicates failed message delivery status for an Amazon SNS topic that is subscribed to an Lambda endpoint.                                                                                                                                                                                                                                                                                                                |
| lambda_success_feedback_role_arn         | core | string     | Indicates successful message delivery status for an Amazon SNS topic that is subscribed to an Lambda endpoint.                                                                                                                                                                                                                                                                                                            |
| lambda_success_feedback_sample_rate      | core | string     | Indicates percentage of successful messages to sample for an Amazon SNS topic that is subscribed to an Lambda endpoint.                                                                                                                                                                                                                                                                                                   |
| owner                                    | core | string     | The Amazon Web Services account ID of the topic's owner.                                                                                                                                                                                                                                                                                                                                                                  |
| policies                                 | core | json       |
| policy                                   | core | string     | The JSON serialization of the topic's access control policy.                                                                                                                                                                                                                                                                                                                                                              |
| signature_version                        | core | string     | 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. By default, <code>SignatureVersion</code> is set to <code>1</code>.                                                                                                                                               |
| sqs_failure_feedback_role_arn            | core | string     | Indicates failed message delivery status for an Amazon SNS topic that is subscribed to an Amazon SQS endpoint.                                                                                                                                                                                                                                                                                                            |
| sqs_success_feedback_role_arn            | core | string     | Indicates successful message delivery status for an Amazon SNS topic that is subscribed to an Amazon SQS endpoint.                                                                                                                                                                                                                                                                                                        |
| sqs_success_feedback_sample_rate         | core | string     | Indicates percentage of successful messages to sample for an Amazon SNS topic that is subscribed to an Amazon SQS endpoint.                                                                                                                                                                                                                                                                                               |
| subscriptions_confirmed                  | core | int64      | The number of confirmed subscriptions for the topic.                                                                                                                                                                                                                                                                                                                                                                      |
| subscriptions_deleted                    | core | int64      | The number of deleted subscriptions for the topic.                                                                                                                                                                                                                                                                                                                                                                        |
| subscriptions_pending                    | core | int64      | The number of subscriptions pending confirmation for the topic.                                                                                                                                                                                                                                                                                                                                                           |
| tags                                     | core | hstore_csv |
| topic_arn                                | core | string     | The topic's ARN.                                                                                                                                                                                                                                                                                                                                                                                                          |
| tracing_config                           | core | string     | Tracing mode of an Amazon SNS topic. By default <code>TracingConfig</code> is set to <code>PassThrough</code>, and the topic passes through the tracing header it receives from an Amazon SNS publisher to its subscriptions. If set to <code>Active</code>, Amazon SNS will vend X-Ray segment data to topic owner account if the sampled flag in the tracing header is true. This is only supported on standard topics. |
