aws-cdk-lib 2.167.2__py3-none-any.whl → 2.168.0__py3-none-any.whl

aws_cdk/aws_securityhub/__init__.py

@@ -4238,8 +4238,8 @@ class CfnFindingAggregator(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param region_linking_mode: Indicates whether to aggregate findings from all of the available Regions in the current partition. Also determines whether to automatically aggregate findings from new Regions as Security Hub supports them and you opt into them. The selected option also determines how to use the Regions provided in the Regions list. The options are as follows: - ``ALL_REGIONS`` - Aggregates findings from all of the Regions where Security Hub is enabled. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them. - ``ALL_REGIONS_EXCEPT_SPECIFIED`` - Aggregates findings from all of the Regions where Security Hub is enabled, except for the Regions listed in the ``Regions`` parameter. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them. - ``SPECIFIED_REGIONS`` - Aggregates findings only from the Regions listed in the ``Regions`` parameter. Security Hub does not automatically aggregate findings from new Regions. - ``NO_REGIONS`` - Aggregates no data because no Regions are selected as linked Regions.
-        :param regions: If ``RegionLinkingMode`` is ``ALL_REGIONS_EXCEPT_SPECIFIED`` , then this is a space-separated list of Regions that don't replicate and send findings to the home Region. If ``RegionLinkingMode`` is ``SPECIFIED_REGIONS`` , then this is a space-separated list of Regions that do replicate and send findings to the home Region. An ``InvalidInputException`` error results if you populate this field while ``RegionLinkingMode`` is ``NO_REGIONS`` .
+        :param region_linking_mode: Indicates whether to aggregate findings from all of the available Regions in the current partition. Also determines whether to automatically aggregate findings from new Regions as Security Hub supports them and you opt into them. The selected option also determines how to use the Regions provided in the Regions list. In AWS CloudFormation , the options for this property are as follows: - ``ALL_REGIONS`` - Indicates to aggregate findings from all of the Regions where Security Hub is enabled. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them. - ``ALL_REGIONS_EXCEPT_SPECIFIED`` - Indicates to aggregate findings from all of the Regions where Security Hub is enabled, except for the Regions listed in the ``Regions`` parameter. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them. - ``SPECIFIED_REGIONS`` - Indicates to aggregate findings only from the Regions listed in the ``Regions`` parameter. Security Hub does not automatically aggregate findings from new Regions.
+        :param regions: If ``RegionLinkingMode`` is ``ALL_REGIONS_EXCEPT_SPECIFIED`` , then this is a space-separated list of Regions that do not aggregate findings to the aggregation Region. If ``RegionLinkingMode`` is ``SPECIFIED_REGIONS`` , then this is a space-separated list of Regions that do aggregate findings to the aggregation Region.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__def955d28b5fec6358172b72efd12a764fe7f7be8d0ea9076bc99608ed72dd3c)
@@ -4324,7 +4324,7 @@ class CfnFindingAggregator(
     @builtins.property
     @jsii.member(jsii_name="regions")
     def regions(self) -> typing.Optional[typing.List[builtins.str]]:
-        '''If ``RegionLinkingMode`` is ``ALL_REGIONS_EXCEPT_SPECIFIED`` , then this is a space-separated list of Regions that don't replicate and send findings to the home Region.'''
+        '''If ``RegionLinkingMode`` is ``ALL_REGIONS_EXCEPT_SPECIFIED`` , then this is a space-separated list of Regions that do not aggregate findings to the aggregation Region.'''
         return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "regions"))
 
     @regions.setter
