aws-cdk-lib 2.216.0__py3-none-any.whl → 2.218.0__py3-none-any.whl

aws_cdk/aws_directoryservice/__init__.py

@@ -1026,6 +1026,27 @@ class CfnSimpleAD(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @jsii.member(jsii_name="fromDirectoryId")
+    @builtins.classmethod
+    def from_directory_id(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        directory_id: builtins.str,
+    ) -> ISimpleADRef:
+        '''Creates a new ISimpleADRef from a directoryId.
+
+        :param scope: -
+        :param id: -
+        :param directory_id: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__4edb8188cf1a787819f9e08e002165b6e7e58550d088f80151ce91f3ee2ad4f0)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument directory_id", value=directory_id, expected_type=type_hints["directory_id"])
+        return typing.cast(ISimpleADRef, jsii.sinvoke(cls, "fromDirectoryId", [scope, id, directory_id]))
+
     @jsii.member(jsii_name="inspect")
     def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
         '''Examines the CloudFormation resource and discloses attributes.
@@ -1446,6 +1467,14 @@ def _typecheckingstub__40820ee1ed03f2cd4befa65e6404c1024999677e0624ca5450f4b1f92
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__4edb8188cf1a787819f9e08e002165b6e7e58550d088f80151ce91f3ee2ad4f0(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    directory_id: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__adbd82c9a36437463cde56b3a4ad4d5c5c16f2073416fd9e1873351e5eb928b2(
     inspector: _TreeInspector_488e0dd5,
 ) -> None:

aws_cdk/aws_dms/__init__.py

@@ -4239,6 +4239,27 @@ class CfnCertificate(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @jsii.member(jsii_name="fromCertificateId")
+    @builtins.classmethod
+    def from_certificate_id(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        certificate_id: builtins.str,
+    ) -> ICertificateRef:
+        '''Creates a new ICertificateRef from a certificateId.
+
+        :param scope: -
+        :param id: -
+        :param certificate_id: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__54c58e4c61ec8f4fec86aeebbf242c64f4df21097435a1de2fa86d057deacae4)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument certificate_id", value=certificate_id, expected_type=type_hints["certificate_id"])
+        return typing.cast(ICertificateRef, jsii.sinvoke(cls, "fromCertificateId", [scope, id, certificate_id]))
+
     @jsii.member(jsii_name="inspect")
     def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
         '''Examines the CloudFormation resource and discloses attributes.
@@ -7166,6 +7187,27 @@ class CfnEndpoint(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @jsii.member(jsii_name="fromEndpointId")
+    @builtins.classmethod
+    def from_endpoint_id(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        endpoint_id: builtins.str,
+    ) -> IEndpointRef:
+        '''Creates a new IEndpointRef from a endpointId.
+
+        :param scope: -
+        :param id: -
+        :param endpoint_id: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__cc7544659847cebf1010859beefe92e136eed06aeede14a54bb30e07bc5741a0)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument endpoint_id", value=endpoint_id, expected_type=type_hints["endpoint_id"])
+        return typing.cast(IEndpointRef, jsii.sinvoke(cls, "fromEndpointId", [scope, id, endpoint_id]))
+
     @jsii.member(jsii_name="inspect")
     def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
         '''Examines the CloudFormation resource and discloses attributes.
@@ -15725,6 +15767,14 @@ def _typecheckingstub__f7c4a44b8a3c02f3f6ada86310479fa26dc0b32d4fba95316eb3faa44
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__54c58e4c61ec8f4fec86aeebbf242c64f4df21097435a1de2fa86d057deacae4(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    certificate_id: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__ec185f31d9affa5fa834d99f40ff8a27fcf34f84f01e6395782727e60768851f(
     inspector: _TreeInspector_488e0dd5,
 ) -> None:
@@ -16088,6 +16138,14 @@ def _typecheckingstub__738d71cd2300575c2c6537801f3dede195e2179cefcdceb9d0410340f
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__cc7544659847cebf1010859beefe92e136eed06aeede14a54bb30e07bc5741a0(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    endpoint_id: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__f057bd27ac6280cd130ed12f9511a5cdfb108a079b1bda778b1eafc415ee366d(
     inspector: _TreeInspector_488e0dd5,
 ) -> None:

aws_cdk/aws_docdb/__init__.py

@@ -29,6 +29,29 @@ By default, the master password will be generated and stored in AWS Secrets Mana
 
 Your cluster will be empty by default.
 
+## Serverless Clusters
+
+DocumentDB supports serverless clusters that automatically scale capacity based on your application's needs.
+To create a serverless cluster, specify the `serverlessV2ScalingConfiguration` instead of `instanceType`:
+
+```python
+# vpc: ec2.Vpc
+
+cluster = docdb.DatabaseCluster(self, "Database",
+    master_user=docdb.Login(
+        username="myuser"
+    ),
+    vpc=vpc,
+    serverless_v2_scaling_configuration=docdb.ServerlessV2ScalingConfiguration(
+        min_capacity=0.5,
+        max_capacity=2
+    ),
+    engine_version="5.0.0"
+)
+```
+
+**Note**: DocumentDB serverless requires engine version 5.0.0 or higher and is not compatible with all features. See the [AWS documentation](https://docs.aws.amazon.com/documentdb/latest/developerguide/docdb-serverless-limitations.html) for limitations.
+
 ## Connecting
 
 To control who can access the cluster, use the `.connections` attribute. DocumentDB databases have a default port, so
@@ -303,6 +326,8 @@ cluster = docdb.DatabaseCluster(self, "Database",
 ```
 
 **Note**: `StorageType.IOPT1` is supported starting with engine version 5.0.0.
+
+**Note**: For serverless clusters, storage type is managed automatically and cannot be specified.
 '''
 from pkgutil import extend_path
 __path__ = extend_path(__path__, __name__)
@@ -2327,7 +2352,6 @@ class DatabaseClusterAttributes:
     jsii_type="aws-cdk-lib.aws_docdb.DatabaseClusterProps",
     jsii_struct_bases=[],
     name_mapping={
-        "instance_type": "instanceType",
         "master_user": "masterUser",
         "vpc": "vpc",
         "backup": "backup",
@@ -2344,6 +2368,7 @@ class DatabaseClusterAttributes:
         "instance_identifier_base": "instanceIdentifierBase",
         "instance_removal_policy": "instanceRemovalPolicy",
         "instances": "instances",
+        "instance_type": "instanceType",
         "kms_key": "kmsKey",
         "parameter_group": "parameterGroup",
         "port": "port",
@@ -2351,6 +2376,7 @@ class DatabaseClusterAttributes:
         "removal_policy": "removalPolicy",
         "security_group": "securityGroup",
         "security_group_removal_policy": "securityGroupRemovalPolicy",
+        "serverless_v2_scaling_configuration": "serverlessV2ScalingConfiguration",
         "storage_encrypted": "storageEncrypted",
         "storage_type": "storageType",
         "vpc_subnets": "vpcSubnets",
@@ -2360,7 +2386,6 @@ class DatabaseClusterProps:
     def __init__(
         self,
         *,
-        instance_type: _InstanceType_f64915b9,
         master_user: typing.Union["Login", typing.Dict[builtins.str, typing.Any]],
         vpc: _IVpc_f30d5663,
         backup: typing.Optional[typing.Union[BackupProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -2377,6 +2402,7 @@ class DatabaseClusterProps:
         instance_identifier_base: typing.Optional[builtins.str] = None,
         instance_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
         instances: typing.Optional[jsii.Number] = None,
+        instance_type: typing.Optional[_InstanceType_f64915b9] = None,
         kms_key: typing.Optional[_IKey_5f11635f] = None,
         parameter_group: typing.Optional["IClusterParameterGroup"] = None,
         port: typing.Optional[jsii.Number] = None,
@@ -2384,13 +2410,13 @@ class DatabaseClusterProps:
         removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
         security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
         security_group_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
+        serverless_v2_scaling_configuration: typing.Optional[typing.Union["ServerlessV2ScalingConfiguration", typing.Dict[builtins.str, typing.Any]]] = None,
         storage_encrypted: typing.Optional[builtins.bool] = None,
         storage_type: typing.Optional["StorageType"] = None,
         vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''Properties for a new database cluster.
 
-        :param instance_type: What type of instance to start for the replicas.
         :param master_user: Username and password for the administrative user.
         :param vpc: What subnets to run the DocumentDB instances in. Must be at least 2 subnets in two different AZs.
         :param backup: Backup settings. Default: - Backup retention period for automated backups is 1 day. Backup preferred window is set to a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.
@@ -2404,9 +2430,10 @@ class DatabaseClusterProps:
         :param engine_version: What version of the database to start. Default: - the latest major version
         :param export_audit_logs_to_cloud_watch: Whether the audit logs should be exported to CloudWatch. Note that you also have to configure the audit log export in the Cluster's Parameter Group. Default: false
         :param export_profiler_logs_to_cloud_watch: Whether the profiler logs should be exported to CloudWatch. Note that you also have to configure the profiler log export in the Cluster's Parameter Group. Default: false
-        :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Default: - ``dbClusterName`` is used with the word "Instance" appended. If ``dbClusterName`` is not provided, the identifier is automatically generated.
+        :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Only applicable for provisioned clusters. Default: - ``dbClusterName`` is used with the word "Instance" appended. If ``dbClusterName`` is not provided, the identifier is automatically generated.
         :param instance_removal_policy: The removal policy to apply to the cluster's instances. Cannot be set to ``SNAPSHOT``. Default: - ``RemovalPolicy.DESTROY`` when ``removalPolicy`` is set to ``SNAPSHOT``, ``removalPolicy`` otherwise.
         :param instances: Number of DocDB compute instances. Default: 1
+        :param instance_type: What type of instance to start for the replicas. Required for provisioned clusters, not applicable for serverless clusters. Default: None
         :param kms_key: The KMS key for storage encryption. Default: - default master key.
         :param parameter_group: The DB parameter group to associate with the instance. Default: no parameter group
         :param port: The port the DocumentDB cluster will listen on. Default: DatabaseCluster.DEFAULT_PORT
@@ -2414,6 +2441,7 @@ class DatabaseClusterProps:
         :param removal_policy: The removal policy to apply when the cluster and its instances are removed or replaced during a stack update, or when the stack is deleted. This removal policy also applies to the implicit security group created for the cluster if one is not supplied as a parameter. When set to ``SNAPSHOT``, the removal policy for the instances and the security group will default to ``DESTROY`` as those resources do not support the policy. Use the ``instanceRemovalPolicy`` and ``securityGroupRemovalPolicy`` to change the behavior. Default: - Retain cluster.
         :param security_group: Security group. Default: a new security group is created.
         :param security_group_removal_policy: The removal policy to apply to the cluster's security group. Cannot be set to ``SNAPSHOT``. Default: - ``RemovalPolicy.DESTROY`` when ``removalPolicy`` is set to ``SNAPSHOT``, ``removalPolicy`` otherwise.
+        :param serverless_v2_scaling_configuration: ServerlessV2 scaling configuration. When specified, the cluster will be created as a serverless cluster. Default: None
         :param storage_encrypted: Whether to enable storage encryption. Default: true
         :param storage_type: The storage type of the DocDB cluster. I/O-optimized storage is supported starting with engine version 5.0.0. Default: StorageType.STANDARD
         :param vpc_subnets: Where to place the instances within the VPC. Default: private subnets
@@ -2424,7 +2452,6 @@ class DatabaseClusterProps:
 
             # vpc: ec2.Vpc
             
-            
             cluster = docdb.DatabaseCluster(self, "Database",
                 master_user=docdb.Login(
                     username="myuser"
@@ -2434,18 +2461,19 @@ class DatabaseClusterProps:
                     subnet_type=ec2.SubnetType.PUBLIC
                 ),
                 vpc=vpc,
-                removal_policy=RemovalPolicy.SNAPSHOT
+                deletion_protection=True
             )
         '''
         if isinstance(master_user, dict):
             master_user = Login(**master_user)
         if isinstance(backup, dict):
             backup = BackupProps(**backup)
+        if isinstance(serverless_v2_scaling_configuration, dict):
+            serverless_v2_scaling_configuration = ServerlessV2ScalingConfiguration(**serverless_v2_scaling_configuration)
         if isinstance(vpc_subnets, dict):
             vpc_subnets = _SubnetSelection_e57d76df(**vpc_subnets)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__bb24ec128a97ca07df15f55d4e96dda851d4300951806a7a3d7f391cc4e83218)
-            check_type(argname="argument instance_type", value=instance_type, expected_type=type_hints["instance_type"])
             check_type(argname="argument master_user", value=master_user, expected_type=type_hints["master_user"])
             check_type(argname="argument vpc", value=vpc, expected_type=type_hints["vpc"])
             check_type(argname="argument backup", value=backup, expected_type=type_hints["backup"])
@@ -2462,6 +2490,7 @@ class DatabaseClusterProps:
             check_type(argname="argument instance_identifier_base", value=instance_identifier_base, expected_type=type_hints["instance_identifier_base"])
             check_type(argname="argument instance_removal_policy", value=instance_removal_policy, expected_type=type_hints["instance_removal_policy"])
             check_type(argname="argument instances", value=instances, expected_type=type_hints["instances"])
+            check_type(argname="argument instance_type", value=instance_type, expected_type=type_hints["instance_type"])
             check_type(argname="argument kms_key", value=kms_key, expected_type=type_hints["kms_key"])
             check_type(argname="argument parameter_group", value=parameter_group, expected_type=type_hints["parameter_group"])
             check_type(argname="argument port", value=port, expected_type=type_hints["port"])
@@ -2469,11 +2498,11 @@ class DatabaseClusterProps:
             check_type(argname="argument removal_policy", value=removal_policy, expected_type=type_hints["removal_policy"])
             check_type(argname="argument security_group", value=security_group, expected_type=type_hints["security_group"])
             check_type(argname="argument security_group_removal_policy", value=security_group_removal_policy, expected_type=type_hints["security_group_removal_policy"])
+            check_type(argname="argument serverless_v2_scaling_configuration", value=serverless_v2_scaling_configuration, expected_type=type_hints["serverless_v2_scaling_configuration"])
             check_type(argname="argument storage_encrypted", value=storage_encrypted, expected_type=type_hints["storage_encrypted"])
             check_type(argname="argument storage_type", value=storage_type, expected_type=type_hints["storage_type"])
             check_type(argname="argument vpc_subnets", value=vpc_subnets, expected_type=type_hints["vpc_subnets"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
-            "instance_type": instance_type,
             "master_user": master_user,
             "vpc": vpc,
         }
@@ -2505,6 +2534,8 @@ class DatabaseClusterProps:
             self._values["instance_removal_policy"] = instance_removal_policy
         if instances is not None:
             self._values["instances"] = instances
+        if instance_type is not None:
+            self._values["instance_type"] = instance_type
         if kms_key is not None:
             self._values["kms_key"] = kms_key
         if parameter_group is not None:
@@ -2519,6 +2550,8 @@ class DatabaseClusterProps:
             self._values["security_group"] = security_group
         if security_group_removal_policy is not None:
             self._values["security_group_removal_policy"] = security_group_removal_policy
+        if serverless_v2_scaling_configuration is not None:
+            self._values["serverless_v2_scaling_configuration"] = serverless_v2_scaling_configuration
         if storage_encrypted is not None:
             self._values["storage_encrypted"] = storage_encrypted
         if storage_type is not None:
@@ -2526,13 +2559,6 @@ class DatabaseClusterProps:
         if vpc_subnets is not None:
             self._values["vpc_subnets"] = vpc_subnets
 
-    @builtins.property
-    def instance_type(self) -> _InstanceType_f64915b9:
-        '''What type of instance to start for the replicas.'''
-        result = self._values.get("instance_type")
-        assert result is not None, "Required property 'instance_type' is missing"
-        return typing.cast(_InstanceType_f64915b9, result)
-
     @builtins.property
     def master_user(self) -> "Login":
         '''Username and password for the administrative user.'''
@@ -2681,6 +2707,7 @@ class DatabaseClusterProps:
         '''Base identifier for instances.
 
         Every replica is named by appending the replica number to this string, 1-based.
+        Only applicable for provisioned clusters.
 
         :default:
 
@@ -2712,6 +2739,17 @@ class DatabaseClusterProps:
         result = self._values.get("instances")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def instance_type(self) -> typing.Optional[_InstanceType_f64915b9]:
+        '''What type of instance to start for the replicas.
+
+        Required for provisioned clusters, not applicable for serverless clusters.
+
+        :default: None
+        '''
+        result = self._values.get("instance_type")
+        return typing.cast(typing.Optional[_InstanceType_f64915b9], result)
+
     @builtins.property
     def kms_key(self) -> typing.Optional[_IKey_5f11635f]:
         '''The KMS key for storage encryption.
@@ -2797,6 +2835,19 @@ class DatabaseClusterProps:
         result = self._values.get("security_group_removal_policy")
         return typing.cast(typing.Optional[_RemovalPolicy_9f93c814], result)
 
+    @builtins.property
+    def serverless_v2_scaling_configuration(
+        self,
+    ) -> typing.Optional["ServerlessV2ScalingConfiguration"]:
+        '''ServerlessV2 scaling configuration.
+
+        When specified, the cluster will be created as a serverless cluster.
+
+        :default: None
+        '''
+        result = self._values.get("serverless_v2_scaling_configuration")
+        return typing.cast(typing.Optional["ServerlessV2ScalingConfiguration"], result)
+
     @builtins.property
     def storage_encrypted(self) -> typing.Optional[builtins.bool]:
         '''Whether to enable storage encryption.
@@ -3883,7 +3934,6 @@ class Login:
 
             # vpc: ec2.Vpc
             
-            
             cluster = docdb.DatabaseCluster(self, "Database",
                 master_user=docdb.Login(
                     username="myuser"
@@ -3893,7 +3943,7 @@ class Login:
                     subnet_type=ec2.SubnetType.PUBLIC
                 ),
                 vpc=vpc,
-                removal_policy=RemovalPolicy.SNAPSHOT
+                deletion_protection=True
             )
         '''
         if __debug__:
@@ -4056,6 +4106,71 @@ class RotationMultiUserOptions:
         )
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_docdb.ServerlessV2ScalingConfiguration",
+    jsii_struct_bases=[],
+    name_mapping={"max_capacity": "maxCapacity", "min_capacity": "minCapacity"},
+)
+class ServerlessV2ScalingConfiguration:
+    def __init__(self, *, max_capacity: jsii.Number, min_capacity: jsii.Number) -> None:
+        '''ServerlessV2 scaling configuration for DocumentDB clusters.
+
+        :param max_capacity: The maximum number of DocumentDB capacity units (DCUs) for a DocumentDB instance in a DocumentDB Serverless cluster.
+        :param min_capacity: The minimum number of DocumentDB capacity units (DCUs) for a DocumentDB instance in a DocumentDB Serverless cluster.
+
+        :exampleMetadata: infused
+
+        Example::
+
+            # vpc: ec2.Vpc
+            
+            cluster = docdb.DatabaseCluster(self, "Database",
+                master_user=docdb.Login(
+                    username="myuser"
+                ),
+                vpc=vpc,
+                serverless_v2_scaling_configuration=docdb.ServerlessV2ScalingConfiguration(
+                    min_capacity=0.5,
+                    max_capacity=2
+                ),
+                engine_version="5.0.0"
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__db0de72551b166907369891918b0eccf227b067c44151aff0f889642ecea6a78)
+            check_type(argname="argument max_capacity", value=max_capacity, expected_type=type_hints["max_capacity"])
+            check_type(argname="argument min_capacity", value=min_capacity, expected_type=type_hints["min_capacity"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "max_capacity": max_capacity,
+            "min_capacity": min_capacity,
+        }
+
+    @builtins.property
+    def max_capacity(self) -> jsii.Number:
+        '''The maximum number of DocumentDB capacity units (DCUs) for a DocumentDB instance in a DocumentDB Serverless cluster.'''
+        result = self._values.get("max_capacity")
+        assert result is not None, "Required property 'max_capacity' is missing"
+        return typing.cast(jsii.Number, result)
+
+    @builtins.property
+    def min_capacity(self) -> jsii.Number:
+        '''The minimum number of DocumentDB capacity units (DCUs) for a DocumentDB instance in a DocumentDB Serverless cluster.'''
+        result = self._values.get("min_capacity")
+        assert result is not None, "Required property 'min_capacity' is missing"
+        return typing.cast(jsii.Number, 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 "ServerlessV2ScalingConfiguration(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.enum(jsii_type="aws-cdk-lib.aws_docdb.StorageType")
 class StorageType(enum.Enum):
     '''The storage type of the DocDB cluster.
@@ -5887,7 +6002,6 @@ class DatabaseCluster(
 
         # vpc: ec2.Vpc
         
-        
         cluster = docdb.DatabaseCluster(self, "Database",
             master_user=docdb.Login(
                 username="myuser"
@@ -5897,7 +6011,7 @@ class DatabaseCluster(
                 subnet_type=ec2.SubnetType.PUBLIC
             ),
             vpc=vpc,
-            removal_policy=RemovalPolicy.SNAPSHOT
+            deletion_protection=True
         )
     '''
 
@@ -5906,7 +6020,6 @@ class DatabaseCluster(
         scope: _constructs_77d1e7e8.Construct,
         id: builtins.str,
         *,
-        instance_type: _InstanceType_f64915b9,
         master_user: typing.Union[Login, typing.Dict[builtins.str, typing.Any]],
         vpc: _IVpc_f30d5663,
         backup: typing.Optional[typing.Union[BackupProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -5923,6 +6036,7 @@ class DatabaseCluster(
         instance_identifier_base: typing.Optional[builtins.str] = None,
         instance_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
         instances: typing.Optional[jsii.Number] = None,
+        instance_type: typing.Optional[_InstanceType_f64915b9] = None,
         kms_key: typing.Optional[_IKey_5f11635f] = None,
         parameter_group: typing.Optional[IClusterParameterGroup] = None,
         port: typing.Optional[jsii.Number] = None,
@@ -5930,6 +6044,7 @@ class DatabaseCluster(
         removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
         security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
         security_group_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
+        serverless_v2_scaling_configuration: typing.Optional[typing.Union[ServerlessV2ScalingConfiguration, typing.Dict[builtins.str, typing.Any]]] = None,
         storage_encrypted: typing.Optional[builtins.bool] = None,
         storage_type: typing.Optional[StorageType] = None,
         vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -5937,7 +6052,6 @@ class DatabaseCluster(
         '''
         :param scope: -
         :param id: -
-        :param instance_type: What type of instance to start for the replicas.
         :param master_user: Username and password for the administrative user.
         :param vpc: What subnets to run the DocumentDB instances in. Must be at least 2 subnets in two different AZs.
         :param backup: Backup settings. Default: - Backup retention period for automated backups is 1 day. Backup preferred window is set to a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.
@@ -5951,9 +6065,10 @@ class DatabaseCluster(
         :param engine_version: What version of the database to start. Default: - the latest major version
         :param export_audit_logs_to_cloud_watch: Whether the audit logs should be exported to CloudWatch. Note that you also have to configure the audit log export in the Cluster's Parameter Group. Default: false
         :param export_profiler_logs_to_cloud_watch: Whether the profiler logs should be exported to CloudWatch. Note that you also have to configure the profiler log export in the Cluster's Parameter Group. Default: false
-        :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Default: - ``dbClusterName`` is used with the word "Instance" appended. If ``dbClusterName`` is not provided, the identifier is automatically generated.
+        :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Only applicable for provisioned clusters. Default: - ``dbClusterName`` is used with the word "Instance" appended. If ``dbClusterName`` is not provided, the identifier is automatically generated.
         :param instance_removal_policy: The removal policy to apply to the cluster's instances. Cannot be set to ``SNAPSHOT``. Default: - ``RemovalPolicy.DESTROY`` when ``removalPolicy`` is set to ``SNAPSHOT``, ``removalPolicy`` otherwise.
         :param instances: Number of DocDB compute instances. Default: 1
+        :param instance_type: What type of instance to start for the replicas. Required for provisioned clusters, not applicable for serverless clusters. Default: None
         :param kms_key: The KMS key for storage encryption. Default: - default master key.
         :param parameter_group: The DB parameter group to associate with the instance. Default: no parameter group
         :param port: The port the DocumentDB cluster will listen on. Default: DatabaseCluster.DEFAULT_PORT
@@ -5961,6 +6076,7 @@ class DatabaseCluster(
         :param removal_policy: The removal policy to apply when the cluster and its instances are removed or replaced during a stack update, or when the stack is deleted. This removal policy also applies to the implicit security group created for the cluster if one is not supplied as a parameter. When set to ``SNAPSHOT``, the removal policy for the instances and the security group will default to ``DESTROY`` as those resources do not support the policy. Use the ``instanceRemovalPolicy`` and ``securityGroupRemovalPolicy`` to change the behavior. Default: - Retain cluster.
         :param security_group: Security group. Default: a new security group is created.
         :param security_group_removal_policy: The removal policy to apply to the cluster's security group. Cannot be set to ``SNAPSHOT``. Default: - ``RemovalPolicy.DESTROY`` when ``removalPolicy`` is set to ``SNAPSHOT``, ``removalPolicy`` otherwise.
+        :param serverless_v2_scaling_configuration: ServerlessV2 scaling configuration. When specified, the cluster will be created as a serverless cluster. Default: None
         :param storage_encrypted: Whether to enable storage encryption. Default: true
         :param storage_type: The storage type of the DocDB cluster. I/O-optimized storage is supported starting with engine version 5.0.0. Default: StorageType.STANDARD
         :param vpc_subnets: Where to place the instances within the VPC. Default: private subnets
@@ -5970,7 +6086,6 @@ class DatabaseCluster(
             check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         props = DatabaseClusterProps(
-            instance_type=instance_type,
             master_user=master_user,
             vpc=vpc,
             backup=backup,
@@ -5987,6 +6102,7 @@ class DatabaseCluster(
             instance_identifier_base=instance_identifier_base,
             instance_removal_policy=instance_removal_policy,
             instances=instances,
+            instance_type=instance_type,
             kms_key=kms_key,
             parameter_group=parameter_group,
             port=port,
@@ -5994,6 +6110,7 @@ class DatabaseCluster(
             removal_policy=removal_policy,
             security_group=security_group,
             security_group_removal_policy=security_group_removal_policy,
+            serverless_v2_scaling_configuration=serverless_v2_scaling_configuration,
             storage_encrypted=storage_encrypted,
             storage_type=storage_type,
             vpc_subnets=vpc_subnets,
@@ -6386,6 +6503,7 @@ __all__ = [
     "IEventSubscriptionRef",
     "Login",
     "RotationMultiUserOptions",
+    "ServerlessV2ScalingConfiguration",
     "StorageType",
 ]
 
@@ -6543,7 +6661,6 @@ def _typecheckingstub__d7aaa09fc3d83b3aef333d99a0eb22e9b6c412979a1f20e5f22628ebd
 
 def _typecheckingstub__bb24ec128a97ca07df15f55d4e96dda851d4300951806a7a3d7f391cc4e83218(
     *,
-    instance_type: _InstanceType_f64915b9,
     master_user: typing.Union[Login, typing.Dict[builtins.str, typing.Any]],
     vpc: _IVpc_f30d5663,
     backup: typing.Optional[typing.Union[BackupProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -6560,6 +6677,7 @@ def _typecheckingstub__bb24ec128a97ca07df15f55d4e96dda851d4300951806a7a3d7f391cc
     instance_identifier_base: typing.Optional[builtins.str] = None,
     instance_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
     instances: typing.Optional[jsii.Number] = None,
+    instance_type: typing.Optional[_InstanceType_f64915b9] = None,
     kms_key: typing.Optional[_IKey_5f11635f] = None,
     parameter_group: typing.Optional[IClusterParameterGroup] = None,
     port: typing.Optional[jsii.Number] = None,
@@ -6567,6 +6685,7 @@ def _typecheckingstub__bb24ec128a97ca07df15f55d4e96dda851d4300951806a7a3d7f391cc
     removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
     security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
     security_group_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
+    serverless_v2_scaling_configuration: typing.Optional[typing.Union[ServerlessV2ScalingConfiguration, typing.Dict[builtins.str, typing.Any]]] = None,
     storage_encrypted: typing.Optional[builtins.bool] = None,
     storage_type: typing.Optional[StorageType] = None,
     vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -6655,6 +6774,14 @@ def _typecheckingstub__222dd3344c65bc26a3a94843e3f6ff30239e319d6a229dd3bdf41ceb3
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__db0de72551b166907369891918b0eccf227b067c44151aff0f889642ecea6a78(
+    *,
+    max_capacity: jsii.Number,
+    min_capacity: jsii.Number,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__7db61dc80f26049d79a38255d8a0b3abaf4b5019d7cbed64c937ec0f3e40056c(
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,
@@ -7172,7 +7299,6 @@ def _typecheckingstub__3fef762ebf4d69195051e79f76d91c6d9e93e2a84a6c1e71f7b4a0b8c
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,
     *,
-    instance_type: _InstanceType_f64915b9,
     master_user: typing.Union[Login, typing.Dict[builtins.str, typing.Any]],
     vpc: _IVpc_f30d5663,
     backup: typing.Optional[typing.Union[BackupProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -7189,6 +7315,7 @@ def _typecheckingstub__3fef762ebf4d69195051e79f76d91c6d9e93e2a84a6c1e71f7b4a0b8c
     instance_identifier_base: typing.Optional[builtins.str] = None,
     instance_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
     instances: typing.Optional[jsii.Number] = None,
+    instance_type: typing.Optional[_InstanceType_f64915b9] = None,
     kms_key: typing.Optional[_IKey_5f11635f] = None,
     parameter_group: typing.Optional[IClusterParameterGroup] = None,
     port: typing.Optional[jsii.Number] = None,
@@ -7196,6 +7323,7 @@ def _typecheckingstub__3fef762ebf4d69195051e79f76d91c6d9e93e2a84a6c1e71f7b4a0b8c
     removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
     security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
     security_group_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
+    serverless_v2_scaling_configuration: typing.Optional[typing.Union[ServerlessV2ScalingConfiguration, typing.Dict[builtins.str, typing.Any]]] = None,
     storage_encrypted: typing.Optional[builtins.bool] = None,
     storage_type: typing.Optional[StorageType] = None,
     vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,

aws_cdk/aws_dsql/__init__.py

@@ -378,6 +378,27 @@ class CfnCluster(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @jsii.member(jsii_name="fromIdentifier")
+    @builtins.classmethod
+    def from_identifier(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        identifier: builtins.str,
+    ) -> IClusterRef:
+        '''Creates a new IClusterRef from a identifier.
+
+        :param scope: -
+        :param id: -
+        :param identifier: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__bccb1b24da44362c4f4e80968f320da6e8a1b50c7b1913648f91026e37e545ce)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument identifier", value=identifier, expected_type=type_hints["identifier"])
+        return typing.cast(IClusterRef, jsii.sinvoke(cls, "fromIdentifier", [scope, id, identifier]))
+
     @jsii.member(jsii_name="inspect")
     def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
         '''Examines the CloudFormation resource and discloses attributes.
@@ -755,6 +776,14 @@ def _typecheckingstub__b82b76673b1942e60f823768c857e13a61b0491cdd1ca21c1f2a574e9
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__bccb1b24da44362c4f4e80968f320da6e8a1b50c7b1913648f91026e37e545ce(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    identifier: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__b05414cc6a0a47d76a5604395b89b41d7f04f08f9b28ec25471d8d9dfd914483(
     inspector: _TreeInspector_488e0dd5,
 ) -> None: