aws-cdk-lib 2.126.0__py3-none-any.whl → 2.127.0__py3-none-any.whl

aws_cdk/aws_sns/__init__.py

@@ -255,6 +255,25 @@ topic.add_logging_config(
 ```
 
 Note that valid values for `successFeedbackSampleRate` are integer between 0-100.
+
+## Archive Policy
+
+Message archiving provides the ability to archive a single copy of all messages published to your topic.
+You can store published messages within your topic by enabling the message archive policy on the topic, which enables message archiving for all subscriptions linked to that topic.
+Messages can be archived for a minimum of one day to a maximum of 365 days.
+
+Example with a archive policy for SQS:
+
+```python
+# role: iam.Role
+
+topic = sns.Topic(self, "MyTopic",
+    fifo=True,
+    message_retention_period_in_days=7
+)
+```
+
+**Note**: The `messageRetentionPeriodInDays` property is only available for FIFO topics.
 '''
 import abc
 import builtins
@@ -4945,6 +4964,7 @@ class TopicPolicyProps:
         "fifo": "fifo",
         "logging_configs": "loggingConfigs",
         "master_key": "masterKey",
+        "message_retention_period_in_days": "messageRetentionPeriodInDays",
         "topic_name": "topicName",
     },
 )
@@ -4957,6 +4977,7 @@ class TopicProps:
         fifo: typing.Optional[builtins.bool] = None,
         logging_configs: typing.Optional[typing.Sequence[typing.Union[LoggingConfig, typing.Dict[builtins.str, typing.Any]]]] = None,
         master_key: typing.Optional[_IKey_5f11635f] = None,
+        message_retention_period_in_days: typing.Optional[jsii.Number] = None,
         topic_name: typing.Optional[builtins.str] = None,
     ) -> None:
         '''Properties for a new SNS topic.
@@ -4966,16 +4987,18 @@ class TopicProps:
         :param fifo: Set to true to create a FIFO topic. Default: None
         :param logging_configs: The list of delivery status logging configurations for the topic. For more information, see https://docs.aws.amazon.com/sns/latest/dg/sns-topic-attributes.html. Default: None
         :param master_key: A KMS Key, either managed by this CDK app, or imported. Default: None
+        :param message_retention_period_in_days: The number of days Amazon SNS retains messages. It can only be set for FIFO topics. Default: - do not archive messages
         :param topic_name: A name for the topic. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the topic name. For more information, see Name Type. Default: Generated name
 
         :exampleMetadata: infused
 
         Example::
 
-            topic = sns.Topic(self, "Topic",
-                content_based_deduplication=True,
-                display_name="Customer subscription topic",
-                fifo=True
+            # role: iam.Role
+            
+            topic = sns.Topic(self, "MyTopic",
+                fifo=True,
+                message_retention_period_in_days=7
             )
         '''
         if __debug__:
@@ -4985,6 +5008,7 @@ class TopicProps:
             check_type(argname="argument fifo", value=fifo, expected_type=type_hints["fifo"])
             check_type(argname="argument logging_configs", value=logging_configs, expected_type=type_hints["logging_configs"])
             check_type(argname="argument master_key", value=master_key, expected_type=type_hints["master_key"])
+            check_type(argname="argument message_retention_period_in_days", value=message_retention_period_in_days, expected_type=type_hints["message_retention_period_in_days"])
             check_type(argname="argument topic_name", value=topic_name, expected_type=type_hints["topic_name"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if content_based_deduplication is not None:
@@ -4997,6 +5021,8 @@ class TopicProps:
             self._values["logging_configs"] = logging_configs
         if master_key is not None:
             self._values["master_key"] = master_key
+        if message_retention_period_in_days is not None:
+            self._values["message_retention_period_in_days"] = message_retention_period_in_days
         if topic_name is not None:
             self._values["topic_name"] = topic_name
 
@@ -5047,6 +5073,19 @@ class TopicProps:
         result = self._values.get("master_key")
         return typing.cast(typing.Optional[_IKey_5f11635f], result)
 
+    @builtins.property
+    def message_retention_period_in_days(self) -> typing.Optional[jsii.Number]:
+        '''The number of days Amazon SNS retains messages.
+
+        It can only be set for FIFO topics.
+
+        :default: - do not archive messages
+
+        :see: https://docs.aws.amazon.com/sns/latest/dg/fifo-message-archiving-replay.html
+        '''
+        result = self._values.get("message_retention_period_in_days")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def topic_name(self) -> typing.Optional[builtins.str]:
         '''A name for the topic.
@@ -5381,18 +5420,17 @@ class Topic(TopicBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sns.T
 
     Example::
 
-        import aws_cdk.aws_sns as sns
+        from aws_cdk.aws_kinesisfirehose_alpha import DeliveryStream
+        # stream: DeliveryStream
         
         
-        topic = sns.Topic(self, "MyTopic")
+        topic = sns.Topic(self, "Topic")
         
-        topic_rule = iot.TopicRule(self, "TopicRule",
-            sql=iot.IotSql.from_string_as_ver20160323("SELECT topic(2) as device_id, year, month, day FROM 'device/+/data'"),
-            actions=[
-                actions.SnsTopicAction(topic,
-                    message_format=actions.SnsActionMessageFormat.JSON
-                )
-            ]
+        sns.Subscription(self, "Subscription",
+            topic=topic,
+            endpoint=stream.delivery_stream_arn,
+            protocol=sns.SubscriptionProtocol.FIREHOSE,
+            subscription_role_arn="SAMPLE_ARN"
         )
     '''
 
@@ -5406,6 +5444,7 @@ class Topic(TopicBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sns.T
         fifo: typing.Optional[builtins.bool] = None,
         logging_configs: typing.Optional[typing.Sequence[typing.Union[LoggingConfig, typing.Dict[builtins.str, typing.Any]]]] = None,
         master_key: typing.Optional[_IKey_5f11635f] = None,
+        message_retention_period_in_days: typing.Optional[jsii.Number] = None,
         topic_name: typing.Optional[builtins.str] = None,
     ) -> None:
         '''
@@ -5416,6 +5455,7 @@ class Topic(TopicBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sns.T
         :param fifo: Set to true to create a FIFO topic. Default: None
         :param logging_configs: The list of delivery status logging configurations for the topic. For more information, see https://docs.aws.amazon.com/sns/latest/dg/sns-topic-attributes.html. Default: None
         :param master_key: A KMS Key, either managed by this CDK app, or imported. Default: None
+        :param message_retention_period_in_days: The number of days Amazon SNS retains messages. It can only be set for FIFO topics. Default: - do not archive messages
         :param topic_name: A name for the topic. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the topic name. For more information, see Name Type. Default: Generated name
         '''
         if __debug__:
@@ -5428,6 +5468,7 @@ class Topic(TopicBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sns.T
             fifo=fifo,
             logging_configs=logging_configs,
             master_key=master_key,
+            message_retention_period_in_days=message_retention_period_in_days,
             topic_name=topic_name,
         )
 
@@ -6115,6 +6156,7 @@ def _typecheckingstub__093960c1ab5457cc6797eb4a06c9e8fc74e41d4eaa9d0a17f00fa896d
     fifo: typing.Optional[builtins.bool] = None,
     logging_configs: typing.Optional[typing.Sequence[typing.Union[LoggingConfig, typing.Dict[builtins.str, typing.Any]]]] = None,
     master_key: typing.Optional[_IKey_5f11635f] = None,
+    message_retention_period_in_days: typing.Optional[jsii.Number] = None,
     topic_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
@@ -6152,6 +6194,7 @@ def _typecheckingstub__5bf7b7a1001dc600e81a7f1c5015e367dc471dcd727360f62a7eaf6eb
     fifo: typing.Optional[builtins.bool] = None,
     logging_configs: typing.Optional[typing.Sequence[typing.Union[LoggingConfig, typing.Dict[builtins.str, typing.Any]]]] = None,
     master_key: typing.Optional[_IKey_5f11635f] = None,
+    message_retention_period_in_days: typing.Optional[jsii.Number] = None,
     topic_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""

aws_cdk/aws_sqs/__init__.py

@@ -3811,18 +3811,21 @@ class Queue(QueueBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sqs.Q
 
     Example::
 
-        # An sqs queue for unsuccessful invocations of a lambda function
-        import aws_cdk.aws_sqs as sqs
-        
+        payload = "test"
+        message_group_id = "id"
+        queue = sqs.Queue(self, "MyQueue",
+            fifo=True,
+            content_based_deduplication=True
+        )
         
-        dead_letter_queue = sqs.Queue(self, "DeadLetterQueue")
+        target = targets.SqsSendMessage(queue,
+            input=ScheduleTargetInput.from_text(payload),
+            message_group_id=message_group_id
+        )
         
-        my_fn = lambda_.Function(self, "Fn",
-            runtime=lambda_.Runtime.NODEJS_LATEST,
-            handler="index.handler",
-            code=lambda_.Code.from_inline("// your code"),
-            # sqs queue for unsuccessful invocations
-            on_failure=destinations.SqsDestination(dead_letter_queue)
+        Schedule(self, "Schedule",
+            schedule=ScheduleExpression.rate(Duration.minutes(1)),
+            target=target
         )
     '''