aws-cdk-lib 2.143.0__py3-none-any.whl → 2.144.0__py3-none-any.whl

aws_cdk/aws_rds/__init__.py

@@ -1323,14 +1323,14 @@ rds.DatabaseInstance(self, "Database",
 
 You cannot specify a parameter map and a parameter group at the same time.
 
-## Serverless
+## Serverless v1
 
-[Amazon Aurora Serverless](https://aws.amazon.com/rds/aurora/serverless/) is an on-demand, auto-scaling configuration for Amazon
+[Amazon Aurora Serverless v1](https://aws.amazon.com/rds/aurora/serverless/) is an on-demand, auto-scaling configuration for Amazon
 Aurora. The database will automatically start up, shut down, and scale capacity
 up or down based on your application's needs. It enables you to run your database
 in the cloud without managing any database instances.
 
-The following example initializes an Aurora Serverless PostgreSql cluster.
+The following example initializes an Aurora Serverless v1 PostgreSql cluster.
 Aurora Serverless clusters can specify scaling properties which will be used to
 automatically scale the database cluster seamlessly based on the workload.
 
@@ -1353,7 +1353,9 @@ cluster = rds.ServerlessCluster(self, "AnotherCluster",
 )
 ```
 
-Aurora Serverless Clusters do not support the following features:
+**Note**: The `rds.ServerlessCluster` class is for Aurora Serverless v1. If you want to use Aurora Serverless v2, use the `rds.DatabaseCluster` class.
+
+Aurora Serverless v1 Clusters do not support the following features:
 
 * Loading data from an Amazon S3 bucket
 * Saving data to an Amazon S3 bucket
@@ -1368,9 +1370,9 @@ Aurora Serverless Clusters do not support the following features:
 * Performance Insights
 * RDS Proxy
 
-Read more about the [limitations of Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations)
+Read more about the [limitations of Aurora Serverless v1](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations)
 
-Learn more about using Amazon Aurora Serverless by reading the [documentation](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html)
+Learn more about using Amazon Aurora Serverless v1 by reading the [documentation](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html)
 
 Use `ServerlessClusterFromSnapshot` to create a serverless cluster from a snapshot:
 
@@ -1384,7 +1386,7 @@ rds.ServerlessClusterFromSnapshot(self, "Cluster",
 )
 ```
 
-### Data API
+## Data API
 
 You can access your Aurora DB cluster using the built-in Data API. The Data API doesn't require a persistent connection to the DB cluster. Instead, it provides a secure HTTP endpoint and integration with AWS SDKs.
 
@@ -1416,7 +1418,7 @@ cluster.grant_data_api_access(fn)
 
 To learn more about using the Data API, see the [documentation](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html).
 
-### Default VPC
+## Default VPC
 
 The `vpc` parameter is optional.
 
@@ -1424,7 +1426,7 @@ If not provided, the cluster will be created in the default VPC of the account a
 As this VPC is not deployed with AWS CDK, you can't configure the `vpcSubnets`, `subnetGroup` or `securityGroups` of the Aurora Serverless Cluster.
 If you want to provide one of `vpcSubnets`, `subnetGroup` or `securityGroups` parameter, please provide a `vpc`.
 
-### Preferred Maintenance Window
+## Preferred Maintenance Window
 
 When creating an RDS cluster, it is possible to (optionally) specify a preferred maintenance window for the cluster as well as the instances under the cluster.
 See [AWS docs](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance) for more information regarding maintenance windows.
@@ -2542,6 +2544,12 @@ class AuroraMysqlEngineVersion(
         '''Version "8.0.mysql_aurora.3.04.1".'''
         return typing.cast("AuroraMysqlEngineVersion", jsii.sget(cls, "VER_3_04_1"))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="VER_3_04_2")
+    def VER_3_04_2(cls) -> "AuroraMysqlEngineVersion":
+        '''Version "8.0.mysql_aurora.3.04.2".'''
+        return typing.cast("AuroraMysqlEngineVersion", jsii.sget(cls, "VER_3_04_2"))
+
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_3_05_0")
     def VER_3_05_0(cls) -> "AuroraMysqlEngineVersion":
@@ -34207,7 +34215,7 @@ class ServerlessCluster(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_rds.ServerlessCluster",
 ):
-    '''Create an Aurora Serverless Cluster.
+    '''Create an Aurora Serverless v1 Cluster.
 
     :resource: AWS::RDS::DBCluster
     :exampleMetadata: infused
@@ -34313,7 +34321,7 @@ class ServerlessCluster(
         :param security_groups: Security group. Default: - a new security group is created if ``vpc`` was provided. If the ``vpc`` property was not provided, no VPC security groups will be associated with the DB cluster.
         :param storage_encryption_key: The KMS key for storage encryption. Default: - the default master key will be used for storage encryption
         :param subnet_group: Existing subnet group for the cluster. Default: - a new subnet group is created if ``vpc`` was provided. If the ``vpc`` property was not provided, no subnet group will be associated with the DB cluster
-        :param vpc: The VPC that this Aurora Serverless cluster has been created in. Default: - the default VPC in the account and region will be used
+        :param vpc: The VPC that this Aurora Serverless v1 Cluster has been created in. Default: - the default VPC in the account and region will be used
         :param vpc_subnets: Where to place the instances within the VPC. If provided, the ``vpc`` property must also be specified. Default: - the VPC default strategy if not specified.
         '''
         if __debug__:
@@ -34674,7 +34682,7 @@ class ServerlessClusterFromSnapshot(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_rds.ServerlessClusterFromSnapshot",
 ):
-    '''A Aurora Serverless Cluster restored from a snapshot.
+    '''A Aurora Serverless v1 Cluster restored from a snapshot.
 
     :resource: AWS::RDS::DBCluster
     :exampleMetadata: infused
@@ -34729,7 +34737,7 @@ class ServerlessClusterFromSnapshot(
         :param scaling: Scaling configuration of an Aurora Serverless database cluster. Default: - Serverless cluster is automatically paused after 5 minutes of being idle. minimum capacity: 2 ACU maximum capacity: 16 ACU
         :param security_groups: Security group. Default: - a new security group is created if ``vpc`` was provided. If the ``vpc`` property was not provided, no VPC security groups will be associated with the DB cluster.
         :param subnet_group: Existing subnet group for the cluster. Default: - a new subnet group is created if ``vpc`` was provided. If the ``vpc`` property was not provided, no subnet group will be associated with the DB cluster
-        :param vpc: The VPC that this Aurora Serverless cluster has been created in. Default: - the default VPC in the account and region will be used
+        :param vpc: The VPC that this Aurora Serverless v1 Cluster has been created in. Default: - the default VPC in the account and region will be used
         :param vpc_subnets: Where to place the instances within the VPC. If provided, the ``vpc`` property must also be specified. Default: - the VPC default strategy if not specified.
         '''
         if __debug__:
@@ -34891,7 +34899,7 @@ class ServerlessClusterFromSnapshotProps:
         :param scaling: Scaling configuration of an Aurora Serverless database cluster. Default: - Serverless cluster is automatically paused after 5 minutes of being idle. minimum capacity: 2 ACU maximum capacity: 16 ACU
         :param security_groups: Security group. Default: - a new security group is created if ``vpc`` was provided. If the ``vpc`` property was not provided, no VPC security groups will be associated with the DB cluster.
         :param subnet_group: Existing subnet group for the cluster. Default: - a new subnet group is created if ``vpc`` was provided. If the ``vpc`` property was not provided, no subnet group will be associated with the DB cluster
-        :param vpc: The VPC that this Aurora Serverless cluster has been created in. Default: - the default VPC in the account and region will be used
+        :param vpc: The VPC that this Aurora Serverless v1 Cluster has been created in. Default: - the default VPC in the account and region will be used
         :param vpc_subnets: Where to place the instances within the VPC. If provided, the ``vpc`` property must also be specified. Default: - the VPC default strategy if not specified.
 
         :exampleMetadata: infused
@@ -35107,7 +35115,7 @@ class ServerlessClusterFromSnapshotProps:
 
     @builtins.property
     def vpc(self) -> typing.Optional[_IVpc_f30d5663]:
-        '''The VPC that this Aurora Serverless cluster has been created in.
+        '''The VPC that this Aurora Serverless v1 Cluster has been created in.
 
         :default: - the default VPC in the account and region will be used
         '''
@@ -35180,7 +35188,7 @@ class ServerlessClusterProps:
         vpc: typing.Optional[_IVpc_f30d5663] = None,
         vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
-        '''Properties for a new Aurora Serverless Cluster.
+        '''Properties for a new Aurora Serverless v1 Cluster.
 
         :param engine: What kind of database to start.
         :param backup_retention: The number of days during which automatic DB snapshots are retained. Automatic backup retention cannot be disabled on serverless clusters. Must be a value from 1 day to 35 days. Default: Duration.days(1)
@@ -35196,7 +35204,7 @@ class ServerlessClusterProps:
         :param security_groups: Security group. Default: - a new security group is created if ``vpc`` was provided. If the ``vpc`` property was not provided, no VPC security groups will be associated with the DB cluster.
         :param storage_encryption_key: The KMS key for storage encryption. Default: - the default master key will be used for storage encryption
         :param subnet_group: Existing subnet group for the cluster. Default: - a new subnet group is created if ``vpc`` was provided. If the ``vpc`` property was not provided, no subnet group will be associated with the DB cluster
-        :param vpc: The VPC that this Aurora Serverless cluster has been created in. Default: - the default VPC in the account and region will be used
+        :param vpc: The VPC that this Aurora Serverless v1 Cluster has been created in. Default: - the default VPC in the account and region will be used
         :param vpc_subnets: Where to place the instances within the VPC. If provided, the ``vpc`` property must also be specified. Default: - the VPC default strategy if not specified.
 
         :exampleMetadata: infused
@@ -35459,7 +35467,7 @@ class ServerlessClusterProps:
 
     @builtins.property
     def vpc(self) -> typing.Optional[_IVpc_f30d5663]:
-        '''The VPC that this Aurora Serverless cluster has been created in.
+        '''The VPC that this Aurora Serverless v1 Cluster has been created in.
 
         :default: - the default VPC in the account and region will be used
         '''
@@ -35510,7 +35518,7 @@ class ServerlessScalingOptions:
         timeout: typing.Optional[_Duration_4839e8c3] = None,
         timeout_action: typing.Optional["TimeoutAction"] = None,
     ) -> None:
-        '''Options for configuring scaling on an Aurora Serverless cluster.
+        '''Options for configuring scaling on an Aurora Serverless v1 Cluster.
 
         :param auto_pause: The time before an Aurora Serverless database cluster is paused. A database cluster can be paused only when it is idle (it has no connections). Auto pause time must be between 5 minutes and 1 day. If a DB cluster is paused for more than seven days, the DB cluster might be backed up with a snapshot. In this case, the DB cluster is restored when there is a request to connect to it. Set to 0 to disable Default: - automatic pause enabled after 5 minutes
         :param max_capacity: The maximum capacity for an Aurora Serverless database cluster. Default: - determined by Aurora based on database engine

aws_cdk/aws_s3/__init__.py

@@ -363,6 +363,27 @@ bucket = s3.Bucket(self, "MyBlockedBucket",
 
 When `blockPublicPolicy` is set to `true`, `grantPublicRead()` throws an error.
 
+## Public Read Access
+
+Use `publicReadAccess` to allow public read access to the bucket.
+
+Note that to enable `publicReadAccess`, make sure both bucket-level and account-level block public access control is disabled.
+
+Bucket-level block public access control can be configured through `blockPublicAccess` property. Account-level block public
+access control can be configured on AWS Console -> S3 -> Block Public Access settings for this account (Navigation Panel).
+
+```python
+bucket = s3.Bucket(self, "Bucket",
+    public_read_access=True,
+    block_public_access={
+        "block_public_policy": False,
+        "block_public_acls": False,
+        "ignore_public_acls": False,
+        "restrict_public_buckets": False
+    }
+)
+```
+
 ## Logging configuration
 
 Use `serverAccessLogsBucket` to describe where server access logs are to be stored.

aws_cdk/aws_s3_deployment/__init__.py

@@ -499,8 +499,9 @@ cdk.CfnOutput(self, "ObjectKey",
 ## Development
 
 The custom resource is implemented in Python 3.9 in order to be able to leverage
-the AWS CLI for "aws s3 sync". The code is under [`lib/lambda`](https://github.com/aws/aws-cdk/tree/main/packages/aws-cdk-lib/aws-s3-deployment/lib/lambda) and
-unit tests are under [`test/lambda`](https://github.com/aws/aws-cdk/tree/main/packages/aws-cdk-lib/aws-s3-deployment/test/lambda).
+the AWS CLI for "aws s3 sync".
+The code is now in the `@aws-cdk/custom-resource-handlers` package under [`lib/aws-s3-deployment/bucket-deployment-handler`](https://github.com/aws/aws-cdk/tree/main/packages/@aws-cdk/custom-resource-handlers/lib/aws-s3-deployment/bucket-deployment-handler/) and
+unit tests are under [`test/aws-s3-deployment/bucket-deployment-handler`](https://github.com/aws/aws-cdk/tree/main/packages/@aws-cdk/custom-resource-handlers/test/aws-s3-deployment/bucket-deployment-handler/).
 
 This package requires Python 3.9 during build time in order to create the custom
 resource Lambda bundle and test it. It also relies on a few bash scripts, so

aws_cdk/aws_stepfunctions/__init__.py

@@ -477,6 +477,16 @@ fail = sfn.Fail(self, "Fail",
 )
 ```
 
+You can also use an intrinsic function that returns a string to specify CausePath and ErrorPath.
+The available functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID.
+
+```python
+fail = sfn.Fail(self, "Fail",
+    error_path=sfn.JsonPath.format("error: {}.", sfn.JsonPath.string_at("$.someError")),
+    cause_path="States.Format('cause: {}.', $.someCause)"
+)
+```
+
 ### Map
 
 A `Map` state can be used to run a set of steps for each element of an input array.
@@ -5043,10 +5053,10 @@ class FailProps:
         '''Properties for defining a Fail state.
 
         :param cause: A description for the cause of the failure. Default: - No description
-        :param cause_path: JsonPath expression to select part of the state to be the cause to this state. Default: - No cause path
+        :param cause_path: JsonPath expression to select part of the state to be the cause to this state. You can also use an intrinsic function that returns a string to specify this property. The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID. Default: - No cause path
         :param comment: An optional description for this state. Default: - No comment
         :param error: Error code used to represent this failure. Default: - No error code
-        :param error_path: JsonPath expression to select part of the state to be the error to this state. Default: - No error path
+        :param error_path: JsonPath expression to select part of the state to be the error to this state. You can also use an intrinsic function that returns a string to specify this property. The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID. Default: - No error path
         :param state_name: Optional name for this state. Default: - The construct ID will be used as state name
 
         :exampleMetadata: infused
@@ -5054,8 +5064,8 @@ class FailProps:
         Example::
 
             fail = sfn.Fail(self, "Fail",
-                error_path=sfn.JsonPath.string_at("$.someError"),
-                cause_path=sfn.JsonPath.string_at("$.someCause")
+                error_path=sfn.JsonPath.format("error: {}.", sfn.JsonPath.string_at("$.someError")),
+                cause_path="States.Format('cause: {}.', $.someCause)"
             )
         '''
         if __debug__:
@@ -5093,6 +5103,9 @@ class FailProps:
     def cause_path(self) -> typing.Optional[builtins.str]:
         '''JsonPath expression to select part of the state to be the cause to this state.
 
+        You can also use an intrinsic function that returns a string to specify this property.
+        The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID.
+
         :default: - No cause path
         '''
         result = self._values.get("cause_path")
@@ -5120,6 +5133,9 @@ class FailProps:
     def error_path(self) -> typing.Optional[builtins.str]:
         '''JsonPath expression to select part of the state to be the error to this state.
 
+        You can also use an intrinsic function that returns a string to specify this property.
+        The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID.
+
         :default: - No error path
         '''
         result = self._values.get("error_path")
@@ -6318,25 +6334,33 @@ class IntegrationPattern(enum.Enum):
 
     Example::
 
-        # Define a state machine with one Pass state
-        child = sfn.StateMachine(self, "ChildStateMachine",
-            definition=sfn.Chain.start(sfn.Pass(self, "PassState"))
-        )
+        import aws_cdk.aws_codebuild as codebuild
         
-        # Include the state machine in a Task state with callback pattern
-        task = tasks.StepFunctionsStartExecution(self, "ChildTask",
-            state_machine=child,
-            integration_pattern=sfn.IntegrationPattern.WAIT_FOR_TASK_TOKEN,
-            input=sfn.TaskInput.from_object({
-                "token": sfn.JsonPath.task_token,
-                "foo": "bar"
-            }),
-            name="MyExecutionName"
+        
+        project = codebuild.Project(self, "Project",
+            project_name="MyTestProject",
+            build_spec=codebuild.BuildSpec.from_object_to_yaml({
+                "version": 0.2,
+                "batch": {
+                    "build-list": [{
+                        "identifier": "id",
+                        "buildspec": "version: 0.2\nphases:\n  build:\n    commands:\n      - echo \"Hello, from small!\""
+                    }
+                    ]
+                }
+            })
         )
+        project.enable_batch_builds()
         
-        # Define a second state machine with the Task state above
-        sfn.StateMachine(self, "ParentStateMachine",
-            definition=task
+        task = tasks.CodeBuildStartBuildBatch(self, "buildBatchTask",
+            project=project,
+            integration_pattern=sfn.IntegrationPattern.REQUEST_RESPONSE,
+            environment_variables_override={
+                "test": codebuild.BuildEnvironmentVariable(
+                    type=codebuild.BuildEnvironmentVariableType.PLAINTEXT,
+                    value="testValue"
+                )
+            }
         )
     '''
 
@@ -14559,8 +14583,8 @@ class Fail(
     Example::
 
         fail = sfn.Fail(self, "Fail",
-            error_path=sfn.JsonPath.string_at("$.someError"),
-            cause_path=sfn.JsonPath.string_at("$.someCause")
+            error_path=sfn.JsonPath.format("error: {}.", sfn.JsonPath.string_at("$.someError")),
+            cause_path="States.Format('cause: {}.', $.someCause)"
         )
     '''
 
@@ -14580,10 +14604,10 @@ class Fail(
         :param scope: -
         :param id: Descriptive identifier for this chainable.
         :param cause: A description for the cause of the failure. Default: - No description
-        :param cause_path: JsonPath expression to select part of the state to be the cause to this state. Default: - No cause path
+        :param cause_path: JsonPath expression to select part of the state to be the cause to this state. You can also use an intrinsic function that returns a string to specify this property. The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID. Default: - No cause path
         :param comment: An optional description for this state. Default: - No comment
         :param error: Error code used to represent this failure. Default: - No error code
-        :param error_path: JsonPath expression to select part of the state to be the error to this state. Default: - No error path
+        :param error_path: JsonPath expression to select part of the state to be the error to this state. You can also use an intrinsic function that returns a string to specify this property. The allowed functions include States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash, and States.UUID. Default: - No error path
         :param state_name: Optional name for this state. Default: - The construct ID will be used as state name
         '''
         if __debug__:
@@ -14606,6 +14630,11 @@ class Fail(
         '''Return the Amazon States Language object for this state.'''
         return typing.cast(typing.Mapping[typing.Any, typing.Any], jsii.invoke(self, "toStateJson", []))
 
+    @jsii.member(jsii_name="validateState")
+    def _validate_state(self) -> typing.List[builtins.str]:
+        '''Validate this state.'''
+        return typing.cast(typing.List[builtins.str], jsii.invoke(self, "validateState", []))
+
     @builtins.property
     @jsii.member(jsii_name="endStates")
     def end_states(self) -> typing.List[INextable]: