Interface ICfnSubscriptionProps
Properties for defining a CfnSubscription
.
Namespace: Amazon.CDK.AWS.SNS
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public interface ICfnSubscriptionProps
Syntax (vb)
Public Interface ICfnSubscriptionProps
Remarks
See: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html
ExampleMetadata: fixture=_generated
Examples
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.SNS;
var deliveryPolicy;
var filterPolicy;
var redrivePolicy;
var replayPolicy;
var cfnSubscriptionProps = new CfnSubscriptionProps {
Protocol = "protocol",
TopicArn = "topicArn",
// the properties below are optional
DeliveryPolicy = deliveryPolicy,
Endpoint = "endpoint",
FilterPolicy = filterPolicy,
FilterPolicyScope = "filterPolicyScope",
RawMessageDelivery = false,
RedrivePolicy = redrivePolicy,
Region = "region",
ReplayPolicy = replayPolicy,
SubscriptionRoleArn = "subscriptionRoleArn"
};
Synopsis
Properties
DeliveryPolicy | The delivery policy JSON assigned to the subscription. |
Endpoint | The subscription's endpoint. |
FilterPolicy | The filter policy JSON assigned to the subscription. |
FilterPolicyScope | This attribute lets you choose the filtering scope by using one of the following string value types:. |
Protocol | The subscription's protocol. |
RawMessageDelivery | When set to |
RedrivePolicy | When specified, sends undeliverable messages to the specified Amazon SQS dead-letter queue. |
Region | For cross-region subscriptions, the region in which the topic resides. |
ReplayPolicy | |
SubscriptionRoleArn | This property applies only to Amazon Data Firehose delivery stream subscriptions. |
TopicArn | The ARN of the topic to subscribe to. |
Properties
DeliveryPolicy
The delivery policy JSON assigned to the subscription.
virtual object DeliveryPolicy { get; }
Property Value
System.Object
Remarks
Enables the subscriber to define the message delivery retry strategy in the case of an HTTP/S endpoint subscribed to the topic. For more information, see GetSubscriptionAttributes
in the Amazon SNS API Reference and Message delivery retries in the Amazon SNS Developer Guide .
Endpoint
The subscription's endpoint.
virtual string Endpoint { get; }
Property Value
System.String
Remarks
The endpoint value depends on the protocol that you specify. For more information, see the Endpoint
parameter of the Subscribe
action in the Amazon SNS API Reference .
FilterPolicy
The filter policy JSON assigned to the subscription.
virtual object FilterPolicy { get; }
Property Value
System.Object
Remarks
Enables the subscriber to filter out unwanted messages. For more information, see GetSubscriptionAttributes
in the Amazon SNS API Reference and Message filtering in the Amazon SNS Developer Guide .
FilterPolicyScope
This attribute lets you choose the filtering scope by using one of the following string value types:.
virtual string FilterPolicyScope { get; }
Property Value
System.String
Remarks
Protocol
The subscription's protocol.
string Protocol { get; }
Property Value
System.String
Remarks
For more information, see the Protocol
parameter of the Subscribe
action in the Amazon SNS API Reference .
RawMessageDelivery
When set to true
, enables raw message delivery.
virtual object RawMessageDelivery { get; }
Property Value
System.Object
Remarks
Raw messages don't contain any JSON formatting and can be sent to Amazon SQS and HTTP/S endpoints. For more information, see GetSubscriptionAttributes
in the Amazon SNS API Reference .
RedrivePolicy
When specified, sends undeliverable messages to the specified Amazon SQS dead-letter queue.
virtual object RedrivePolicy { get; }
Property Value
System.Object
Remarks
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.
For more information about the redrive policy and dead-letter queues, see Amazon SQS dead-letter queues in the Amazon SQS Developer Guide .
Region
For cross-region subscriptions, the region in which the topic resides.
virtual string Region { get; }
Property Value
System.String
Remarks
If no region is specified, AWS CloudFormation uses the region of the caller as the default.
If you perform an update operation that only updates the Region
property of a AWS::SNS::Subscription
resource, that operation will fail unless you are either:
ReplayPolicy
virtual object ReplayPolicy { get; }
Property Value
System.Object
Remarks
SubscriptionRoleArn
This property applies only to Amazon Data Firehose delivery stream subscriptions.
virtual string SubscriptionRoleArn { get; }
Property Value
System.String
Remarks
Specify the ARN of the IAM role that has the following:
Specifying a valid ARN for this attribute is required for Firehose delivery stream subscriptions. For more information, see Fanout to Amazon Data Firehose delivery streams in the Amazon SNS Developer Guide.
TopicArn
The ARN of the topic to subscribe to.
string TopicArn { get; }
Property Value
System.String