aws-cdk-lib 2.173.3__py3-none-any.whl → 2.174.0__py3-none-any.whl

aws_cdk/aws_ses/__init__.py

@@ -5677,6 +5677,14 @@ class CfnMailManagerRuleSet(
                         # the properties below are optional
                         action_failure_policy="actionFailurePolicy"
                     ),
+                    deliver_to_qBusiness=ses.CfnMailManagerRuleSet.DeliverToQBusinessActionProperty(
+                        application_id="applicationId",
+                        index_id="indexId",
+                        role_arn="roleArn",
+        
+                        # the properties below are optional
+                        action_failure_policy="actionFailurePolicy"
+                    ),
                     drop=drop,
                     relay=ses.CfnMailManagerRuleSet.RelayActionProperty(
                         relay="relay",
@@ -6259,6 +6267,118 @@ class CfnMailManagerRuleSet(
                 k + "=" + repr(v) for k, v in self._values.items()
             )
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_ses.CfnMailManagerRuleSet.DeliverToQBusinessActionProperty",
+        jsii_struct_bases=[],
+        name_mapping={
+            "application_id": "applicationId",
+            "index_id": "indexId",
+            "role_arn": "roleArn",
+            "action_failure_policy": "actionFailurePolicy",
+        },
+    )
+    class DeliverToQBusinessActionProperty:
+        def __init__(
+            self,
+            *,
+            application_id: builtins.str,
+            index_id: builtins.str,
+            role_arn: builtins.str,
+            action_failure_policy: typing.Optional[builtins.str] = None,
+        ) -> None:
+            '''The action to deliver incoming emails to an Amazon Q Business application for indexing.
+
+            :param application_id: The unique identifier of the Amazon Q Business application instance where the email content will be delivered.
+            :param index_id: The identifier of the knowledge base index within the Amazon Q Business application where the email content will be stored and indexed.
+            :param role_arn: The Amazon Resource Name (ARN) of the IAM Role to use while delivering to Amazon Q Business. This role must have access to the qbusiness:BatchPutDocument API for the given application and index.
+            :param action_failure_policy: A policy that states what to do in the case of failure. The action will fail if there are configuration errors. For example, the specified application has been deleted or the role lacks necessary permissions to call the qbusiness:BatchPutDocument API.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ses-mailmanagerruleset-delivertoqbusinessaction.html
+            :exampleMetadata: fixture=_generated
+
+            Example::
+
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_ses as ses
+                
+                deliver_to_qBusiness_action_property = ses.CfnMailManagerRuleSet.DeliverToQBusinessActionProperty(
+                    application_id="applicationId",
+                    index_id="indexId",
+                    role_arn="roleArn",
+                
+                    # the properties below are optional
+                    action_failure_policy="actionFailurePolicy"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__9bd73a70e10ea34690bce68c862abcfb0eb828f9546668bcdea3ffbc529c95c9)
+                check_type(argname="argument application_id", value=application_id, expected_type=type_hints["application_id"])
+                check_type(argname="argument index_id", value=index_id, expected_type=type_hints["index_id"])
+                check_type(argname="argument role_arn", value=role_arn, expected_type=type_hints["role_arn"])
+                check_type(argname="argument action_failure_policy", value=action_failure_policy, expected_type=type_hints["action_failure_policy"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {
+                "application_id": application_id,
+                "index_id": index_id,
+                "role_arn": role_arn,
+            }
+            if action_failure_policy is not None:
+                self._values["action_failure_policy"] = action_failure_policy
+
+        @builtins.property
+        def application_id(self) -> builtins.str:
+            '''The unique identifier of the Amazon Q Business application instance where the email content will be delivered.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ses-mailmanagerruleset-delivertoqbusinessaction.html#cfn-ses-mailmanagerruleset-delivertoqbusinessaction-applicationid
+            '''
+            result = self._values.get("application_id")
+            assert result is not None, "Required property 'application_id' is missing"
+            return typing.cast(builtins.str, result)
+
+        @builtins.property
+        def index_id(self) -> builtins.str:
+            '''The identifier of the knowledge base index within the Amazon Q Business application where the email content will be stored and indexed.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ses-mailmanagerruleset-delivertoqbusinessaction.html#cfn-ses-mailmanagerruleset-delivertoqbusinessaction-indexid
+            '''
+            result = self._values.get("index_id")
+            assert result is not None, "Required property 'index_id' is missing"
+            return typing.cast(builtins.str, result)
+
+        @builtins.property
+        def role_arn(self) -> builtins.str:
+            '''The Amazon Resource Name (ARN) of the IAM Role to use while delivering to Amazon Q Business.
+
+            This role must have access to the qbusiness:BatchPutDocument API for the given application and index.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ses-mailmanagerruleset-delivertoqbusinessaction.html#cfn-ses-mailmanagerruleset-delivertoqbusinessaction-rolearn
+            '''
+            result = self._values.get("role_arn")
+            assert result is not None, "Required property 'role_arn' is missing"
+            return typing.cast(builtins.str, result)
+
+        @builtins.property
+        def action_failure_policy(self) -> typing.Optional[builtins.str]:
+            '''A policy that states what to do in the case of failure.
+
+            The action will fail if there are configuration errors. For example, the specified application has been deleted or the role lacks necessary permissions to call the qbusiness:BatchPutDocument API.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ses-mailmanagerruleset-delivertoqbusinessaction.html#cfn-ses-mailmanagerruleset-delivertoqbusinessaction-actionfailurepolicy
+            '''
+            result = self._values.get("action_failure_policy")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "DeliverToQBusinessActionProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_ses.CfnMailManagerRuleSet.RelayActionProperty",
         jsii_struct_bases=[],
@@ -6417,6 +6537,7 @@ class CfnMailManagerRuleSet(
             "add_header": "addHeader",
             "archive": "archive",
             "deliver_to_mailbox": "deliverToMailbox",
+            "deliver_to_q_business": "deliverToQBusiness",
             "drop": "drop",
             "relay": "relay",
             "replace_recipient": "replaceRecipient",
@@ -6431,6 +6552,7 @@ class CfnMailManagerRuleSet(
             add_header: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnMailManagerRuleSet.AddHeaderActionProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             archive: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnMailManagerRuleSet.ArchiveActionProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             deliver_to_mailbox: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnMailManagerRuleSet.DeliverToMailboxActionProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+            deliver_to_q_business: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnMailManagerRuleSet.DeliverToQBusinessActionProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             drop: typing.Any = None,
             relay: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnMailManagerRuleSet.RelayActionProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             replace_recipient: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnMailManagerRuleSet.ReplaceRecipientActionProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -6446,6 +6568,7 @@ class CfnMailManagerRuleSet(
             :param add_header: This action adds a header. This can be used to add arbitrary email headers.
             :param archive: This action archives the email. This can be used to deliver an email to an archive.
             :param deliver_to_mailbox: This action delivers an email to a WorkMail mailbox.
+            :param deliver_to_q_business: This action delivers an email to an Amazon Q Business application for ingestion into its knowledge base.
             :param drop: This action terminates the evaluation of rules in the rule set.
             :param relay: This action relays the email to another SMTP server.
             :param replace_recipient: The action replaces certain or all recipients with a different set of recipients.
@@ -6481,6 +6604,14 @@ class CfnMailManagerRuleSet(
                         # the properties below are optional
                         action_failure_policy="actionFailurePolicy"
                     ),
+                    deliver_to_qBusiness=ses.CfnMailManagerRuleSet.DeliverToQBusinessActionProperty(
+                        application_id="applicationId",
+                        index_id="indexId",
+                        role_arn="roleArn",
+                
+                        # the properties below are optional
+                        action_failure_policy="actionFailurePolicy"
+                    ),
                     drop=drop,
                     relay=ses.CfnMailManagerRuleSet.RelayActionProperty(
                         relay="relay",
@@ -6514,6 +6645,7 @@ class CfnMailManagerRuleSet(
                 check_type(argname="argument add_header", value=add_header, expected_type=type_hints["add_header"])
                 check_type(argname="argument archive", value=archive, expected_type=type_hints["archive"])
                 check_type(argname="argument deliver_to_mailbox", value=deliver_to_mailbox, expected_type=type_hints["deliver_to_mailbox"])
+                check_type(argname="argument deliver_to_q_business", value=deliver_to_q_business, expected_type=type_hints["deliver_to_q_business"])
                 check_type(argname="argument drop", value=drop, expected_type=type_hints["drop"])
                 check_type(argname="argument relay", value=relay, expected_type=type_hints["relay"])
                 check_type(argname="argument replace_recipient", value=replace_recipient, expected_type=type_hints["replace_recipient"])
@@ -6526,6 +6658,8 @@ class CfnMailManagerRuleSet(
                 self._values["archive"] = archive
             if deliver_to_mailbox is not None:
                 self._values["deliver_to_mailbox"] = deliver_to_mailbox
+            if deliver_to_q_business is not None:
+                self._values["deliver_to_q_business"] = deliver_to_q_business
             if drop is not None:
                 self._values["drop"] = drop
             if relay is not None:
@@ -6574,6 +6708,17 @@ class CfnMailManagerRuleSet(
             result = self._values.get("deliver_to_mailbox")
             return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnMailManagerRuleSet.DeliverToMailboxActionProperty"]], result)
 
+        @builtins.property
+        def deliver_to_q_business(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnMailManagerRuleSet.DeliverToQBusinessActionProperty"]]:
+            '''This action delivers an email to an Amazon Q Business application for ingestion into its knowledge base.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ses-mailmanagerruleset-ruleaction.html#cfn-ses-mailmanagerruleset-ruleaction-delivertoqbusiness
+            '''
+            result = self._values.get("deliver_to_q_business")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnMailManagerRuleSet.DeliverToQBusinessActionProperty"]], result)
+
         @builtins.property
         def drop(self) -> typing.Any:
             '''This action terminates the evaluation of rules in the rule set.
