aws-cdk-lib 2.201.0__py3-none-any.whl → 2.202.0__py3-none-any.whl

aws_cdk/__init__.py

@@ -6885,7 +6885,7 @@ class CfnOutput(CfnElement, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnO
         export_name: typing.Optional[builtins.str] = None,
         key: typing.Optional[builtins.str] = None,
     ) -> None:
-        '''Creates an CfnOutput value for this stack.
+        '''Creates a CfnOutput value for this stack.
 
         :param scope: The parent construct.
         :param id: -
@@ -21137,16 +21137,20 @@ class SecretValue(
 
     Example::
 
-        # my_hosted_zone: route53.IPublicHostedZone
-        
-        
-        ses.EmailIdentity(self, "Identity",
-            identity=ses.Identity.public_hosted_zone(my_hosted_zone),
-            dkim_identity=ses.DkimIdentity.byo_dkim(
-                private_key=SecretValue.secrets_manager("dkim-private-key"),
-                public_key="...base64-encoded-public-key...",
-                selector="selector"
-            )
+        # Read the secret from Secrets Manager
+        pipeline = codepipeline.Pipeline(self, "MyPipeline")
+        source_output = codepipeline.Artifact()
+        source_action = codepipeline_actions.GitHubSourceAction(
+            action_name="GitHub_Source",
+            owner="awslabs",
+            repo="aws-cdk",
+            oauth_token=SecretValue.secrets_manager("my-github-token"),
+            output=source_output,
+            branch="develop"
+        )
+        pipeline.add_stage(
+            stage_name="Source",
+            actions=[source_action]
         )
     '''
 
@@ -23358,19 +23362,15 @@ class Stage(
 
         # pipeline: pipelines.CodePipeline
         
-        preprod = MyApplicationStage(self, "PreProd")
-        prod = MyApplicationStage(self, "Prod")
-        
-        pipeline.add_stage(preprod,
-            post=[
-                pipelines.ShellStep("Validate Endpoint",
-                    commands=["curl -Ssf https://my.webservice.com/"]
-                )
-            ]
-        )
-        pipeline.add_stage(prod,
-            pre=[pipelines.ManualApprovalStep("PromoteToProd")]
-        )
+        europe_wave = pipeline.add_wave("Europe")
+        europe_wave.add_stage(
+            MyApplicationStage(self, "Ireland",
+                env=cdk.Environment(region="eu-west-1")
+            ))
+        europe_wave.add_stage(
+            MyApplicationStage(self, "Germany",
+                env=cdk.Environment(region="eu-central-1")
+            ))
     '''
 
     def __init__(

aws_cdk/_jsii/__init__.py

@@ -34,7 +34,7 @@ import aws_cdk.cloud_assembly_schema._jsii
 import constructs._jsii
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
-    "aws-cdk-lib", "2.201.0", __name__[0:-6], "aws-cdk-lib@2.201.0.jsii.tgz"
+    "aws-cdk-lib", "2.202.0", __name__[0:-6], "aws-cdk-lib@2.202.0.jsii.tgz"
 )
 
 __all__ = [

aws_cdk/aws_athena/__init__.py

@@ -2140,12 +2140,12 @@ class CfnWorkGroup(
             enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
             encryption_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnWorkGroup.ManagedStorageEncryptionConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''The configuration for the managed query results and encryption option.
+            '''The configuration for storing results in Athena owned storage, which includes whether this feature is enabled;
 
-            ResultConfiguration and ManagedQueryResultsConfiguration cannot be set at the same time
+            whether encryption configuration, if any, is used for encrypting query results.
 
-            :param enabled: 
-            :param encryption_configuration: Indicates the encryption configuration for Athena Managed Storage. If not setting this field, Managed Storage will encrypt the query results with Athena's encryption key
+            :param enabled: If set to true, allows you to store query results in Athena owned storage. If set to false, workgroup member stores query results in location specified under ``ResultConfiguration$OutputLocation`` . The default is false. A workgroup cannot have the ``ResultConfiguration$OutputLocation`` parameter when you set this field to true.
+            :param encryption_configuration: If you encrypt query and calculation results in Athena owned storage, this field indicates the encryption option (for example, SSE_KMS or CSE_KMS) and key information.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-athena-workgroup-managedqueryresultsconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -2177,7 +2177,10 @@ class CfnWorkGroup(
         def enabled(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''
+            '''If set to true, allows you to store query results in Athena owned storage.
+
+            If set to false, workgroup member stores query results in location specified under ``ResultConfiguration$OutputLocation`` . The default is false. A workgroup cannot have the ``ResultConfiguration$OutputLocation`` parameter when you set this field to true.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-athena-workgroup-managedqueryresultsconfiguration.html#cfn-athena-workgroup-managedqueryresultsconfiguration-enabled
             '''
             result = self._values.get("enabled")
@@ -2187,9 +2190,7 @@ class CfnWorkGroup(
         def encryption_configuration(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnWorkGroup.ManagedStorageEncryptionConfigurationProperty"]]:
-            '''Indicates the encryption configuration for Athena Managed Storage.
-
-            If not setting this field, Managed Storage will encrypt the query results with Athena's encryption key
+            '''If you encrypt query and calculation results in Athena owned storage, this field indicates the encryption option (for example, SSE_KMS or CSE_KMS) and key information.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-athena-workgroup-managedqueryresultsconfiguration.html#cfn-athena-workgroup-managedqueryresultsconfiguration-encryptionconfiguration
             '''
@@ -2631,7 +2632,7 @@ class CfnWorkGroup(
             :param enforce_work_group_configuration: If set to "true", the settings for the workgroup override client-side settings. If set to "false", client-side settings are used. For more information, see `Override client-side settings <https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html>`_ .
             :param engine_version: The engine version that all queries running on the workgroup use.
             :param execution_role: Role used to access user resources in an Athena for Apache Spark session. This property applies only to Spark-enabled workgroups in Athena.
-            :param managed_query_results_configuration: The configuration for the managed query results and encryption option. ResultConfiguration and ManagedQueryResultsConfiguration cannot be set at the same time
+            :param managed_query_results_configuration: The configuration for storing results in Athena owned storage, which includes whether this feature is enabled; whether encryption configuration, if any, is used for encrypting query results.
             :param publish_cloud_watch_metrics_enabled: Indicates that the Amazon CloudWatch metrics are enabled for the workgroup.
             :param requester_pays_enabled: If set to ``true`` , allows members assigned to a workgroup to reference Amazon S3 Requester Pays buckets in queries. If set to ``false`` , workgroup members cannot query data from Requester Pays buckets, and queries that retrieve data from Requester Pays buckets cause an error. The default is ``false`` . For more information about Requester Pays buckets, see `Requester Pays Buckets <https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html>`_ in the *Amazon Simple Storage Service Developer Guide* .
             :param result_configuration: Specifies the location in Amazon S3 where query results are stored and the encryption option, if any, used for query results. For more information, see `Work with query results and recent queries <https://docs.aws.amazon.com/athena/latest/ug/querying.html>`_ .
@@ -2789,9 +2790,9 @@ class CfnWorkGroup(
         def managed_query_results_configuration(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnWorkGroup.ManagedQueryResultsConfigurationProperty"]]:
-            '''The configuration for the managed query results and encryption option.
+            '''The configuration for storing results in Athena owned storage, which includes whether this feature is enabled;
 
-            ResultConfiguration and ManagedQueryResultsConfiguration cannot be set at the same time
+            whether encryption configuration, if any, is used for encrypting query results.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-athena-workgroup-workgroupconfiguration.html#cfn-athena-workgroup-workgroupconfiguration-managedqueryresultsconfiguration
             '''

aws_cdk/aws_cloudfront/__init__.py

@@ -1295,7 +1295,25 @@ When using a CloudFront PublicKey, only the `comment` field can be updated after
 Resource handler returned message: "Invalid request provided: AWS::CloudFront::PublicKey"
 ```
 
-To update the `encodedKey`, you must change the logical ID of the public key resource in your template. This causes CloudFormation to create a new `cloudfront.PublicKey` resource and delete the old one during the next deployment.
+To update the `encodedKey`, you must change the ID of the public key resource in your template. This causes CloudFormation to create a new `cloudfront.PublicKey` resource and delete the old one during the next deployment.
+
+Example:
+
+```python
+# Step 1: Original deployment
+original_key = cloudfront.PublicKey(self, "MyPublicKeyV1",
+    encoded_key="..."
+)
+```
+
+Regenerate a new key and change the construct id in the code:
+
+```python
+# Step 2: In a subsequent deployment, create a new key with a different ID
+updated_key = cloudfront.PublicKey(self, "MyPublicKeyV2",
+    encoded_key="..."
+)
+```
 
 See:
 
@@ -23425,27 +23443,14 @@ class PublicKey(
 
     Example::
 
-        # Validating signed URLs or signed cookies with Trusted Key Groups
-        
-        # public key in PEM format
-        # public_key: str
-        
-        pub_key = cloudfront.PublicKey(self, "MyPubKey",
-            encoded_key=public_key
-        )
-        
-        key_group = cloudfront.KeyGroup(self, "MyKeyGroup",
-            items=[pub_key
+        # Create a key group to use with CloudFront signed URLs and signed cookies.
+        cloudfront.KeyGroup(self, "MyKeyGroup",
+            items=[
+                cloudfront.PublicKey(self, "MyPublicKey",
+                    encoded_key="..."
+                )
             ]
         )
-        
-        cloudfront.Distribution(self, "Dist",
-            default_behavior=cloudfront.BehaviorOptions(
-                origin=origins.HttpOrigin("www.example.com"),
-                trusted_key_groups=[key_group
-                ]
-            )
-        )
     '''
 
     def __init__(
@@ -23535,27 +23540,14 @@ class PublicKeyProps:
 
         Example::
 
-            # Validating signed URLs or signed cookies with Trusted Key Groups
-            
-            # public key in PEM format
-            # public_key: str
-            
-            pub_key = cloudfront.PublicKey(self, "MyPubKey",
-                encoded_key=public_key
-            )
-            
-            key_group = cloudfront.KeyGroup(self, "MyKeyGroup",
-                items=[pub_key
+            # Create a key group to use with CloudFront signed URLs and signed cookies.
+            cloudfront.KeyGroup(self, "MyKeyGroup",
+                items=[
+                    cloudfront.PublicKey(self, "MyPublicKey",
+                        encoded_key="..."
+                    )
                 ]
             )
-            
-            cloudfront.Distribution(self, "Dist",
-                default_behavior=cloudfront.BehaviorOptions(
-                    origin=origins.HttpOrigin("www.example.com"),
-                    trusted_key_groups=[key_group
-                    ]
-                )
-            )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__ab6d6a7ffe806c347a4fbac3b890074d407fcf2dd19c1ca56da8ddc83cb3ad61)

aws_cdk/aws_cloudfront/experimental/__init__.py

@@ -79,6 +79,7 @@ from ...aws_lambda import (
     IEventSourceDlq as _IEventSourceDlq_5e2c6ad9,
     IFunction as _IFunction_6adb0ab8,
     ILayerVersion as _ILayerVersion_5ac127c8,
+    ISchemaRegistry as _ISchemaRegistry_7e66a87f,
     IVersion as _IVersion_faf7234e,
     InvokeMode as _InvokeMode_e7b50559,
     LambdaInsightsVersion as _LambdaInsightsVersion_9dfbfef9,
@@ -396,6 +397,7 @@ class EdgeFunction(
         provisioned_poller_config: typing.Optional[typing.Union[_ProvisionedPollerConfig_1025e063, typing.Dict[builtins.str, typing.Any]]] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
         retry_attempts: typing.Optional[jsii.Number] = None,
+        schema_registry_config: typing.Optional[_ISchemaRegistry_7e66a87f] = None,
         source_access_configurations: typing.Optional[typing.Sequence[typing.Union[_SourceAccessConfiguration_1926ff89, typing.Dict[builtins.str, typing.Any]]]] = None,
         starting_position: typing.Optional[_StartingPosition_c0a4852c] = None,
         starting_position_timestamp: typing.Optional[jsii.Number] = None,
@@ -423,6 +425,7 @@ class EdgeFunction(
         :param provisioned_poller_config: Configuration for provisioned pollers that read from the event source. When specified, allows control over the minimum and maximum number of pollers that can be provisioned to process events from the source. Default: - no provisioned pollers
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
         :param retry_attempts: The maximum number of times to retry when the function returns an error. Set to ``undefined`` if you want lambda to keep retrying infinitely or until the record expires. Valid Range: - Minimum value of 0 - Maximum value of 10000 Default: - infinite or until the record expires.
+        :param schema_registry_config: Specific configuration settings for a Kafka schema registry. Default: - none
         :param source_access_configurations: Specific settings like the authentication protocol or the VPC components to secure access to your event source. Default: - none
         :param starting_position: The position in the DynamoDB, Kinesis or MSK stream where AWS Lambda should start reading. Default: - no starting position
         :param starting_position_timestamp: The time from which to start reading, in Unix time seconds. Default: - no timestamp
@@ -451,6 +454,7 @@ class EdgeFunction(
             provisioned_poller_config=provisioned_poller_config,
             report_batch_item_failures=report_batch_item_failures,
             retry_attempts=retry_attempts,
+            schema_registry_config=schema_registry_config,
             source_access_configurations=source_access_configurations,
             starting_position=starting_position,
             starting_position_timestamp=starting_position_timestamp,
@@ -2098,6 +2102,7 @@ def _typecheckingstub__e3a2f6769309cd3c52da869813738e2d4a94d233e574ada7ebba1654d
     provisioned_poller_config: typing.Optional[typing.Union[_ProvisionedPollerConfig_1025e063, typing.Dict[builtins.str, typing.Any]]] = None,
     report_batch_item_failures: typing.Optional[builtins.bool] = None,
     retry_attempts: typing.Optional[jsii.Number] = None,
+    schema_registry_config: typing.Optional[_ISchemaRegistry_7e66a87f] = None,
     source_access_configurations: typing.Optional[typing.Sequence[typing.Union[_SourceAccessConfiguration_1926ff89, typing.Dict[builtins.str, typing.Any]]]] = None,
     starting_position: typing.Optional[_StartingPosition_c0a4852c] = None,
     starting_position_timestamp: typing.Optional[jsii.Number] = None,

aws_cdk/aws_customerprofiles/__init__.py

@@ -155,7 +155,7 @@ class CfnCalculatedAttributeDefinition(
         :param description: The description of the calculated attribute.
         :param display_name: The display name of the calculated attribute.
         :param tags: An array of key-value pairs to apply to this resource.
-        :param use_historical_data: Whether to use historical data for the calculated attribute.
+        :param use_historical_data: Whether historical data ingested before the Calculated Attribute was created should be included in calculations.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__3a09ab96caa4db6cfa4ebb0207c025a7f976cac18f814d69b882506cf2971669)
@@ -235,7 +235,7 @@ class CfnCalculatedAttributeDefinition(
     @builtins.property
     @jsii.member(jsii_name="attrStatus")
     def attr_status(self) -> builtins.str:
-        '''The status of the calculated attribute definition.
+        '''Status of the Calculated Attribute creation (whether all historical data has been indexed.).
 
         :cloudformationAttribute: Status
         '''
@@ -371,7 +371,7 @@ class CfnCalculatedAttributeDefinition(
     def use_historical_data(
         self,
     ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-        '''Whether to use historical data for the calculated attribute.'''
+        '''Whether historical data ingested before the Calculated Attribute was created should be included in calculations.'''
         return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "useHistoricalData"))
 
     @use_historical_data.setter
@@ -1002,7 +1002,7 @@ class CfnCalculatedAttributeDefinitionProps:
         :param description: The description of the calculated attribute.
         :param display_name: The display name of the calculated attribute.
         :param tags: An array of key-value pairs to apply to this resource.
-        :param use_historical_data: Whether to use historical data for the calculated attribute.
+        :param use_historical_data: Whether historical data ingested before the Calculated Attribute was created should be included in calculations.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-customerprofiles-calculatedattributedefinition.html
         :exampleMetadata: fixture=_generated
@@ -1165,7 +1165,7 @@ class CfnCalculatedAttributeDefinitionProps:
     def use_historical_data(
         self,
     ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-        '''Whether to use historical data for the calculated attribute.
+        '''Whether historical data ingested before the Calculated Attribute was created should be included in calculations.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-customerprofiles-calculatedattributedefinition.html#cfn-customerprofiles-calculatedattributedefinition-usehistoricaldata
         '''
@@ -6392,7 +6392,7 @@ class CfnObjectType(
         :param expiration_days: The number of days until the data of this type expires.
         :param fields: A list of field definitions for the object type mapping.
         :param keys: A list of keys that can be used to map data to the profile or search for the profile.
-        :param max_profile_object_count: The maximum number of profile objects for this object type.
+        :param max_profile_object_count: The amount of profile object max count assigned to the object type.
         :param source_last_updated_timestamp_format: The format of your sourceLastUpdatedTimestamp that was previously set up.
         :param tags: The tags used to organize, track, or control access for this resource.
         :param template_id: A unique identifier for the template mapping. This can be used instead of specifying the Keys and Fields properties directly.
@@ -6469,7 +6469,7 @@ class CfnObjectType(
     @builtins.property
     @jsii.member(jsii_name="attrMaxAvailableProfileObjectCount")
     def attr_max_available_profile_object_count(self) -> jsii.Number:
-        '''The maximum available number of profile objects.
+        '''The amount of provisioned profile object max count available.
 
         :cloudformationAttribute: MaxAvailableProfileObjectCount
         '''
@@ -6608,7 +6608,7 @@ class CfnObjectType(
     @builtins.property
     @jsii.member(jsii_name="maxProfileObjectCount")
     def max_profile_object_count(self) -> typing.Optional[jsii.Number]:
-        '''The maximum number of profile objects for this object type.'''
+        '''The amount of profile object max count assigned to the object type.'''
         return typing.cast(typing.Optional[jsii.Number], jsii.get(self, "maxProfileObjectCount"))
 
     @max_profile_object_count.setter
@@ -7029,7 +7029,7 @@ class CfnObjectTypeProps:
         :param expiration_days: The number of days until the data of this type expires.
         :param fields: A list of field definitions for the object type mapping.
         :param keys: A list of keys that can be used to map data to the profile or search for the profile.
-        :param max_profile_object_count: The maximum number of profile objects for this object type.
+        :param max_profile_object_count: The amount of profile object max count assigned to the object type.
         :param source_last_updated_timestamp_format: The format of your sourceLastUpdatedTimestamp that was previously set up.
         :param tags: The tags used to organize, track, or control access for this resource.
         :param template_id: A unique identifier for the template mapping. This can be used instead of specifying the Keys and Fields properties directly.
@@ -7201,7 +7201,7 @@ class CfnObjectTypeProps:
 
     @builtins.property
     def max_profile_object_count(self) -> typing.Optional[jsii.Number]:
-        '''The maximum number of profile objects for this object type.
+        '''The amount of profile object max count assigned to the object type.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-customerprofiles-objecttype.html#cfn-customerprofiles-objecttype-maxprofileobjectcount
         '''