@@ -4349,8 +4349,8 @@ class CfnFindingAggregatorProps:
     ) -> None:
         '''Properties for defining a ``CfnFindingAggregator``.
 
-        :param region_linking_mode: Indicates whether to aggregate findings from all of the available Regions in the current partition. Also determines whether to automatically aggregate findings from new Regions as Security Hub supports them and you opt into them. The selected option also determines how to use the Regions provided in the Regions list. The options are as follows: - ``ALL_REGIONS`` - Aggregates findings from all of the Regions where Security Hub is enabled. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them. - ``ALL_REGIONS_EXCEPT_SPECIFIED`` - Aggregates findings from all of the Regions where Security Hub is enabled, except for the Regions listed in the ``Regions`` parameter. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them. - ``SPECIFIED_REGIONS`` - Aggregates findings only from the Regions listed in the ``Regions`` parameter. Security Hub does not automatically aggregate findings from new Regions. - ``NO_REGIONS`` - Aggregates no data because no Regions are selected as linked Regions.
-        :param regions: If ``RegionLinkingMode`` is ``ALL_REGIONS_EXCEPT_SPECIFIED`` , then this is a space-separated list of Regions that don't replicate and send findings to the home Region. If ``RegionLinkingMode`` is ``SPECIFIED_REGIONS`` , then this is a space-separated list of Regions that do replicate and send findings to the home Region. An ``InvalidInputException`` error results if you populate this field while ``RegionLinkingMode`` is ``NO_REGIONS`` .
+        :param region_linking_mode: Indicates whether to aggregate findings from all of the available Regions in the current partition. Also determines whether to automatically aggregate findings from new Regions as Security Hub supports them and you opt into them. The selected option also determines how to use the Regions provided in the Regions list. In AWS CloudFormation , the options for this property are as follows: - ``ALL_REGIONS`` - Indicates to aggregate findings from all of the Regions where Security Hub is enabled. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them. - ``ALL_REGIONS_EXCEPT_SPECIFIED`` - Indicates to aggregate findings from all of the Regions where Security Hub is enabled, except for the Regions listed in the ``Regions`` parameter. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them. - ``SPECIFIED_REGIONS`` - Indicates to aggregate findings only from the Regions listed in the ``Regions`` parameter. Security Hub does not automatically aggregate findings from new Regions.
+        :param regions: If ``RegionLinkingMode`` is ``ALL_REGIONS_EXCEPT_SPECIFIED`` , then this is a space-separated list of Regions that do not aggregate findings to the aggregation Region. If ``RegionLinkingMode`` is ``SPECIFIED_REGIONS`` , then this is a space-separated list of Regions that do aggregate findings to the aggregation Region.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securityhub-findingaggregator.html
         :exampleMetadata: fixture=_generated
@@ -4386,12 +4386,11 @@ class CfnFindingAggregatorProps:
 
         The selected option also determines how to use the Regions provided in the Regions list.
 
-        The options are as follows:
+        In AWS CloudFormation , the options for this property are as follows:
 
-        - ``ALL_REGIONS`` - Aggregates findings from all of the Regions where Security Hub is enabled. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them.
-        - ``ALL_REGIONS_EXCEPT_SPECIFIED`` - Aggregates findings from all of the Regions where Security Hub is enabled, except for the Regions listed in the ``Regions`` parameter. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them.
-        - ``SPECIFIED_REGIONS`` - Aggregates findings only from the Regions listed in the ``Regions`` parameter. Security Hub does not automatically aggregate findings from new Regions.
-        - ``NO_REGIONS`` - Aggregates no data because no Regions are selected as linked Regions.
+        - ``ALL_REGIONS`` - Indicates to aggregate findings from all of the Regions where Security Hub is enabled. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them.
+        - ``ALL_REGIONS_EXCEPT_SPECIFIED`` - Indicates to aggregate findings from all of the Regions where Security Hub is enabled, except for the Regions listed in the ``Regions`` parameter. When you choose this option, Security Hub also automatically aggregates findings from new Regions as Security Hub supports them and you opt into them.
+        - ``SPECIFIED_REGIONS`` - Indicates to aggregate findings only from the Regions listed in the ``Regions`` parameter. Security Hub does not automatically aggregate findings from new Regions.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securityhub-findingaggregator.html#cfn-securityhub-findingaggregator-regionlinkingmode
         '''
@@ -4401,11 +4400,9 @@ class CfnFindingAggregatorProps:
 
     @builtins.property
     def regions(self) -> typing.Optional[typing.List[builtins.str]]:
-        '''If ``RegionLinkingMode`` is ``ALL_REGIONS_EXCEPT_SPECIFIED`` , then this is a space-separated list of Regions that don't replicate and send findings to the home Region.
+        '''If ``RegionLinkingMode`` is ``ALL_REGIONS_EXCEPT_SPECIFIED`` , then this is a space-separated list of Regions that do not aggregate findings to the aggregation Region.
 
-        If ``RegionLinkingMode`` is ``SPECIFIED_REGIONS`` , then this is a space-separated list of Regions that do replicate and send findings to the home Region.
-
-        An ``InvalidInputException`` error results if you populate this field while ``RegionLinkingMode`` is ``NO_REGIONS`` .
+        If ``RegionLinkingMode`` is ``SPECIFIED_REGIONS`` , then this is a space-separated list of Regions that do aggregate findings to the aggregation Region.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securityhub-findingaggregator.html#cfn-securityhub-findingaggregator-regions
         '''

aws_cdk/aws_ses/__init__.py

@@ -131,6 +131,8 @@ set to an email, all of the rules in that configuration set are applied to the e
 Use the `ConfigurationSet` construct to create a configuration set:
 
 ```python
+from aws_cdk import Duration
+
 # my_pool: ses.IDedicatedIpPool
 
 
@@ -138,7 +140,11 @@ ses.ConfigurationSet(self, "ConfigurationSet",
     custom_tracking_redirect_domain="track.cdk.dev",
     suppression_reasons=ses.SuppressionReasons.COMPLAINTS_ONLY,
     tls_policy=ses.ConfigurationSetTlsPolicy.REQUIRE,
-    dedicated_ip_pool=my_pool
+    dedicated_ip_pool=my_pool,
+    # Specify maximum delivery time
+    # This configuration can be useful in such cases as time-sensitive emails (like those containing a one-time-password),
+    # transactional emails, and email that you want to ensure isn't delivered during non-business hours.
+    max_delivery_duration=Duration.minutes(10)
 )
 ```
 
@@ -292,6 +298,7 @@ import constructs as _constructs_77d1e7e8
 from .. import (
     CfnResource as _CfnResource_9df397a6,
     CfnTag as _CfnTag_f6864754,
+    Duration as _Duration_4839e8c3,
     IInspectable as _IInspectable_c2943556,
     IResolvable as _IResolvable_da3f097b,
     IResource as _IResource_c80c4260,
@@ -12560,6 +12567,7 @@ class ConfigurationSetEventDestinationProps(ConfigurationSetEventDestinationOpti
         "configuration_set_name": "configurationSetName",
         "custom_tracking_redirect_domain": "customTrackingRedirectDomain",
         "dedicated_ip_pool": "dedicatedIpPool",
+        "max_delivery_duration": "maxDeliveryDuration",
         "reputation_metrics": "reputationMetrics",
         "sending_enabled": "sendingEnabled",
         "suppression_reasons": "suppressionReasons",
@@ -12574,6 +12582,7 @@ class ConfigurationSetProps:
         configuration_set_name: typing.Optional[builtins.str] = None,
         custom_tracking_redirect_domain: typing.Optional[builtins.str] = None,
         dedicated_ip_pool: typing.Optional["IDedicatedIpPool"] = None,
+        max_delivery_duration: typing.Optional[_Duration_4839e8c3] = None,
         reputation_metrics: typing.Optional[builtins.bool] = None,
         sending_enabled: typing.Optional[builtins.bool] = None,
         suppression_reasons: typing.Optional["SuppressionReasons"] = None,
@@ -12585,6 +12594,7 @@ class ConfigurationSetProps:
         :param configuration_set_name: A name for the configuration set. Default: - a CloudFormation generated name
         :param custom_tracking_redirect_domain: The custom subdomain that is used to redirect email recipients to the Amazon SES event tracking domain. Default: - use the default awstrack.me domain
         :param dedicated_ip_pool: The dedicated IP pool to associate with the configuration set. Default: - do not use a dedicated IP pool
+        :param max_delivery_duration: The maximum amount of time that Amazon SES API v2 will attempt delivery of email. This value must be greater than or equal to 5 minutes and less than or equal to 14 hours. Default: undefined - SES defaults to 14 hours
         :param reputation_metrics: Whether to publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch. Default: true
         :param sending_enabled: Whether email sending is enabled. Default: true
         :param suppression_reasons: The reasons for which recipient email addresses should be automatically added to your account's suppression list. Default: - use account level settings
@@ -12595,6 +12605,8 @@ class ConfigurationSetProps:
 
         Example::
 
+            from aws_cdk import Duration
+            
             # my_pool: ses.IDedicatedIpPool
             
             
@@ -12602,7 +12614,11 @@ class ConfigurationSetProps:
                 custom_tracking_redirect_domain="track.cdk.dev",
                 suppression_reasons=ses.SuppressionReasons.COMPLAINTS_ONLY,
                 tls_policy=ses.ConfigurationSetTlsPolicy.REQUIRE,
-                dedicated_ip_pool=my_pool
+                dedicated_ip_pool=my_pool,
+                # Specify maximum delivery time
+                # This configuration can be useful in such cases as time-sensitive emails (like those containing a one-time-password),
+                # transactional emails, and email that you want to ensure isn't delivered during non-business hours.
+                max_delivery_duration=Duration.minutes(10)
             )
         '''
         if isinstance(vdm_options, dict):
@@ -12612,6 +12628,7 @@ class ConfigurationSetProps:
             check_type(argname="argument configuration_set_name", value=configuration_set_name, expected_type=type_hints["configuration_set_name"])
             check_type(argname="argument custom_tracking_redirect_domain", value=custom_tracking_redirect_domain, expected_type=type_hints["custom_tracking_redirect_domain"])
             check_type(argname="argument dedicated_ip_pool", value=dedicated_ip_pool, expected_type=type_hints["dedicated_ip_pool"])
+            check_type(argname="argument max_delivery_duration", value=max_delivery_duration, expected_type=type_hints["max_delivery_duration"])
             check_type(argname="argument reputation_metrics", value=reputation_metrics, expected_type=type_hints["reputation_metrics"])
             check_type(argname="argument sending_enabled", value=sending_enabled, expected_type=type_hints["sending_enabled"])
             check_type(argname="argument suppression_reasons", value=suppression_reasons, expected_type=type_hints["suppression_reasons"])
@@ -12624,6 +12641,8 @@ class ConfigurationSetProps:
             self._values["custom_tracking_redirect_domain"] = custom_tracking_redirect_domain
         if dedicated_ip_pool is not None:
             self._values["dedicated_ip_pool"] = dedicated_ip_pool
+        if max_delivery_duration is not None:
+            self._values["max_delivery_duration"] = max_delivery_duration
         if reputation_metrics is not None:
             self._values["reputation_metrics"] = reputation_metrics
         if sending_enabled is not None:
@@ -12662,6 +12681,17 @@ class ConfigurationSetProps:
         result = self._values.get("dedicated_ip_pool")
         return typing.cast(typing.Optional["IDedicatedIpPool"], result)
 
+    @builtins.property
+    def max_delivery_duration(self) -> typing.Optional[_Duration_4839e8c3]:
+        '''The maximum amount of time that Amazon SES API v2 will attempt delivery of email.
+
+        This value must be greater than or equal to 5 minutes and less than or equal to 14 hours.
+
+        :default: undefined - SES defaults to 14 hours
+        '''
+        result = self._values.get("max_delivery_duration")
+        return typing.cast(typing.Optional[_Duration_4839e8c3], result)
+
     @builtins.property
     def reputation_metrics(self) -> typing.Optional[builtins.bool]:
         '''Whether to publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch.
@@ -12727,6 +12757,8 @@ class ConfigurationSetTlsPolicy(enum.Enum):
 
     Example::
 
+        from aws_cdk import Duration
+        
         # my_pool: ses.IDedicatedIpPool
         
         
@@ -12734,7 +12766,11 @@ class ConfigurationSetTlsPolicy(enum.Enum):
             custom_tracking_redirect_domain="track.cdk.dev",
             suppression_reasons=ses.SuppressionReasons.COMPLAINTS_ONLY,
             tls_policy=ses.ConfigurationSetTlsPolicy.REQUIRE,
-            dedicated_ip_pool=my_pool
+            dedicated_ip_pool=my_pool,
+            # Specify maximum delivery time
+            # This configuration can be useful in such cases as time-sensitive emails (like those containing a one-time-password),
+            # transactional emails, and email that you want to ensure isn't delivered during non-business hours.
+            max_delivery_duration=Duration.minutes(10)
         )
     '''
 
@@ -15351,6 +15387,8 @@ class SuppressionReasons(enum.Enum):
 
     Example::
 
+        from aws_cdk import Duration
+        
         # my_pool: ses.IDedicatedIpPool
         
         
@@ -15358,7 +15396,11 @@ class SuppressionReasons(enum.Enum):
             custom_tracking_redirect_domain="track.cdk.dev",
             suppression_reasons=ses.SuppressionReasons.COMPLAINTS_ONLY,
             tls_policy=ses.ConfigurationSetTlsPolicy.REQUIRE,
-            dedicated_ip_pool=my_pool
+            dedicated_ip_pool=my_pool,
+            # Specify maximum delivery time
+            # This configuration can be useful in such cases as time-sensitive emails (like those containing a one-time-password),
+            # transactional emails, and email that you want to ensure isn't delivered during non-business hours.
+            max_delivery_duration=Duration.minutes(10)
         )
     '''
 
@@ -15689,6 +15731,8 @@ class ConfigurationSet(
 
     Example::
 
+        from aws_cdk import Duration
+        
         # my_pool: ses.IDedicatedIpPool
         
         
@@ -15696,7 +15740,11 @@ class ConfigurationSet(
             custom_tracking_redirect_domain="track.cdk.dev",
             suppression_reasons=ses.SuppressionReasons.COMPLAINTS_ONLY,
             tls_policy=ses.ConfigurationSetTlsPolicy.REQUIRE,
-            dedicated_ip_pool=my_pool
+            dedicated_ip_pool=my_pool,
+            # Specify maximum delivery time
+            # This configuration can be useful in such cases as time-sensitive emails (like those containing a one-time-password),
+            # transactional emails, and email that you want to ensure isn't delivered during non-business hours.
+            max_delivery_duration=Duration.minutes(10)
         )
     '''
 
@@ -15708,6 +15756,7 @@ class ConfigurationSet(
         configuration_set_name: typing.Optional[builtins.str] = None,
         custom_tracking_redirect_domain: typing.Optional[builtins.str] = None,
         dedicated_ip_pool: typing.Optional[IDedicatedIpPool] = None,
+        max_delivery_duration: typing.Optional[_Duration_4839e8c3] = None,
         reputation_metrics: typing.Optional[builtins.bool] = None,
         sending_enabled: typing.Optional[builtins.bool] = None,
         suppression_reasons: typing.Optional[SuppressionReasons] = None,
@@ -15720,6 +15769,7 @@ class ConfigurationSet(
         :param configuration_set_name: A name for the configuration set. Default: - a CloudFormation generated name
         :param custom_tracking_redirect_domain: The custom subdomain that is used to redirect email recipients to the Amazon SES event tracking domain. Default: - use the default awstrack.me domain
         :param dedicated_ip_pool: The dedicated IP pool to associate with the configuration set. Default: - do not use a dedicated IP pool
+        :param max_delivery_duration: The maximum amount of time that Amazon SES API v2 will attempt delivery of email. This value must be greater than or equal to 5 minutes and less than or equal to 14 hours. Default: undefined - SES defaults to 14 hours
         :param reputation_metrics: Whether to publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch. Default: true
         :param sending_enabled: Whether email sending is enabled. Default: true
         :param suppression_reasons: The reasons for which recipient email addresses should be automatically added to your account's suppression list. Default: - use account level settings
@@ -15734,6 +15784,7 @@ class ConfigurationSet(
             configuration_set_name=configuration_set_name,
             custom_tracking_redirect_domain=custom_tracking_redirect_domain,
             dedicated_ip_pool=dedicated_ip_pool,
+            max_delivery_duration=max_delivery_duration,
             reputation_metrics=reputation_metrics,
             sending_enabled=sending_enabled,
             suppression_reasons=suppression_reasons,
@@ -17984,6 +18035,7 @@ def _typecheckingstub__fb010161f6c1e40b88122d9cb7754dae093e9cbe5bbfc72b19737729a
     configuration_set_name: typing.Optional[builtins.str] = None,
     custom_tracking_redirect_domain: typing.Optional[builtins.str] = None,
     dedicated_ip_pool: typing.Optional[IDedicatedIpPool] = None,
+    max_delivery_duration: typing.Optional[_Duration_4839e8c3] = None,
     reputation_metrics: typing.Optional[builtins.bool] = None,
     sending_enabled: typing.Optional[builtins.bool] = None,
     suppression_reasons: typing.Optional[SuppressionReasons] = None,
@@ -18339,6 +18391,7 @@ def _typecheckingstub__52b42851a408d3eb2b07399f2b34603200cef443be5e9f913f4a1d80a
     configuration_set_name: typing.Optional[builtins.str] = None,
     custom_tracking_redirect_domain: typing.Optional[builtins.str] = None,
     dedicated_ip_pool: typing.Optional[IDedicatedIpPool] = None,
+    max_delivery_duration: typing.Optional[_Duration_4839e8c3] = None,
     reputation_metrics: typing.Optional[builtins.bool] = None,
     sending_enabled: typing.Optional[builtins.bool] = None,
     suppression_reasons: typing.Optional[SuppressionReasons] = None,