@@ -7380,6 +7525,14 @@ class CfnMailManagerRuleSet(
                             # the properties below are optional
                             action_failure_policy="actionFailurePolicy"
                         ),
+                        deliver_to_qBusiness=ses.CfnMailManagerRuleSet.DeliverToQBusinessActionProperty(
+                            application_id="applicationId",
+                            index_id="indexId",
+                            role_arn="roleArn",
+                
+                            # the properties below are optional
+                            action_failure_policy="actionFailurePolicy"
+                        ),
                         drop=drop,
                         relay=ses.CfnMailManagerRuleSet.RelayActionProperty(
                             relay="relay",
@@ -8188,6 +8341,14 @@ class CfnMailManagerRuleSetProps:
                             # the properties below are optional
                             action_failure_policy="actionFailurePolicy"
                         ),
+                        deliver_to_qBusiness=ses.CfnMailManagerRuleSet.DeliverToQBusinessActionProperty(
+                            application_id="applicationId",
+                            index_id="indexId",
+                            role_arn="roleArn",
+            
+                            # the properties below are optional
+                            action_failure_policy="actionFailurePolicy"
+                        ),
                         drop=drop,
                         relay=ses.CfnMailManagerRuleSet.RelayActionProperty(
                             relay="relay",
@@ -10656,9 +10817,16 @@ class CfnReceiptRule(
             iam_role_arn: builtins.str,
             instance_arn: builtins.str,
         ) -> None:
-            '''
-            :param iam_role_arn: 
-            :param instance_arn: 
+            '''When included in a receipt rule, this action parses the received message and starts an email contact in Amazon Connect on your behalf.
+
+            .. epigraph::
+
+               When you receive emails, the maximum email size (including headers) is 40 MB. Additionally, emails may only have up to 10 attachments. Emails larger than 40 MB or with more than 10 attachments will be bounced.
+
+            We recommend that you configure this action via Amazon Connect.
+
+            :param iam_role_arn: The Amazon Resource Name (ARN) of the IAM role to be used by Amazon Simple Email Service while starting email contacts to the Amazon Connect instance. This role should have permission to invoke ``connect:StartEmailContact`` for the given Amazon Connect instance.
+            :param instance_arn: The Amazon Resource Name (ARN) for the Amazon Connect instance that Amazon SES integrates with for starting email contacts. For more information about Amazon Connect instances, see the `Amazon Connect Administrator Guide <https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-instances.html>`_
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ses-receiptrule-connectaction.html
             :exampleMetadata: fixture=_generated
@@ -10685,7 +10853,10 @@ class CfnReceiptRule(
 
         @builtins.property
         def iam_role_arn(self) -> builtins.str:
-            '''
+            '''The Amazon Resource Name (ARN) of the IAM role to be used by Amazon Simple Email Service while starting email contacts to the Amazon Connect instance.
+
+            This role should have permission to invoke ``connect:StartEmailContact`` for the given Amazon Connect instance.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ses-receiptrule-connectaction.html#cfn-ses-receiptrule-connectaction-iamrolearn
             '''
             result = self._values.get("iam_role_arn")
@@ -10694,7 +10865,10 @@ class CfnReceiptRule(
 
         @builtins.property
         def instance_arn(self) -> builtins.str:
-            '''
+            '''The Amazon Resource Name (ARN) for the Amazon Connect instance that Amazon SES integrates with for starting email contacts.
+
+            For more information about Amazon Connect instances, see the `Amazon Connect Administrator Guide <https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-instances.html>`_
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ses-receiptrule-connectaction.html#cfn-ses-receiptrule-connectaction-instancearn
             '''
             result = self._values.get("instance_arn")
@@ -17490,6 +17664,16 @@ def _typecheckingstub__f83f79033a3d3e41cc283500ac0cae687aff7a85f60f1ed286d539e65
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__9bd73a70e10ea34690bce68c862abcfb0eb828f9546668bcdea3ffbc529c95c9(
+    *,
+    application_id: builtins.str,
+    index_id: builtins.str,
+    role_arn: builtins.str,
+    action_failure_policy: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__ee1b6c41bf7e9edfdf9ce8016febd1bcf8525a8b0d7c5da2fa7bd000d3076e77(
     *,
     relay: builtins.str,
@@ -17511,6 +17695,7 @@ def _typecheckingstub__305f0be9d67c9da493953a4770d737df26a1af8dedfd249fd91350062
     add_header: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnMailManagerRuleSet.AddHeaderActionProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     archive: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnMailManagerRuleSet.ArchiveActionProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     deliver_to_mailbox: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnMailManagerRuleSet.DeliverToMailboxActionProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    deliver_to_q_business: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnMailManagerRuleSet.DeliverToQBusinessActionProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     drop: typing.Any = None,
     relay: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnMailManagerRuleSet.RelayActionProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     replace_recipient: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnMailManagerRuleSet.ReplaceRecipientActionProperty, typing.Dict[builtins.str, typing.Any]]]] = None,

aws_cdk/aws_sns/__init__.py

@@ -605,7 +605,7 @@ class CfnSubscription(
         :param delivery_policy: The delivery policy JSON assigned to the subscription. 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](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)`` in the *Amazon SNS API Reference* and `Message delivery retries <https://docs.aws.amazon.com/sns/latest/dg/sns-message-delivery-retries.html>`_ in the *Amazon SNS Developer Guide* .
         :param endpoint: The subscription's endpoint. The endpoint value depends on the protocol that you specify. For more information, see the ``Endpoint`` parameter of the ``[Subscribe](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)`` action in the *Amazon SNS API Reference* .
         :param filter_policy: The filter policy JSON assigned to the subscription. Enables the subscriber to filter out unwanted messages. For more information, see ``[GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)`` in the *Amazon SNS API Reference* and `Message filtering <https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html>`_ in the *Amazon SNS Developer Guide* .
-        :param filter_policy_scope: This attribute lets you choose the filtering scope by using one of the following string value types:. - ``MessageAttributes`` (default) - The filter is applied on the message attributes. - ``MessageBody`` - The filter is applied on the message body.
+        :param filter_policy_scope: This attribute lets you choose the filtering scope by using one of the following string value types:. - ``MessageAttributes`` (default) - The filter is applied on the message attributes. - ``MessageBody`` - The filter is applied on the message body. .. epigraph:: ``Null`` is not a valid value for ``FilterPolicyScope`` . To delete a filter policy, delete the ``FilterPolicy`` property but keep ``FilterPolicyScope`` property as is.
         :param raw_message_delivery: When set to ``true`` , enables raw message delivery. Raw messages don't contain any JSON formatting and can be sent to Amazon SQS and HTTP/S endpoints. For more information, see ``[GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)`` in the *Amazon SNS API Reference* .
         :param redrive_policy: 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. For more information about the redrive policy and dead-letter queues, see `Amazon SQS dead-letter queues <https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html>`_ in the *Amazon SQS Developer Guide* .
         :param region: For cross-region subscriptions, the region in which the topic resides. 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: - Updating the ``Region`` from ``NULL`` to the caller region. - Updating the ``Region`` from the caller region to ``NULL`` .
@@ -665,7 +665,7 @@ class CfnSubscription(
     @builtins.property
     @jsii.member(jsii_name="attrArn")
     def attr_arn(self) -> builtins.str:
-        '''Arn of the subscription.
+        '''Returns the ARN of the subscription created by the AWS::SNS::Subscription resource.
 
         :cloudformationAttribute: Arn
         '''
@@ -865,7 +865,7 @@ class CfnSubscriptionProps:
         :param delivery_policy: The delivery policy JSON assigned to the subscription. 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](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)`` in the *Amazon SNS API Reference* and `Message delivery retries <https://docs.aws.amazon.com/sns/latest/dg/sns-message-delivery-retries.html>`_ in the *Amazon SNS Developer Guide* .
         :param endpoint: The subscription's endpoint. The endpoint value depends on the protocol that you specify. For more information, see the ``Endpoint`` parameter of the ``[Subscribe](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)`` action in the *Amazon SNS API Reference* .
         :param filter_policy: The filter policy JSON assigned to the subscription. Enables the subscriber to filter out unwanted messages. For more information, see ``[GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)`` in the *Amazon SNS API Reference* and `Message filtering <https://docs.aws.amazon.com/sns/latest/dg/sns-message-filtering.html>`_ in the *Amazon SNS Developer Guide* .
-        :param filter_policy_scope: This attribute lets you choose the filtering scope by using one of the following string value types:. - ``MessageAttributes`` (default) - The filter is applied on the message attributes. - ``MessageBody`` - The filter is applied on the message body.
+        :param filter_policy_scope: This attribute lets you choose the filtering scope by using one of the following string value types:. - ``MessageAttributes`` (default) - The filter is applied on the message attributes. - ``MessageBody`` - The filter is applied on the message body. .. epigraph:: ``Null`` is not a valid value for ``FilterPolicyScope`` . To delete a filter policy, delete the ``FilterPolicy`` property but keep ``FilterPolicyScope`` property as is.
         :param raw_message_delivery: When set to ``true`` , enables raw message delivery. Raw messages don't contain any JSON formatting and can be sent to Amazon SQS and HTTP/S endpoints. For more information, see ``[GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)`` in the *Amazon SNS API Reference* .
         :param redrive_policy: 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. For more information about the redrive policy and dead-letter queues, see `Amazon SQS dead-letter queues <https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html>`_ in the *Amazon SQS Developer Guide* .
         :param region: For cross-region subscriptions, the region in which the topic resides. 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: - Updating the ``Region`` from ``NULL`` to the caller region. - Updating the ``Region`` from the caller region to ``NULL`` .
@@ -1000,6 +1000,10 @@ class CfnSubscriptionProps:
         - ``MessageAttributes`` (default) - The filter is applied on the message attributes.
         - ``MessageBody`` - The filter is applied on the message body.
 
+        .. epigraph::
+
+           ``Null`` is not a valid value for ``FilterPolicyScope`` . To delete a filter policy, delete the ``FilterPolicy`` property but keep ``FilterPolicyScope`` property as is.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicyscope
         '''
         result = self._values.get("filter_policy_scope")

aws_cdk/aws_synthetics/__init__.py

@@ -1318,6 +1318,7 @@ class CfnCanary(
                 subnet_ids=["subnetIds"],
         
                 # the properties below are optional
+                ipv6_allowed_for_dual_stack=False,
                 vpc_id="vpcId"
             )
         )
@@ -1357,12 +1358,12 @@ class CfnCanary(
         :param schedule: A structure that contains information about how often the canary is to run, and when these runs are to stop.
         :param artifact_config: A structure that contains the configuration for canary artifacts, including the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.
         :param delete_lambda_resources_on_canary_deletion: (deprecated) Deletes associated lambda resources created by Synthetics if set to True. Default is False
-        :param failure_retention_period: The number of days to retain data about failed runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.
+        :param failure_retention_period: The number of days to retain data about failed runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days. This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
         :param provisioned_resource_cleanup: Specifies whether to also delete the Lambda functions and layers used by this canary when the canary is deleted. If it is ``AUTOMATIC`` , the Lambda functions and layers will be deleted when the canary is deleted. If the value of this parameter is ``OFF`` , then the value of the ``DeleteLambda`` parameter of the `DeleteCanary <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DeleteCanary.html>`_ operation determines whether the Lambda functions and layers will be deleted.
         :param resources_to_replicate_tags: To have the tags that you apply to this canary also be applied to the Lambda function that the canary uses, specify this property with the value ``lambda-function`` . If you do this, CloudWatch Synthetics will keep the tags of the canary and the Lambda function synchronized. Any future changes you make to the canary's tags will also be applied to the function.
         :param run_config: A structure that contains input information for a canary run. If you omit this structure, the frequency of the canary is used as canary's timeout value, up to a maximum of 900 seconds.
         :param start_canary_after_creation: Specify TRUE to have the canary start making runs immediately after it is created. A canary that you create using CloudFormation can't be used to monitor the CloudFormation stack that creates the canary or to roll back that stack if there is a failure.
-        :param success_retention_period: The number of days to retain data about successful runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.
+        :param success_retention_period: The number of days to retain data about successful runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days. This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
         :param tags: The list of key-value pairs that are associated with the canary.
         :param visual_reference: If this canary performs visual monitoring by comparing screenshots, this structure contains the ID of the canary run to use as the baseline for screenshots, and the coordinates of any parts of the screen to ignore during the visual monitoring comparison.
         :param vpc_config: If this canary is to test an endpoint in a VPC, this structure contains information about the subnet and security groups of the VPC endpoint. For more information, see `Running a Canary in a VPC <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_VPC.html>`_ .
@@ -2322,6 +2323,7 @@ class CfnCanary(
         name_mapping={
             "security_group_ids": "securityGroupIds",
             "subnet_ids": "subnetIds",
+            "ipv6_allowed_for_dual_stack": "ipv6AllowedForDualStack",
             "vpc_id": "vpcId",
         },
     )
@@ -2331,6 +2333,7 @@ class CfnCanary(
             *,
             security_group_ids: typing.Sequence[builtins.str],
             subnet_ids: typing.Sequence[builtins.str],
+            ipv6_allowed_for_dual_stack: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
             vpc_id: typing.Optional[builtins.str] = None,
         ) -> None:
             '''If this canary is to test an endpoint in a VPC, this structure contains information about the subnet and security groups of the VPC endpoint.
@@ -2339,6 +2342,7 @@ class CfnCanary(
 
             :param security_group_ids: The IDs of the security groups for this canary.
             :param subnet_ids: The IDs of the subnets where this canary is to run.
+            :param ipv6_allowed_for_dual_stack: Allow outbound IPv6 traffic on VPC canaries that are connected to dual-stack subnets if set to true.
             :param vpc_id: The ID of the VPC where this canary is to run.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-vpcconfig.html
@@ -2355,6 +2359,7 @@ class CfnCanary(
                     subnet_ids=["subnetIds"],
                 
                     # the properties below are optional
+                    ipv6_allowed_for_dual_stack=False,
                     vpc_id="vpcId"
                 )
             '''
@@ -2362,11 +2367,14 @@ class CfnCanary(
                 type_hints = typing.get_type_hints(_typecheckingstub__eccfde82eb2354e9c416fba506f2ff8e4fb1a86792529f65e2d8eafbc8415074)
                 check_type(argname="argument security_group_ids", value=security_group_ids, expected_type=type_hints["security_group_ids"])
                 check_type(argname="argument subnet_ids", value=subnet_ids, expected_type=type_hints["subnet_ids"])
+                check_type(argname="argument ipv6_allowed_for_dual_stack", value=ipv6_allowed_for_dual_stack, expected_type=type_hints["ipv6_allowed_for_dual_stack"])
                 check_type(argname="argument vpc_id", value=vpc_id, expected_type=type_hints["vpc_id"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
                 "security_group_ids": security_group_ids,
                 "subnet_ids": subnet_ids,
             }
+            if ipv6_allowed_for_dual_stack is not None:
+                self._values["ipv6_allowed_for_dual_stack"] = ipv6_allowed_for_dual_stack
             if vpc_id is not None:
                 self._values["vpc_id"] = vpc_id
 
@@ -2390,6 +2398,17 @@ class CfnCanary(
             assert result is not None, "Required property 'subnet_ids' is missing"
             return typing.cast(typing.List[builtins.str], result)
 
+        @builtins.property
+        def ipv6_allowed_for_dual_stack(
+            self,
+        ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
+            '''Allow outbound IPv6 traffic on VPC canaries that are connected to dual-stack subnets if set to true.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-vpcconfig.html#cfn-synthetics-canary-vpcconfig-ipv6allowedfordualstack
+            '''
+            result = self._values.get("ipv6_allowed_for_dual_stack")
+            return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
+
         @builtins.property
         def vpc_id(self) -> typing.Optional[builtins.str]:
             '''The ID of the VPC where this canary is to run.
@@ -2555,12 +2574,12 @@ class CfnCanaryProps:
         :param schedule: A structure that contains information about how often the canary is to run, and when these runs are to stop.
         :param artifact_config: A structure that contains the configuration for canary artifacts, including the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.
         :param delete_lambda_resources_on_canary_deletion: (deprecated) Deletes associated lambda resources created by Synthetics if set to True. Default is False
-        :param failure_retention_period: The number of days to retain data about failed runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.
+        :param failure_retention_period: The number of days to retain data about failed runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days. This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
         :param provisioned_resource_cleanup: Specifies whether to also delete the Lambda functions and layers used by this canary when the canary is deleted. If it is ``AUTOMATIC`` , the Lambda functions and layers will be deleted when the canary is deleted. If the value of this parameter is ``OFF`` , then the value of the ``DeleteLambda`` parameter of the `DeleteCanary <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DeleteCanary.html>`_ operation determines whether the Lambda functions and layers will be deleted.
         :param resources_to_replicate_tags: To have the tags that you apply to this canary also be applied to the Lambda function that the canary uses, specify this property with the value ``lambda-function`` . If you do this, CloudWatch Synthetics will keep the tags of the canary and the Lambda function synchronized. Any future changes you make to the canary's tags will also be applied to the function.
         :param run_config: A structure that contains input information for a canary run. If you omit this structure, the frequency of the canary is used as canary's timeout value, up to a maximum of 900 seconds.
         :param start_canary_after_creation: Specify TRUE to have the canary start making runs immediately after it is created. A canary that you create using CloudFormation can't be used to monitor the CloudFormation stack that creates the canary or to roll back that stack if there is a failure.
-        :param success_retention_period: The number of days to retain data about successful runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.
+        :param success_retention_period: The number of days to retain data about successful runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days. This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
         :param tags: The list of key-value pairs that are associated with the canary.
         :param visual_reference: If this canary performs visual monitoring by comparing screenshots, this structure contains the ID of the canary run to use as the baseline for screenshots, and the coordinates of any parts of the screen to ignore during the visual monitoring comparison.
         :param vpc_config: If this canary is to test an endpoint in a VPC, this structure contains information about the subnet and security groups of the VPC endpoint. For more information, see `Running a Canary in a VPC <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_VPC.html>`_ .
@@ -2637,6 +2656,7 @@ class CfnCanaryProps:
                     subnet_ids=["subnetIds"],
             
                     # the properties below are optional
+                    ipv6_allowed_for_dual_stack=False,
                     vpc_id="vpcId"
                 )
             )
@@ -2806,6 +2826,8 @@ class CfnCanaryProps:
 
         If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.
 
+        This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html#cfn-synthetics-canary-failureretentionperiod
         '''
         result = self._values.get("failure_retention_period")
@@ -2867,6 +2889,8 @@ class CfnCanaryProps:
 
         If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.
 
+        This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html#cfn-synthetics-canary-successretentionperiod
         '''
         result = self._values.get("success_retention_period")
@@ -4709,6 +4733,7 @@ def _typecheckingstub__eccfde82eb2354e9c416fba506f2ff8e4fb1a86792529f65e2d8eafbc
     *,
     security_group_ids: typing.Sequence[builtins.str],
     subnet_ids: typing.Sequence[builtins.str],
+    ipv6_allowed_for_dual_stack: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     vpc_id: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""

aws_cdk/aws_transfer/__init__.py

@@ -2219,6 +2219,14 @@ class CfnServer(
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrServerId"))
 
+    @builtins.property
+    @jsii.member(jsii_name="attrState")
+    def attr_state(self) -> builtins.str:
+        '''
+        :cloudformationAttribute: State
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrState"))
+
     @builtins.property
     @jsii.member(jsii_name="cfnProperties")
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]: