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

# SNS Topic Subscription

This table represents the SNS Topic Subscription resource from Amazon Web Services.

```
aws.sns_topic_subscription
```

## Fields

| Title                          | ID   | Type       | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Description |
| ------------------------------ | ---- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                           | core | string     |
| account_id                     | core | string     |
| confirmation_was_authenticated | core | bool       | <code>true</code> if the subscription confirmation request was authenticated.                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| delivery_policy                | core | string     | The JSON serialization of the subscription's delivery policy.                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| effective_delivery_policy      | core | string     | The JSON serialization of the effective delivery policy that takes into account the topic delivery policy and account system defaults.                                                                                                                                                                                                                                                                                                                                                                              |
| endpoint                       | core | string     | The subscription's endpoint (format depends on the protocol).                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| filter_policy                  | core | string     | The filter policy JSON that is assigned to the subscription. For more information, see <a href="https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html">Amazon SNS Message Filtering</a> in the <i>Amazon SNS Developer Guide</i>.                                                                                                                                                                                                                                                                    |
| filter_policy_scope            | core | string     | This attribute lets you choose the filtering scope by using one of the following string value types: <ul> <li> <code>MessageAttributes</code> (default) – The filter is applied on the message attributes. </li> <li> <code>MessageBody</code> – The filter is applied on the message body.                                                                                                                                                                                                                         |
| owner                          | core | string     | The subscription's owner.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| pending_confirmation           | core | bool       | <code>true</code> if the subscription hasn't been confirmed. To confirm a pending subscription, call the <code>ConfirmSubscription</code> action with a confirmation token.                                                                                                                                                                                                                                                                                                                                         |
| protocol                       | core | string     | The subscription's protocol.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| raw_message_delivery           | core | bool       | <code>true</code> if raw message delivery is enabled for the subscription. Raw messages are free of JSON formatting and can be sent to HTTP/S and Amazon SQS endpoints.                                                                                                                                                                                                                                                                                                                                             |
| redrive_policy                 | core | string     | When specified, sends undeliverable messages to the specified Amazon SQS dead-letter queue. Messages that can't be delivered due to client errors (for example, when the subscribed endpoint is unreachable) or server errors (for example, when the service that powers the subscribed endpoint becomes unavailable) are held in the dead-letter queue for further analysis or reprocessing.                                                                                                                       |
| subscription_arn               | core | string     | The subscription's ARN.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| subscription_role_arn          | core | string     | The ARN of the IAM role that has the following: <ul> <li> Permission to write to the Kinesis Data Firehose delivery stream </li> <li> Amazon SNS listed as a trusted entity </li> </ul> Specifying a valid ARN for this attribute is required for Kinesis Data Firehose delivery stream subscriptions. For more information, see <a href="https://docs.aws.amazon.com/sns/latest/dg/sns-firehose-as-subscriber.html">Fanout to Kinesis Data Firehose delivery streams</a> in the <i>Amazon SNS Developer Guide</i>. |
| tags                           | core | hstore_csv |
| topic_arn                      | core | string     | The ARN of the subscription's topic.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |