aws-cdk-lib 2.184.1__py3-none-any.whl → 2.185.0__py3-none-any.whl

aws_cdk/aws_logs/__init__.py

@@ -423,8 +423,7 @@ Each policy may consist of a log group, S3 bucket, and/or Firehose delivery stre
 Example:
 
 ```python
-import aws_cdk.aws_kinesisfirehose_alpha as kinesisfirehose
-import aws_cdk.aws_kinesisfirehose_destinations_alpha as destinations
+import aws_cdk.aws_kinesisfirehose as firehose
 
 
 log_group_destination = logs.LogGroup(self, "LogGroupLambdaAudit",
@@ -432,9 +431,9 @@ log_group_destination = logs.LogGroup(self, "LogGroupLambdaAudit",
 )
 
 bucket = s3.Bucket(self, "audit-bucket")
-s3_destination = destinations.S3Bucket(bucket)
+s3_destination = firehose.S3Bucket(bucket)
 
-delivery_stream = kinesisfirehose.DeliveryStream(self, "Delivery Stream",
+delivery_stream = firehose.DeliveryStream(self, "Delivery Stream",
     destination=s3_destination
 )
 
@@ -8767,8 +8766,7 @@ class DataIdentifier(
 
     Example::
 
-        import aws_cdk.aws_kinesisfirehose_alpha as kinesisfirehose
-        import aws_cdk.aws_kinesisfirehose_destinations_alpha as destinations
+        import aws_cdk.aws_kinesisfirehose as firehose
         
         
         log_group_destination = logs.LogGroup(self, "LogGroupLambdaAudit",
@@ -8776,9 +8774,9 @@ class DataIdentifier(
         )
         
         bucket = s3.Bucket(self, "audit-bucket")
-        s3_destination = destinations.S3Bucket(bucket)
+        s3_destination = firehose.S3Bucket(bucket)
         
-        delivery_stream = kinesisfirehose.DeliveryStream(self, "Delivery Stream",
+        delivery_stream = firehose.DeliveryStream(self, "Delivery Stream",
             destination=s3_destination
         )
         
@@ -9323,8 +9321,7 @@ class DataProtectionPolicy(
 
     Example::
 
-        import aws_cdk.aws_kinesisfirehose_alpha as kinesisfirehose
-        import aws_cdk.aws_kinesisfirehose_destinations_alpha as destinations
+        import aws_cdk.aws_kinesisfirehose as firehose
         
         
         log_group_destination = logs.LogGroup(self, "LogGroupLambdaAudit",
@@ -9332,9 +9329,9 @@ class DataProtectionPolicy(
         )
         
         bucket = s3.Bucket(self, "audit-bucket")
-        s3_destination = destinations.S3Bucket(bucket)
+        s3_destination = firehose.S3Bucket(bucket)
         
-        delivery_stream = kinesisfirehose.DeliveryStream(self, "Delivery Stream",
+        delivery_stream = firehose.DeliveryStream(self, "Delivery Stream",
             destination=s3_destination
         )
         
@@ -9368,7 +9365,7 @@ class DataProtectionPolicy(
     ) -> None:
         '''
         :param identifiers: List of data protection identifiers. Managed data identifiers must be in the following list: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL-managed-data-identifiers.html Custom data identifiers must have a valid regex defined: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL-custom-data-identifiers.html#custom-data-identifiers-constraints
-        :param delivery_stream_name_audit_destination: Amazon Kinesis Data Firehose delivery stream to send audit findings to. The delivery stream must already exist. Default: - no firehose delivery stream audit destination
+        :param delivery_stream_name_audit_destination: Amazon Data Firehose delivery stream to send audit findings to. The delivery stream must already exist. Default: - no firehose delivery stream audit destination
         :param description: Description of the data protection policy. Default: - 'cdk generated data protection policy'
         :param log_group_audit_destination: CloudWatch Logs log group to send audit findings to. The log group must already exist prior to creating the data protection policy. Default: - no CloudWatch Logs audit destination
         :param name: Name of the data protection policy. Default: - 'data-protection-policy-cdk'
@@ -9412,7 +9409,7 @@ class DataProtectionPolicyProps:
         '''Properties for creating a data protection policy.
 
         :param identifiers: List of data protection identifiers. Managed data identifiers must be in the following list: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL-managed-data-identifiers.html Custom data identifiers must have a valid regex defined: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL-custom-data-identifiers.html#custom-data-identifiers-constraints
-        :param delivery_stream_name_audit_destination: Amazon Kinesis Data Firehose delivery stream to send audit findings to. The delivery stream must already exist. Default: - no firehose delivery stream audit destination
+        :param delivery_stream_name_audit_destination: Amazon Data Firehose delivery stream to send audit findings to. The delivery stream must already exist. Default: - no firehose delivery stream audit destination
         :param description: Description of the data protection policy. Default: - 'cdk generated data protection policy'
         :param log_group_audit_destination: CloudWatch Logs log group to send audit findings to. The log group must already exist prior to creating the data protection policy. Default: - no CloudWatch Logs audit destination
         :param name: Name of the data protection policy. Default: - 'data-protection-policy-cdk'
@@ -9422,8 +9419,7 @@ class DataProtectionPolicyProps:
 
         Example::
 
-            import aws_cdk.aws_kinesisfirehose_alpha as kinesisfirehose
-            import aws_cdk.aws_kinesisfirehose_destinations_alpha as destinations
+            import aws_cdk.aws_kinesisfirehose as firehose
             
             
             log_group_destination = logs.LogGroup(self, "LogGroupLambdaAudit",
@@ -9431,9 +9427,9 @@ class DataProtectionPolicyProps:
             )
             
             bucket = s3.Bucket(self, "audit-bucket")
-            s3_destination = destinations.S3Bucket(bucket)
+            s3_destination = firehose.S3Bucket(bucket)
             
-            delivery_stream = kinesisfirehose.DeliveryStream(self, "Delivery Stream",
+            delivery_stream = firehose.DeliveryStream(self, "Delivery Stream",
                 destination=s3_destination
             )
             
@@ -9489,7 +9485,7 @@ class DataProtectionPolicyProps:
 
     @builtins.property
     def delivery_stream_name_audit_destination(self) -> typing.Optional[builtins.str]:
-        '''Amazon Kinesis Data Firehose delivery stream to send audit findings to.
+        '''Amazon Data Firehose delivery stream to send audit findings to.
 
         The delivery stream must already exist.
 
@@ -11221,8 +11217,7 @@ class LogGroupProps:
 
         Example::
 
-            import aws_cdk.aws_kinesisfirehose_alpha as kinesisfirehose
-            import aws_cdk.aws_kinesisfirehose_destinations_alpha as destinations
+            import aws_cdk.aws_kinesisfirehose as firehose
             
             
             log_group_destination = logs.LogGroup(self, "LogGroupLambdaAudit",
@@ -11230,9 +11225,9 @@ class LogGroupProps:
             )
             
             bucket = s3.Bucket(self, "audit-bucket")
-            s3_destination = destinations.S3Bucket(bucket)
+            s3_destination = firehose.S3Bucket(bucket)
             
-            delivery_stream = kinesisfirehose.DeliveryStream(self, "Delivery Stream",
+            delivery_stream = firehose.DeliveryStream(self, "Delivery Stream",
                 destination=s3_destination
             )
             
@@ -13632,8 +13627,7 @@ class CustomDataIdentifier(
 
     Example::
 
-        import aws_cdk.aws_kinesisfirehose_alpha as kinesisfirehose
-        import aws_cdk.aws_kinesisfirehose_destinations_alpha as destinations
+        import aws_cdk.aws_kinesisfirehose as firehose
         
         
         log_group_destination = logs.LogGroup(self, "LogGroupLambdaAudit",
@@ -13641,9 +13635,9 @@ class CustomDataIdentifier(
         )
         
         bucket = s3.Bucket(self, "audit-bucket")
-        s3_destination = destinations.S3Bucket(bucket)
+        s3_destination = firehose.S3Bucket(bucket)
         
-        delivery_stream = kinesisfirehose.DeliveryStream(self, "Delivery Stream",
+        delivery_stream = firehose.DeliveryStream(self, "Delivery Stream",
             destination=s3_destination
         )
         

aws_cdk/aws_msk/__init__.py

@@ -272,13 +272,6 @@ class CfnCluster(
 ):
     '''Creates a new MSK cluster.
 
-    The following Python 3.6 example shows how you can create a cluster that's distributed across two `Availability Zones <https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-availability-zones.html>`_ . Before you run this Python script, replace the example subnet and security-group IDs with the IDs of your subnets and security group.
-
-    When you create an MSK cluster, its brokers get evenly distributed across a number of Availability Zones that's equal to the number of subnets that you specify in the ``BrokerNodeGroupInfo`` parameter. In the following example, you can add a third subnet to get a cluster that's distributed across three Availability Zones::
-
-       import boto3 client = boto3.client('kafka') response = client.create_cluster( BrokerNodeGroupInfo={ 'BrokerAZDistribution': 'DEFAULT', 'ClientSubnets': [ 'subnet-012345678901fedcba', 'subnet-9876543210abcdef01' ], 'InstanceType': 'kafka.m5.large', 'SecurityGroups': [ 'sg-012345abcdef789789' ] }, ClusterName='SalesCluster', EncryptionInfo={ 'EncryptionInTransit': { 'ClientBroker': 'TLS_PLAINTEXT', 'InCluster': True } }, EnhancedMonitoring='PER_TOPIC_PER_BROKER', KafkaVersion='2.2.1', NumberOfBrokerNodes=2
-       ) print(response)
-
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html
     :cloudformationResource: AWS::MSK::Cluster
     :exampleMetadata: fixture=_generated
@@ -4028,7 +4021,6 @@ class CfnReplicator(
             service_execution_role_arn="serviceExecutionRoleArn",
         
             # the properties below are optional
-            current_version="currentVersion",
             description="description",
             tags=[CfnTag(
                 key="key",
@@ -4046,7 +4038,6 @@ class CfnReplicator(
         replication_info_list: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnReplicator.ReplicationInfoProperty", typing.Dict[builtins.str, typing.Any]]]]],
         replicator_name: builtins.str,
         service_execution_role_arn: builtins.str,
-        current_version: typing.Optional[builtins.str] = None,
         description: typing.Optional[builtins.str] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
@@ -4057,7 +4048,6 @@ class CfnReplicator(
         :param replication_info_list: A list of replication configurations, where each configuration targets a given source cluster to target cluster replication flow.
         :param replicator_name: The name of the replicator. Alpha-numeric characters with '-' are allowed.
         :param service_execution_role_arn: The ARN of the IAM role used by the replicator to access resources in the customer's account (e.g source and target clusters).
-        :param current_version: The current version number of the replicator.
         :param description: A summary description of the replicator.
         :param tags: List of tags to attach to created Replicator.
         '''
@@ -4070,7 +4060,6 @@ class CfnReplicator(
             replication_info_list=replication_info_list,
             replicator_name=replicator_name,
             service_execution_role_arn=service_execution_role_arn,
-            current_version=current_version,
             description=description,
             tags=tags,
         )
@@ -4107,6 +4096,15 @@ class CfnReplicator(
         '''The CloudFormation resource type name for this resource class.'''
         return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
 
+    @builtins.property
+    @jsii.member(jsii_name="attrCurrentVersion")
+    def attr_current_version(self) -> builtins.str:
+        '''The current version number of the replicator.
+
+        :cloudformationAttribute: CurrentVersion
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "attrCurrentVersion"))
+
     @builtins.property
     @jsii.member(jsii_name="attrReplicatorArn")
     def attr_replicator_arn(self) -> builtins.str:
@@ -4189,19 +4187,6 @@ class CfnReplicator(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "serviceExecutionRoleArn", value) # pyright: ignore[reportArgumentType]
 
-    @builtins.property
-    @jsii.member(jsii_name="currentVersion")
-    def current_version(self) -> typing.Optional[builtins.str]:
-        '''The current version number of the replicator.'''
-        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "currentVersion"))
-
-    @current_version.setter
-    def current_version(self, value: typing.Optional[builtins.str]) -> None:
-        if __debug__:
-            type_hints = typing.get_type_hints(_typecheckingstub__79b07be057d5f4bf56dda86a24cdbb4ced3cc7a8e053d156dd93bbcf785aeb6f)
-            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "currentVersion", value) # pyright: ignore[reportArgumentType]
-
     @builtins.property
     @jsii.member(jsii_name="description")
     def description(self) -> typing.Optional[builtins.str]:
@@ -4985,7 +4970,6 @@ class CfnReplicator(
         "replication_info_list": "replicationInfoList",
         "replicator_name": "replicatorName",
         "service_execution_role_arn": "serviceExecutionRoleArn",
-        "current_version": "currentVersion",
         "description": "description",
         "tags": "tags",
     },
@@ -4998,7 +4982,6 @@ class CfnReplicatorProps:
         replication_info_list: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnReplicator.ReplicationInfoProperty, typing.Dict[builtins.str, typing.Any]]]]],
         replicator_name: builtins.str,
         service_execution_role_arn: builtins.str,
-        current_version: typing.Optional[builtins.str] = None,
         description: typing.Optional[builtins.str] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
@@ -5008,7 +4991,6 @@ class CfnReplicatorProps:
         :param replication_info_list: A list of replication configurations, where each configuration targets a given source cluster to target cluster replication flow.
         :param replicator_name: The name of the replicator. Alpha-numeric characters with '-' are allowed.
         :param service_execution_role_arn: The ARN of the IAM role used by the replicator to access resources in the customer's account (e.g source and target clusters).
-        :param current_version: The current version number of the replicator.
         :param description: A summary description of the replicator.
         :param tags: List of tags to attach to created Replicator.
 
@@ -5065,7 +5047,6 @@ class CfnReplicatorProps:
                 service_execution_role_arn="serviceExecutionRoleArn",
             
                 # the properties below are optional
-                current_version="currentVersion",
                 description="description",
                 tags=[CfnTag(
                     key="key",
@@ -5079,7 +5060,6 @@ class CfnReplicatorProps:
             check_type(argname="argument replication_info_list", value=replication_info_list, expected_type=type_hints["replication_info_list"])
             check_type(argname="argument replicator_name", value=replicator_name, expected_type=type_hints["replicator_name"])
             check_type(argname="argument service_execution_role_arn", value=service_execution_role_arn, expected_type=type_hints["service_execution_role_arn"])
-            check_type(argname="argument current_version", value=current_version, expected_type=type_hints["current_version"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
@@ -5088,8 +5068,6 @@ class CfnReplicatorProps:
             "replicator_name": replicator_name,
             "service_execution_role_arn": service_execution_role_arn,
         }
-        if current_version is not None:
-            self._values["current_version"] = current_version
         if description is not None:
             self._values["description"] = description
         if tags is not None:
@@ -5141,15 +5119,6 @@ class CfnReplicatorProps:
         assert result is not None, "Required property 'service_execution_role_arn' is missing"
         return typing.cast(builtins.str, result)
 
-    @builtins.property
-    def current_version(self) -> typing.Optional[builtins.str]:
-        '''The current version number of the replicator.
-
-        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-replicator.html#cfn-msk-replicator-currentversion
-        '''
-        result = self._values.get("current_version")
-        return typing.cast(typing.Optional[builtins.str], result)
-
     @builtins.property
     def description(self) -> typing.Optional[builtins.str]:
         '''A summary description of the replicator.
@@ -6637,7 +6606,6 @@ def _typecheckingstub__dfeb157957f65ee344afab32ca8fffe9eb07ec631c59935f85e890a85
     replication_info_list: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnReplicator.ReplicationInfoProperty, typing.Dict[builtins.str, typing.Any]]]]],
     replicator_name: builtins.str,
     service_execution_role_arn: builtins.str,
-    current_version: typing.Optional[builtins.str] = None,
     description: typing.Optional[builtins.str] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
@@ -6680,12 +6648,6 @@ def _typecheckingstub__407d0e51992bcbb91149b5316e9f5b3429ee3acebc8959194b791b791
     """Type checking stubs"""
     pass
 
-def _typecheckingstub__79b07be057d5f4bf56dda86a24cdbb4ced3cc7a8e053d156dd93bbcf785aeb6f(
-    value: typing.Optional[builtins.str],
-) -> None:
-    """Type checking stubs"""
-    pass
-
 def _typecheckingstub__0d4359699d0ff82e6e6d493eefa33cd643cafd7ea12f638de022a962a125c66d(
     value: typing.Optional[builtins.str],
 ) -> None:
@@ -6775,7 +6737,6 @@ def _typecheckingstub__8386726baf4842aa1a4af40915bf45a4cc4edffd70ea82fa6a181cca6
     replication_info_list: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnReplicator.ReplicationInfoProperty, typing.Dict[builtins.str, typing.Any]]]]],
     replicator_name: builtins.str,
     service_execution_role_arn: builtins.str,
-    current_version: typing.Optional[builtins.str] = None,
     description: typing.Optional[builtins.str] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:

aws_cdk/aws_opensearchservice/__init__.py

@@ -292,7 +292,7 @@ domain = Domain(self, "Domain",
 ```
 
 For more complex use-cases, for example, to set the domain up to receive data from a
-[cross-account Kinesis Firehose](https://aws.amazon.com/premiumsupport/knowledge-center/kinesis-firehose-cross-account-streaming/) the `addAccessPolicies` helper method
+[cross-account Amazon Data Firehose](https://aws.amazon.com/premiumsupport/knowledge-center/kinesis-firehose-cross-account-streaming/) the `addAccessPolicies` helper method
 allows for policies that include the explicit domain ARN.
 
 ```python

aws_cdk/aws_pcs/__init__.py

@@ -1107,8 +1107,10 @@ class CfnComputeNodeGroup(
         cfn_compute_node_group = pcs.CfnComputeNodeGroup(self, "MyCfnComputeNodeGroup",
             cluster_id="clusterId",
             custom_launch_template=pcs.CfnComputeNodeGroup.CustomLaunchTemplateProperty(
-                id="id",
-                version="version"
+                version="version",
+        
+                # the properties below are optional
+                template_id="templateId"
             ),
             iam_instance_profile_arn="iamInstanceProfileArn",
             instance_configs=[pcs.CfnComputeNodeGroup.InstanceConfigProperty(
@@ -1460,14 +1462,19 @@ class CfnComputeNodeGroup(
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_pcs.CfnComputeNodeGroup.CustomLaunchTemplateProperty",
         jsii_struct_bases=[],
-        name_mapping={"id": "id", "version": "version"},
+        name_mapping={"version": "version", "template_id": "templateId"},
     )
     class CustomLaunchTemplateProperty:
-        def __init__(self, *, id: builtins.str, version: builtins.str) -> None:
+        def __init__(
+            self,
+            *,
+            version: builtins.str,
+            template_id: typing.Optional[builtins.str] = None,
+        ) -> None:
             '''An Amazon EC2 launch template AWS PCS uses to launch compute nodes.
 
-            :param id: The ID of the EC2 launch template to use to provision instances.
             :param version: The version of the EC2 launch template to use to provision instances.
+            :param template_id: The ID of the EC2 launch template to use to provision instances.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pcs-computenodegroup-customlaunchtemplate.html
             :exampleMetadata: fixture=_generated
@@ -1479,28 +1486,21 @@ class CfnComputeNodeGroup(
                 from aws_cdk import aws_pcs as pcs
                 
                 custom_launch_template_property = pcs.CfnComputeNodeGroup.CustomLaunchTemplateProperty(
-                    id="id",
-                    version="version"
+                    version="version",
+                
+                    # the properties below are optional
+                    template_id="templateId"
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__f5e18d4eaf127cbbf203643daa28b5c0a8105f4a3d48ce6e2c896d6f851d7911)
-                check_type(argname="argument id", value=id, expected_type=type_hints["id"])
                 check_type(argname="argument version", value=version, expected_type=type_hints["version"])
+                check_type(argname="argument template_id", value=template_id, expected_type=type_hints["template_id"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
-                "id": id,
                 "version": version,
             }
-
-        @builtins.property
-        def id(self) -> builtins.str:
-            '''The ID of the EC2 launch template to use to provision instances.
-
-            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pcs-computenodegroup-customlaunchtemplate.html#cfn-pcs-computenodegroup-customlaunchtemplate-id
-            '''
-            result = self._values.get("id")
-            assert result is not None, "Required property 'id' is missing"
-            return typing.cast(builtins.str, result)
+            if template_id is not None:
+                self._values["template_id"] = template_id
 
         @builtins.property
         def version(self) -> builtins.str:
@@ -1512,6 +1512,15 @@ class CfnComputeNodeGroup(
             assert result is not None, "Required property 'version' is missing"
             return typing.cast(builtins.str, result)
 
+        @builtins.property
+        def template_id(self) -> typing.Optional[builtins.str]:
+            '''The ID of the EC2 launch template to use to provision instances.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pcs-computenodegroup-customlaunchtemplate.html#cfn-pcs-computenodegroup-customlaunchtemplate-templateid
+            '''
+            result = self._values.get("template_id")
+            return typing.cast(typing.Optional[builtins.str], result)
+
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -1986,8 +1995,10 @@ class CfnComputeNodeGroupProps:
             cfn_compute_node_group_props = pcs.CfnComputeNodeGroupProps(
                 cluster_id="clusterId",
                 custom_launch_template=pcs.CfnComputeNodeGroup.CustomLaunchTemplateProperty(
-                    id="id",
-                    version="version"
+                    version="version",
+            
+                    # the properties below are optional
+                    template_id="templateId"
                 ),
                 iam_instance_profile_arn="iamInstanceProfileArn",
                 instance_configs=[pcs.CfnComputeNodeGroup.InstanceConfigProperty(
@@ -2895,8 +2906,8 @@ def _typecheckingstub__4f9d940f011938958eb70282b41c84f70c7f86093c1788ec73b310de3
 
 def _typecheckingstub__f5e18d4eaf127cbbf203643daa28b5c0a8105f4a3d48ce6e2c896d6f851d7911(
     *,
-    id: builtins.str,
     version: builtins.str,
+    template_id: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass

aws_cdk/aws_rds/__init__.py

@@ -5210,7 +5210,7 @@ class CfnDBCluster(
         :param network_type: The network type of the DB cluster. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB cluster. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon Aurora User Guide.* Valid for: Aurora DB clusters only
         :param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
         :param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
-        :param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
+        :param performance_insights_retention_period: The number of days to retain Performance Insights data. When creating a DB cluster without enabling Performance Insights, you can't specify the parameter ``PerformanceInsightsRetentionPeriod`` . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
         :param port: The port number on which the DB instances in the DB cluster accept connections. Default: - When ``EngineMode`` is ``provisioned`` , ``3306`` (for both Aurora MySQL and Aurora PostgreSQL) - When ``EngineMode`` is ``serverless`` : - ``3306`` when ``Engine`` is ``aurora`` or ``aurora-mysql`` - ``5432`` when ``Engine`` is ``aurora-postgresql`` .. epigraph:: The ``No interruption`` on update behavior only applies to DB clusters. If you are updating a DB instance, see `Port <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-port>`_ for the AWS::RDS::DBInstance resource. Valid for: Aurora DB clusters and Multi-AZ DB clusters
         :param preferred_backup_window: The daily time range during which automated backups are created. For more information, see `Backup Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow>`_ in the *Amazon Aurora User Guide.* Constraints: - Must be in the format ``hh24:mi-hh24:mi`` . - Must be in Universal Coordinated Time (UTC). - Must not conflict with the preferred maintenance window. - Must be at least 30 minutes. Valid for: Aurora DB clusters and Multi-AZ DB clusters
         :param preferred_maintenance_window: The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC). Format: ``ddd:hh24:mi-ddd:hh24:mi`` The default is 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. To see the time blocks available, see `Maintaining an Amazon Aurora DB cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora>`_ in the *Amazon Aurora User Guide.* Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun. Constraints: Minimum 30-minute window. Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -7404,7 +7404,7 @@ class CfnDBClusterProps:
         :param network_type: The network type of the DB cluster. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB cluster. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon Aurora User Guide.* Valid for: Aurora DB clusters only
         :param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
         :param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
-        :param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
+        :param performance_insights_retention_period: The number of days to retain Performance Insights data. When creating a DB cluster without enabling Performance Insights, you can't specify the parameter ``PerformanceInsightsRetentionPeriod`` . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
         :param port: The port number on which the DB instances in the DB cluster accept connections. Default: - When ``EngineMode`` is ``provisioned`` , ``3306`` (for both Aurora MySQL and Aurora PostgreSQL) - When ``EngineMode`` is ``serverless`` : - ``3306`` when ``Engine`` is ``aurora`` or ``aurora-mysql`` - ``5432`` when ``Engine`` is ``aurora-postgresql`` .. epigraph:: The ``No interruption`` on update behavior only applies to DB clusters. If you are updating a DB instance, see `Port <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-port>`_ for the AWS::RDS::DBInstance resource. Valid for: Aurora DB clusters and Multi-AZ DB clusters
         :param preferred_backup_window: The daily time range during which automated backups are created. For more information, see `Backup Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow>`_ in the *Amazon Aurora User Guide.* Constraints: - Must be in the format ``hh24:mi-hh24:mi`` . - Must be in Universal Coordinated Time (UTC). - Must not conflict with the preferred maintenance window. - Must be at least 30 minutes. Valid for: Aurora DB clusters and Multi-AZ DB clusters
         :param preferred_maintenance_window: The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC). Format: ``ddd:hh24:mi-ddd:hh24:mi`` The default is 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. To see the time blocks available, see `Maintaining an Amazon Aurora DB cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora>`_ in the *Amazon Aurora User Guide.* Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun. Constraints: Minimum 30-minute window. Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -8381,6 +8381,8 @@ class CfnDBClusterProps:
     def performance_insights_retention_period(self) -> typing.Optional[jsii.Number]:
         '''The number of days to retain Performance Insights data.
 
+        When creating a DB cluster without enabling Performance Insights, you can't specify the parameter ``PerformanceInsightsRetentionPeriod`` .
+
         Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
 
         Valid Values:
@@ -9035,7 +9037,7 @@ class CfnDBInstance(
         :param network_type: The network type of the DB instance. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB instance. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon RDS User Guide.*
         :param option_group_name: Indicates that the DB instance should be associated with the specified option group. Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group. Also, that option group can't be removed from a DB instance once it is associated with a DB instance.
         :param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you do not specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account. Your AWS account has a different default KMS key for each AWS Region. For information about enabling Performance Insights, see `EnablePerformanceInsights <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-enableperformanceinsights>`_ .
-        :param performance_insights_retention_period: The number of days to retain Performance Insights data. This setting doesn't apply to RDS Custom DB instances. Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS returns an error.
+        :param performance_insights_retention_period: The number of days to retain Performance Insights data. When creating a DB instance without enabling Performance Insights, you can't specify the parameter ``PerformanceInsightsRetentionPeriod`` . This setting doesn't apply to RDS Custom DB instances. Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS returns an error.
         :param port: The port number on which the database accepts connections. This setting doesn't apply to Aurora DB instances. The port number is managed by the cluster. Valid Values: ``1150-65535`` Default: - RDS for Db2 - ``50000`` - RDS for MariaDB - ``3306`` - RDS for Microsoft SQL Server - ``1433`` - RDS for MySQL - ``3306`` - RDS for Oracle - ``1521`` - RDS for PostgreSQL - ``5432`` Constraints: - For RDS for Microsoft SQL Server, the value can't be ``1234`` , ``1434`` , ``3260`` , ``3343`` , ``3389`` , ``47001`` , or ``49152-49156`` .
         :param preferred_backup_window: The daily time range during which automated backups are created if automated backups are enabled, using the ``BackupRetentionPeriod`` parameter. For more information, see `Backup Window <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow>`_ in the *Amazon RDS User Guide.* Constraints: - Must be in the format ``hh24:mi-hh24:mi`` . - Must be in Universal Coordinated Time (UTC). - Must not conflict with the preferred maintenance window. - Must be at least 30 minutes. *Amazon Aurora* Not applicable. The daily time range for creating automated backups is managed by the DB cluster.
         :param preferred_maintenance_window: The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC). Format: ``ddd:hh24:mi-ddd:hh24:mi`` The default is 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. To see the time blocks available, see `Maintaining a DB instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow>`_ in the *Amazon RDS User Guide.* .. epigraph:: This property applies when AWS CloudFormation initially creates the DB instance. If you use AWS CloudFormation to update the DB instance, those updates are applied immediately. Constraints: Minimum 30-minute window.
@@ -11107,7 +11109,7 @@ class CfnDBInstanceProps:
         :param network_type: The network type of the DB instance. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB instance. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon RDS User Guide.*
         :param option_group_name: Indicates that the DB instance should be associated with the specified option group. Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group. Also, that option group can't be removed from a DB instance once it is associated with a DB instance.
         :param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you do not specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account. Your AWS account has a different default KMS key for each AWS Region. For information about enabling Performance Insights, see `EnablePerformanceInsights <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-enableperformanceinsights>`_ .
-        :param performance_insights_retention_period: The number of days to retain Performance Insights data. This setting doesn't apply to RDS Custom DB instances. Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS returns an error.
+        :param performance_insights_retention_period: The number of days to retain Performance Insights data. When creating a DB instance without enabling Performance Insights, you can't specify the parameter ``PerformanceInsightsRetentionPeriod`` . This setting doesn't apply to RDS Custom DB instances. Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS returns an error.
         :param port: The port number on which the database accepts connections. This setting doesn't apply to Aurora DB instances. The port number is managed by the cluster. Valid Values: ``1150-65535`` Default: - RDS for Db2 - ``50000`` - RDS for MariaDB - ``3306`` - RDS for Microsoft SQL Server - ``1433`` - RDS for MySQL - ``3306`` - RDS for Oracle - ``1521`` - RDS for PostgreSQL - ``5432`` Constraints: - For RDS for Microsoft SQL Server, the value can't be ``1234`` , ``1434`` , ``3260`` , ``3343`` , ``3389`` , ``47001`` , or ``49152-49156`` .
         :param preferred_backup_window: The daily time range during which automated backups are created if automated backups are enabled, using the ``BackupRetentionPeriod`` parameter. For more information, see `Backup Window <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow>`_ in the *Amazon RDS User Guide.* Constraints: - Must be in the format ``hh24:mi-hh24:mi`` . - Must be in Universal Coordinated Time (UTC). - Must not conflict with the preferred maintenance window. - Must be at least 30 minutes. *Amazon Aurora* Not applicable. The daily time range for creating automated backups is managed by the DB cluster.
         :param preferred_maintenance_window: The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC). Format: ``ddd:hh24:mi-ddd:hh24:mi`` The default is 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. To see the time blocks available, see `Maintaining a DB instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow>`_ in the *Amazon RDS User Guide.* .. epigraph:: This property applies when AWS CloudFormation initially creates the DB instance. If you use AWS CloudFormation to update the DB instance, those updates are applied immediately. Constraints: Minimum 30-minute window.
@@ -12665,6 +12667,8 @@ class CfnDBInstanceProps:
     def performance_insights_retention_period(self) -> typing.Optional[jsii.Number]:
         '''The number of days to retain Performance Insights data.
 
+        When creating a DB instance without enabling Performance Insights, you can't specify the parameter ``PerformanceInsightsRetentionPeriod`` .
+
         This setting doesn't apply to RDS Custom DB instances.
 
         Valid Values: