aws-cdk-lib.aws_sns_subscriptions.UrlSubscriptionProps

interface UrlSubscriptionProps

LanguageType name
.NETAmazon.CDK.AWS.SNS.Subscriptions.UrlSubscriptionProps
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awssnssubscriptions#UrlSubscriptionProps
Javasoftware.amazon.awscdk.services.sns.subscriptions.UrlSubscriptionProps
Pythonaws_cdk.aws_sns_subscriptions.UrlSubscriptionProps
TypeScript (source)aws-cdk-lib » aws_sns_subscriptions » UrlSubscriptionProps

Options for URL subscriptions.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_sns as sns } from 'aws-cdk-lib';
import { aws_sns_subscriptions as sns_subscriptions } from 'aws-cdk-lib';
import { aws_sqs as sqs } from 'aws-cdk-lib';

declare const filterOrPolicy: sns.FilterOrPolicy;
declare const queue: sqs.Queue;
declare const subscriptionFilter: sns.SubscriptionFilter;
const urlSubscriptionProps: sns_subscriptions.UrlSubscriptionProps = {
  deadLetterQueue: queue,
  filterPolicy: {
    filterPolicyKey: subscriptionFilter,
  },
  filterPolicyWithMessageBody: {
    filterPolicyWithMessageBodyKey: filterOrPolicy,
  },
  protocol: sns.SubscriptionProtocol.HTTP,
  rawMessageDelivery: false,
};

Properties

NameTypeDescription
deadLetterQueue?IQueueQueue to be used as dead letter queue.
filterPolicy?{ [string]: SubscriptionFilter }The filter policy.
filterPolicyWithMessageBody?{ [string]: FilterOrPolicy }The filter policy that is applied on the message body.
protocol?SubscriptionProtocolThe subscription's protocol.
rawMessageDelivery?booleanThe message to the queue is the same as it was sent to the topic.

deadLetterQueue?

Type: IQueue (optional, default: No dead letter queue enabled.)

Queue to be used as dead letter queue.

If not passed no dead letter queue is enabled.


filterPolicy?

Type: { [string]: SubscriptionFilter } (optional, default: all messages are delivered)

The filter policy.


filterPolicyWithMessageBody?

Type: { [string]: FilterOrPolicy } (optional, default: all messages are delivered)

The filter policy that is applied on the message body.

To apply a filter policy to the message attributes, use filterPolicy. A maximum of one of filterPolicyWithMessageBody and filterPolicy may be used.


protocol?

Type: SubscriptionProtocol (optional, default: Protocol is derived from url)

The subscription's protocol.


rawMessageDelivery?

Type: boolean (optional, default: false)

The message to the queue is the same as it was sent to the topic.

If false, the message will be wrapped in an SNS envelope.