Metadata-Version: 2.1
Name: aws-cdk.aws-sns
Version: 0.34.0
Summary: CDK Constructs for AWS SNS
Home-page: https://github.com/awslabs/aws-cdk
Author: Amazon Web Services
License: UNKNOWN
Project-URL: Source, https://github.com/awslabs/aws-cdk.git
Description: ## Amazon Simple Notification Service Construct Library
        <!--BEGIN STABILITY BANNER-->
        
        ---
        
        ![Stability: Experimental](https://img.shields.io/badge/stability-Experimental-important.svg?style=for-the-badge)
        
        > This API is still under active development and subject to non-backward
        > compatible changes or removal in any future version. Use of the API is not recommended in production
        > environments. Experimental APIs are not subject to the Semantic Versioning model.
        
        ---
        <!--END STABILITY BANNER-->
        
        Add an SNS Topic to your stack:
        
        ```ts
        import sns = require('@aws-cdk/aws-sns');
        
        const topic = new sns.Topic(this, 'Topic', {
            displayName: 'Customer subscription topic'
        });
        ```
        
        ### Subscriptions
        
        Various subscriptions can be added to the topic by calling the `.subscribeXxx()` methods on the
        topic.
        
        Add an HTTPS Subscription to your topic:
        
        ```ts
        const myTopic = new sns.Topic(this, 'MyTopic');
        
        myTopic.subscribeUrl('MyHttpsSubscription', 'https://foobar.com/');
        ```
        
        Subscribe a queue to the topic:
        
        ```ts
            const topic = new sns.Topic(this, 'MyTopic');
            const queue = new sqs.Queue(this, 'MyQueue');
        
            topic.subscribeQueue(queue);
        ```
        
        Note that subscriptions of queues in different accounts need to be manually confirmed by
        reading the initial message from the queue and visiting the link found in it.
        
        ### CloudWatch Event Rule Target
        
        SNS topics can be used as targets for CloudWatch event rules.
        
        Use the `@aws-cdk/aws-events-targets.SnsTopicTarget`:
        
        ```ts
        import targets = require('@aws-cdk/aws-events-targets');
        
        codeCommitRepository.onCommit(new targets.SnsTopicTarget(myTopic));
        ```
        
        This will result in adding a target to the event rule and will also modify the
        topic resource policy to allow CloudWatch events to publish to the topic.
        
        
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown
