aws-cdk-lib 2.206.0__py3-none-any.whl → 2.208.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of aws-cdk-lib might be problematic. Click here for more details.

Files changed (44) hide show
  1. aws_cdk/__init__.py +96 -15
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.206.0.jsii.tgz → aws-cdk-lib@2.208.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_aiops/__init__.py +70 -76
  5. aws_cdk/aws_amazonmq/__init__.py +8 -18
  6. aws_cdk/aws_appstream/__init__.py +36 -4
  7. aws_cdk/aws_autoscaling/__init__.py +20 -0
  8. aws_cdk/aws_bedrock/__init__.py +317 -142
  9. aws_cdk/aws_certificatemanager/__init__.py +48 -3
  10. aws_cdk/aws_cleanrooms/__init__.py +6 -2
  11. aws_cdk/aws_cloudformation/__init__.py +28 -15
  12. aws_cdk/aws_cloudfront/__init__.py +12 -2
  13. aws_cdk/aws_cloudwatch/__init__.py +574 -33
  14. aws_cdk/aws_connect/__init__.py +107 -3
  15. aws_cdk/aws_customerprofiles/__init__.py +27 -22
  16. aws_cdk/aws_datasync/__init__.py +14 -15
  17. aws_cdk/aws_docdb/__init__.py +5 -3
  18. aws_cdk/aws_ec2/__init__.py +59 -13
  19. aws_cdk/aws_ecs/__init__.py +185 -47
  20. aws_cdk/aws_events/__init__.py +142 -0
  21. aws_cdk/aws_gamelift/__init__.py +2 -2
  22. aws_cdk/aws_guardduty/__init__.py +86 -0
  23. aws_cdk/aws_iotsitewise/__init__.py +13 -9
  24. aws_cdk/aws_kinesisfirehose/__init__.py +377 -4
  25. aws_cdk/aws_kms/__init__.py +19 -17
  26. aws_cdk/aws_logs/__init__.py +4775 -764
  27. aws_cdk/aws_mediapackagev2/__init__.py +950 -48
  28. aws_cdk/aws_omics/__init__.py +13 -10
  29. aws_cdk/aws_opsworkscm/__init__.py +2 -4
  30. aws_cdk/aws_quicksight/__init__.py +111 -4
  31. aws_cdk/aws_rds/__init__.py +358 -27
  32. aws_cdk/aws_s3/__init__.py +781 -8
  33. aws_cdk/aws_s3express/__init__.py +61 -3
  34. aws_cdk/aws_s3tables/__init__.py +254 -0
  35. aws_cdk/aws_sagemaker/__init__.py +527 -140
  36. aws_cdk/aws_ssm/__init__.py +106 -33
  37. aws_cdk/aws_transfer/__init__.py +70 -11
  38. aws_cdk/aws_wisdom/__init__.py +1185 -100
  39. {aws_cdk_lib-2.206.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/METADATA +2 -2
  40. {aws_cdk_lib-2.206.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/RECORD +44 -44
  41. {aws_cdk_lib-2.206.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/LICENSE +0 -0
  42. {aws_cdk_lib-2.206.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/NOTICE +0 -0
  43. {aws_cdk_lib-2.206.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/WHEEL +0 -0
  44. {aws_cdk_lib-2.206.0.dist-info → aws_cdk_lib-2.208.0.dist-info}/top_level.txt +0 -0
@@ -1749,7 +1749,21 @@ rds.DatabaseCluster(self, "Database",
1749
1749
  )
1750
1750
  ```
1751
1751
 
1752
- Note: Database Insights are only supported for Amazon Aurora MySQL and Amazon Aurora PostgreSQL clusters.
1752
+ Database Insights is also supported for RDS instances:
1753
+
1754
+ ```python
1755
+ # vpc: ec2.Vpc
1756
+
1757
+ rds.DatabaseInstance(self, "PostgresInstance",
1758
+ engine=rds.DatabaseInstanceEngine.postgres(version=rds.PostgresEngineVersion.VER_17_5),
1759
+ instance_type=ec2.InstanceType.of(ec2.InstanceClass.R5, ec2.InstanceSize.LARGE),
1760
+ vpc=vpc,
1761
+ # If you enable the advanced mode of Database Insights,
1762
+ # Performance Insights is enabled and you must set the `performanceInsightRetention` to 465(15 months).
1763
+ database_insights_mode=rds.DatabaseInsightsMode.ADVANCED,
1764
+ performance_insight_retention=rds.PerformanceInsightRetention.MONTHS_15
1765
+ )
1766
+ ```
1753
1767
 
1754
1768
  > Visit [CloudWatch Database Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Database-Insights.html) for more details.
1755
1769
 
@@ -5355,6 +5369,7 @@ class CfnDBCluster(
5355
5369
  db_instance_parameter_group_name="dbInstanceParameterGroupName",
5356
5370
  db_subnet_group_name="dbSubnetGroupName",
5357
5371
  db_system_id="dbSystemId",
5372
+ delete_automated_backups=False,
5358
5373
  deletion_protection=False,
5359
5374
  domain="domain",
5360
5375
  domain_iam_role_name="domainIamRoleName",
@@ -5438,6 +5453,7 @@ class CfnDBCluster(
5438
5453
  db_instance_parameter_group_name: typing.Optional[builtins.str] = None,
5439
5454
  db_subnet_group_name: typing.Optional[builtins.str] = None,
5440
5455
  db_system_id: typing.Optional[builtins.str] = None,
5456
+ delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
5441
5457
  deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
5442
5458
  domain: typing.Optional[builtins.str] = None,
5443
5459
  domain_iam_role_name: typing.Optional[builtins.str] = None,
@@ -5490,7 +5506,7 @@ class CfnDBCluster(
5490
5506
  :param availability_zones: A list of Availability Zones (AZs) where instances in the DB cluster can be created. For information on AWS Regions and Availability Zones, see `Choosing the Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters only
5491
5507
  :param backtrack_window: The target backtrack window, in seconds. To disable backtracking, set this value to ``0`` . Valid for Cluster Type: Aurora MySQL DB clusters only Default: ``0`` Constraints: - If specified, this value must be set to a number from 0 to 259,200 (72 hours).
5492
5508
  :param backup_retention_period: The number of days for which automated backups are retained. Default: 1 Constraints: - Must be a value from 1 to 35 Valid for: Aurora DB clusters and Multi-AZ DB clusters Default: - 1
5493
- :param cluster_scalability_type: Specifies the scalability mode of the Aurora DB cluster. When set to ``limitless`` , the cluster operates as an Aurora Limitless Database, allowing you to create a DB shard group for horizontal scaling (sharding) capabilities. When set to ``standard`` (the default), the cluster uses normal DB instance creation.
5509
+ :param cluster_scalability_type: Specifies the scalability mode of the Aurora DB cluster. When set to ``limitless`` , the cluster operates as an Aurora Limitless Database, allowing you to create a DB shard group for horizontal scaling (sharding) capabilities. When set to ``standard`` (the default), the cluster uses normal DB instance creation. *Important:* Automated backup retention isn't supported with Aurora Limitless Database clusters. If you set this property to ``limitless`` , you cannot set ``DeleteAutomatedBackups`` to ``false`` . To create a backup, use manual snapshots instead.
5494
5510
  :param copy_tags_to_snapshot: A value that indicates whether to copy all tags from the DB cluster to snapshots of the DB cluster. The default is not to copy them. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5495
5511
  :param database_insights_mode: The mode of Database Insights to enable for the DB cluster. If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
5496
5512
  :param database_name: The name of your database. If you don't provide a name, then Amazon RDS won't create a database in this DB cluster. For naming constraints, see `Naming Constraints <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_Limits.html#RDS_Limits.Constraints>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -5500,6 +5516,7 @@ class CfnDBCluster(
5500
5516
  :param db_instance_parameter_group_name: The name of the DB parameter group to apply to all instances of the DB cluster. .. epigraph:: When you apply a parameter group using the ``DBInstanceParameterGroupName`` parameter, the DB cluster isn't rebooted automatically. Also, parameter changes are applied immediately rather than during the next maintenance window. Valid for Cluster Type: Aurora DB clusters only Default: The existing name setting Constraints: - The DB parameter group must be in the same DB parameter group family as this DB cluster. - The ``DBInstanceParameterGroupName`` parameter is valid in combination with the ``AllowMajorVersionUpgrade`` parameter for a major version upgrade only.
5501
5517
  :param db_subnet_group_name: A DB subnet group that you want to associate with this DB cluster. If you are restoring a DB cluster to a point in time with ``RestoreType`` set to ``copy-on-write`` , and don't specify a DB subnet group name, then the DB cluster is restored with a default DB subnet group. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5502
5518
  :param db_system_id: Reserved for future use.
5519
+ :param delete_automated_backups: Specifies whether to remove automated backups immediately after the DB cluster is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB cluster is deleted, unless the AWS Backup policy specifies a point-in-time restore rule.
5503
5520
  :param deletion_protection: A value that indicates whether the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection is disabled. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5504
5521
  :param domain: Indicates the directory ID of the Active Directory to create the DB cluster. For Amazon Aurora DB clusters, Amazon RDS can use Kerberos authentication to authenticate users that connect to the DB cluster. For more information, see `Kerberos authentication <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters only
5505
5522
  :param domain_iam_role_name: Specifies the name of the IAM role to use when making API calls to the Directory Service. Valid for: Aurora DB clusters only
@@ -5535,7 +5552,7 @@ class CfnDBCluster(
5535
5552
  :param scaling_configuration: The scaling configuration of an Aurora Serverless v1 DB cluster. This property is only supported for Aurora Serverless v1. For Aurora Serverless v2, Use the ``ServerlessV2ScalingConfiguration`` property. Valid for: Aurora Serverless v1 DB clusters only
5536
5553
  :param serverless_v2_scaling_configuration: The scaling configuration of an Aurora Serverless V2 DB cluster. This property is only supported for Aurora Serverless v2. For Aurora Serverless v1, Use the ``ScalingConfiguration`` property. Valid for: Aurora Serverless v2 DB clusters only
5537
5554
  :param snapshot_identifier: The identifier for the DB snapshot or DB cluster snapshot to restore from. You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB snapshot. After you restore a DB cluster with a ``SnapshotIdentifier`` property, you must specify the same ``SnapshotIdentifier`` property for any future updates to the DB cluster. When you specify this property for an update, the DB cluster is not restored from the snapshot again, and the data in the database is not changed. However, if you don't specify the ``SnapshotIdentifier`` property, an empty DB cluster is created, and the original DB cluster is deleted. If you specify a property that is different from the previous snapshot restore property, a new DB cluster is restored from the specified ``SnapshotIdentifier`` property, and the original DB cluster is deleted. If you specify the ``SnapshotIdentifier`` property to restore a DB cluster (as opposed to specifying it for DB cluster updates), then don't specify the following properties: - ``GlobalClusterIdentifier`` - ``MasterUsername`` - ``MasterUserPassword`` - ``ReplicationSourceIdentifier`` - ``RestoreType`` - ``SourceDBClusterIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an encrypted snapshot) - ``UseLatestRestorableTime`` Constraints: - Must match the identifier of an existing Snapshot. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5538
- :param source_db_cluster_identifier: When restoring a DB cluster to a point in time, the identifier of the source DB cluster from which to restore. Constraints: - Must match the identifier of an existing DBCluster. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5555
+ :param source_db_cluster_identifier: When restoring a DB cluster to a point in time, the identifier of the source DB cluster from which to restore. Constraints: - Must match the identifier of an existing DBCluster. - Cannot be specified if ``SourceDbClusterResourceId`` is specified. You must specify either ``SourceDBClusterIdentifier`` or ``SourceDbClusterResourceId`` , but not both. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5539
5556
  :param source_region: The AWS Region which contains the source DB cluster when replicating a DB cluster. For example, ``us-east-1`` . Valid for: Aurora DB clusters only
5540
5557
  :param storage_encrypted: Indicates whether the DB cluster is encrypted. If you specify the ``KmsKeyId`` property, then you must enable encryption. If you specify the ``SourceDBClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, and if the DB cluster is encrypted, the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot is encrypted, don't specify this property. The value is inherited from the snapshot, and the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot isn't encrypted, you can use this property to specify that the restored DB cluster is encrypted. Specify the ``KmsKeyId`` property for the KMS key to use for encryption. If you don't want the restored DB cluster to be encrypted, then don't set this property or set it to ``false`` . .. epigraph:: If you specify both the ``StorageEncrypted`` and ``SnapshotIdentifier`` properties without specifying the ``KmsKeyId`` property, then the restored DB cluster inherits the encryption settings from the DB snapshot that provide. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5541
5558
  :param storage_type: The storage type to associate with the DB cluster. For information on storage types for Aurora DB clusters, see `Storage configurations for Amazon Aurora DB clusters <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.StorageReliability.html#aurora-storage-type>`_ . For information on storage types for Multi-AZ DB clusters, see `Settings for creating Multi-AZ DB clusters <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/create-multi-az-db-cluster.html#create-multi-az-db-cluster-settings>`_ . This setting is required to create a Multi-AZ DB cluster. When specified for a Multi-AZ DB cluster, a value for the ``Iops`` parameter is required. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - Aurora DB clusters - ``aurora | aurora-iopt1`` - Multi-AZ DB clusters - ``io1 | io2 | gp3`` Default: - Aurora DB clusters - ``aurora`` - Multi-AZ DB clusters - ``io1`` .. epigraph:: When you create an Aurora DB cluster with the storage type set to ``aurora-iopt1`` , the storage type is returned in the response. The storage type isn't returned when you set it to ``aurora`` .
@@ -5564,6 +5581,7 @@ class CfnDBCluster(
5564
5581
  db_instance_parameter_group_name=db_instance_parameter_group_name,
5565
5582
  db_subnet_group_name=db_subnet_group_name,
5566
5583
  db_system_id=db_system_id,
5584
+ delete_automated_backups=delete_automated_backups,
5567
5585
  deletion_protection=deletion_protection,
5568
5586
  domain=domain,
5569
5587
  domain_iam_role_name=domain_iam_role_name,
@@ -5986,6 +6004,24 @@ class CfnDBCluster(
5986
6004
  check_type(argname="argument value", value=value, expected_type=type_hints["value"])
5987
6005
  jsii.set(self, "dbSystemId", value) # pyright: ignore[reportArgumentType]
5988
6006
 
6007
+ @builtins.property
6008
+ @jsii.member(jsii_name="deleteAutomatedBackups")
6009
+ def delete_automated_backups(
6010
+ self,
6011
+ ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
6012
+ '''Specifies whether to remove automated backups immediately after the DB cluster is deleted.'''
6013
+ return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "deleteAutomatedBackups"))
6014
+
6015
+ @delete_automated_backups.setter
6016
+ def delete_automated_backups(
6017
+ self,
6018
+ value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
6019
+ ) -> None:
6020
+ if __debug__:
6021
+ type_hints = typing.get_type_hints(_typecheckingstub__9e8a2ba2ab46cead449dbe97283d45de5dd8c86ea7d68521f70c997f8eb39235)
6022
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
6023
+ jsii.set(self, "deleteAutomatedBackups", value) # pyright: ignore[reportArgumentType]
6024
+
5989
6025
  @builtins.property
5990
6026
  @jsii.member(jsii_name="deletionProtection")
5991
6027
  def deletion_protection(
@@ -7569,6 +7605,7 @@ class CfnDBClusterParameterGroupProps:
7569
7605
  "db_instance_parameter_group_name": "dbInstanceParameterGroupName",
7570
7606
  "db_subnet_group_name": "dbSubnetGroupName",
7571
7607
  "db_system_id": "dbSystemId",
7608
+ "delete_automated_backups": "deleteAutomatedBackups",
7572
7609
  "deletion_protection": "deletionProtection",
7573
7610
  "domain": "domain",
7574
7611
  "domain_iam_role_name": "domainIamRoleName",
@@ -7633,6 +7670,7 @@ class CfnDBClusterProps:
7633
7670
  db_instance_parameter_group_name: typing.Optional[builtins.str] = None,
7634
7671
  db_subnet_group_name: typing.Optional[builtins.str] = None,
7635
7672
  db_system_id: typing.Optional[builtins.str] = None,
7673
+ delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
7636
7674
  deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
7637
7675
  domain: typing.Optional[builtins.str] = None,
7638
7676
  domain_iam_role_name: typing.Optional[builtins.str] = None,
@@ -7684,7 +7722,7 @@ class CfnDBClusterProps:
7684
7722
  :param availability_zones: A list of Availability Zones (AZs) where instances in the DB cluster can be created. For information on AWS Regions and Availability Zones, see `Choosing the Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters only
7685
7723
  :param backtrack_window: The target backtrack window, in seconds. To disable backtracking, set this value to ``0`` . Valid for Cluster Type: Aurora MySQL DB clusters only Default: ``0`` Constraints: - If specified, this value must be set to a number from 0 to 259,200 (72 hours).
7686
7724
  :param backup_retention_period: The number of days for which automated backups are retained. Default: 1 Constraints: - Must be a value from 1 to 35 Valid for: Aurora DB clusters and Multi-AZ DB clusters Default: - 1
7687
- :param cluster_scalability_type: Specifies the scalability mode of the Aurora DB cluster. When set to ``limitless`` , the cluster operates as an Aurora Limitless Database, allowing you to create a DB shard group for horizontal scaling (sharding) capabilities. When set to ``standard`` (the default), the cluster uses normal DB instance creation.
7725
+ :param cluster_scalability_type: Specifies the scalability mode of the Aurora DB cluster. When set to ``limitless`` , the cluster operates as an Aurora Limitless Database, allowing you to create a DB shard group for horizontal scaling (sharding) capabilities. When set to ``standard`` (the default), the cluster uses normal DB instance creation. *Important:* Automated backup retention isn't supported with Aurora Limitless Database clusters. If you set this property to ``limitless`` , you cannot set ``DeleteAutomatedBackups`` to ``false`` . To create a backup, use manual snapshots instead.
7688
7726
  :param copy_tags_to_snapshot: A value that indicates whether to copy all tags from the DB cluster to snapshots of the DB cluster. The default is not to copy them. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7689
7727
  :param database_insights_mode: The mode of Database Insights to enable for the DB cluster. If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
7690
7728
  :param database_name: The name of your database. If you don't provide a name, then Amazon RDS won't create a database in this DB cluster. For naming constraints, see `Naming Constraints <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_Limits.html#RDS_Limits.Constraints>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -7694,6 +7732,7 @@ class CfnDBClusterProps:
7694
7732
  :param db_instance_parameter_group_name: The name of the DB parameter group to apply to all instances of the DB cluster. .. epigraph:: When you apply a parameter group using the ``DBInstanceParameterGroupName`` parameter, the DB cluster isn't rebooted automatically. Also, parameter changes are applied immediately rather than during the next maintenance window. Valid for Cluster Type: Aurora DB clusters only Default: The existing name setting Constraints: - The DB parameter group must be in the same DB parameter group family as this DB cluster. - The ``DBInstanceParameterGroupName`` parameter is valid in combination with the ``AllowMajorVersionUpgrade`` parameter for a major version upgrade only.
7695
7733
  :param db_subnet_group_name: A DB subnet group that you want to associate with this DB cluster. If you are restoring a DB cluster to a point in time with ``RestoreType`` set to ``copy-on-write`` , and don't specify a DB subnet group name, then the DB cluster is restored with a default DB subnet group. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7696
7734
  :param db_system_id: Reserved for future use.
7735
+ :param delete_automated_backups: Specifies whether to remove automated backups immediately after the DB cluster is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB cluster is deleted, unless the AWS Backup policy specifies a point-in-time restore rule.
7697
7736
  :param deletion_protection: A value that indicates whether the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection is disabled. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7698
7737
  :param domain: Indicates the directory ID of the Active Directory to create the DB cluster. For Amazon Aurora DB clusters, Amazon RDS can use Kerberos authentication to authenticate users that connect to the DB cluster. For more information, see `Kerberos authentication <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters only
7699
7738
  :param domain_iam_role_name: Specifies the name of the IAM role to use when making API calls to the Directory Service. Valid for: Aurora DB clusters only
@@ -7729,7 +7768,7 @@ class CfnDBClusterProps:
7729
7768
  :param scaling_configuration: The scaling configuration of an Aurora Serverless v1 DB cluster. This property is only supported for Aurora Serverless v1. For Aurora Serverless v2, Use the ``ServerlessV2ScalingConfiguration`` property. Valid for: Aurora Serverless v1 DB clusters only
7730
7769
  :param serverless_v2_scaling_configuration: The scaling configuration of an Aurora Serverless V2 DB cluster. This property is only supported for Aurora Serverless v2. For Aurora Serverless v1, Use the ``ScalingConfiguration`` property. Valid for: Aurora Serverless v2 DB clusters only
7731
7770
  :param snapshot_identifier: The identifier for the DB snapshot or DB cluster snapshot to restore from. You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB snapshot. After you restore a DB cluster with a ``SnapshotIdentifier`` property, you must specify the same ``SnapshotIdentifier`` property for any future updates to the DB cluster. When you specify this property for an update, the DB cluster is not restored from the snapshot again, and the data in the database is not changed. However, if you don't specify the ``SnapshotIdentifier`` property, an empty DB cluster is created, and the original DB cluster is deleted. If you specify a property that is different from the previous snapshot restore property, a new DB cluster is restored from the specified ``SnapshotIdentifier`` property, and the original DB cluster is deleted. If you specify the ``SnapshotIdentifier`` property to restore a DB cluster (as opposed to specifying it for DB cluster updates), then don't specify the following properties: - ``GlobalClusterIdentifier`` - ``MasterUsername`` - ``MasterUserPassword`` - ``ReplicationSourceIdentifier`` - ``RestoreType`` - ``SourceDBClusterIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an encrypted snapshot) - ``UseLatestRestorableTime`` Constraints: - Must match the identifier of an existing Snapshot. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7732
- :param source_db_cluster_identifier: When restoring a DB cluster to a point in time, the identifier of the source DB cluster from which to restore. Constraints: - Must match the identifier of an existing DBCluster. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7771
+ :param source_db_cluster_identifier: When restoring a DB cluster to a point in time, the identifier of the source DB cluster from which to restore. Constraints: - Must match the identifier of an existing DBCluster. - Cannot be specified if ``SourceDbClusterResourceId`` is specified. You must specify either ``SourceDBClusterIdentifier`` or ``SourceDbClusterResourceId`` , but not both. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7733
7772
  :param source_region: The AWS Region which contains the source DB cluster when replicating a DB cluster. For example, ``us-east-1`` . Valid for: Aurora DB clusters only
7734
7773
  :param storage_encrypted: Indicates whether the DB cluster is encrypted. If you specify the ``KmsKeyId`` property, then you must enable encryption. If you specify the ``SourceDBClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, and if the DB cluster is encrypted, the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot is encrypted, don't specify this property. The value is inherited from the snapshot, and the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot isn't encrypted, you can use this property to specify that the restored DB cluster is encrypted. Specify the ``KmsKeyId`` property for the KMS key to use for encryption. If you don't want the restored DB cluster to be encrypted, then don't set this property or set it to ``false`` . .. epigraph:: If you specify both the ``StorageEncrypted`` and ``SnapshotIdentifier`` properties without specifying the ``KmsKeyId`` property, then the restored DB cluster inherits the encryption settings from the DB snapshot that provide. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7735
7774
  :param storage_type: The storage type to associate with the DB cluster. For information on storage types for Aurora DB clusters, see `Storage configurations for Amazon Aurora DB clusters <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.StorageReliability.html#aurora-storage-type>`_ . For information on storage types for Multi-AZ DB clusters, see `Settings for creating Multi-AZ DB clusters <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/create-multi-az-db-cluster.html#create-multi-az-db-cluster-settings>`_ . This setting is required to create a Multi-AZ DB cluster. When specified for a Multi-AZ DB cluster, a value for the ``Iops`` parameter is required. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - Aurora DB clusters - ``aurora | aurora-iopt1`` - Multi-AZ DB clusters - ``io1 | io2 | gp3`` Default: - Aurora DB clusters - ``aurora`` - Multi-AZ DB clusters - ``io1`` .. epigraph:: When you create an Aurora DB cluster with the storage type set to ``aurora-iopt1`` , the storage type is returned in the response. The storage type isn't returned when you set it to ``aurora`` .
@@ -7768,6 +7807,7 @@ class CfnDBClusterProps:
7768
7807
  db_instance_parameter_group_name="dbInstanceParameterGroupName",
7769
7808
  db_subnet_group_name="dbSubnetGroupName",
7770
7809
  db_system_id="dbSystemId",
7810
+ delete_automated_backups=False,
7771
7811
  deletion_protection=False,
7772
7812
  domain="domain",
7773
7813
  domain_iam_role_name="domainIamRoleName",
@@ -7847,6 +7887,7 @@ class CfnDBClusterProps:
7847
7887
  check_type(argname="argument db_instance_parameter_group_name", value=db_instance_parameter_group_name, expected_type=type_hints["db_instance_parameter_group_name"])
7848
7888
  check_type(argname="argument db_subnet_group_name", value=db_subnet_group_name, expected_type=type_hints["db_subnet_group_name"])
7849
7889
  check_type(argname="argument db_system_id", value=db_system_id, expected_type=type_hints["db_system_id"])
7890
+ check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
7850
7891
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
7851
7892
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
7852
7893
  check_type(argname="argument domain_iam_role_name", value=domain_iam_role_name, expected_type=type_hints["domain_iam_role_name"])
@@ -7922,6 +7963,8 @@ class CfnDBClusterProps:
7922
7963
  self._values["db_subnet_group_name"] = db_subnet_group_name
7923
7964
  if db_system_id is not None:
7924
7965
  self._values["db_system_id"] = db_system_id
7966
+ if delete_automated_backups is not None:
7967
+ self._values["delete_automated_backups"] = delete_automated_backups
7925
7968
  if deletion_protection is not None:
7926
7969
  self._values["deletion_protection"] = deletion_protection
7927
7970
  if domain is not None:
@@ -8107,6 +8150,8 @@ class CfnDBClusterProps:
8107
8150
 
8108
8151
  When set to ``limitless`` , the cluster operates as an Aurora Limitless Database, allowing you to create a DB shard group for horizontal scaling (sharding) capabilities. When set to ``standard`` (the default), the cluster uses normal DB instance creation.
8109
8152
 
8153
+ *Important:* Automated backup retention isn't supported with Aurora Limitless Database clusters. If you set this property to ``limitless`` , you cannot set ``DeleteAutomatedBackups`` to ``false`` . To create a backup, use manual snapshots instead.
8154
+
8110
8155
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-clusterscalabilitytype
8111
8156
  '''
8112
8157
  result = self._values.get("cluster_scalability_type")
@@ -8252,6 +8297,19 @@ class CfnDBClusterProps:
8252
8297
  result = self._values.get("db_system_id")
8253
8298
  return typing.cast(typing.Optional[builtins.str], result)
8254
8299
 
8300
+ @builtins.property
8301
+ def delete_automated_backups(
8302
+ self,
8303
+ ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
8304
+ '''Specifies whether to remove automated backups immediately after the DB cluster is deleted.
8305
+
8306
+ This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB cluster is deleted, unless the AWS Backup policy specifies a point-in-time restore rule.
8307
+
8308
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-deleteautomatedbackups
8309
+ '''
8310
+ result = self._values.get("delete_automated_backups")
8311
+ return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
8312
+
8255
8313
  @builtins.property
8256
8314
  def deletion_protection(
8257
8315
  self,
@@ -8925,6 +8983,7 @@ class CfnDBClusterProps:
8925
8983
  Constraints:
8926
8984
 
8927
8985
  - Must match the identifier of an existing DBCluster.
8986
+ - Cannot be specified if ``SourceDbClusterResourceId`` is specified. You must specify either ``SourceDBClusterIdentifier`` or ``SourceDbClusterResourceId`` , but not both.
8928
8987
 
8929
8988
  Valid for: Aurora DB clusters and Multi-AZ DB clusters
8930
8989
 
@@ -9302,7 +9361,7 @@ class CfnDBInstance(
9302
9361
  :param auto_minor_version_upgrade: A value that indicates whether minor engine upgrades are applied automatically to the DB instance during the maintenance window. By default, minor engine upgrades are applied automatically.
9303
9362
  :param availability_zone: The Availability Zone (AZ) where the database will be created. For information on AWS Regions and Availability Zones, see `Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ . For Amazon Aurora, each Aurora DB cluster hosts copies of its storage in three separate Availability Zones. Specify one of these Availability Zones. Aurora automatically chooses an appropriate Availability Zone if you don't specify one. Default: A random, system-chosen Availability Zone in the endpoint's AWS Region . Constraints: - The ``AvailabilityZone`` parameter can't be specified if the DB instance is a Multi-AZ deployment. - The specified Availability Zone must be in the same AWS Region as the current endpoint. Example: ``us-east-1d``
9304
9363
  :param backup_retention_period: The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups. *Amazon Aurora* Not applicable. The retention period for automated backups is managed by the DB cluster. Default: 1 Constraints: - Must be a value from 0 to 35 - Can't be set to 0 if the DB instance is a source to read replicas
9305
- :param backup_target:
9364
+ :param backup_target: The location for storing automated backups and manual snapshots. Valid Values: - ``local`` (Dedicated Local Zone) - ``outposts`` ( AWS Outposts) - ``region`` ( AWS Region ) Default: ``region`` For more information, see `Working with Amazon RDS on AWS Outposts <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html>`_ in the *Amazon RDS User Guide* .
9306
9365
  :param ca_certificate_identifier: The identifier of the CA certificate for this DB instance. For more information, see `Using SSL/TLS to encrypt a connection to a DB instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon RDS User Guide* and `Using SSL/TLS to encrypt a connection to a DB cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon Aurora User Guide* .
9307
9366
  :param certificate_rotation_restart: Specifies whether the DB instance is restarted when you rotate your SSL/TLS certificate. By default, the DB instance is restarted when you rotate your SSL/TLS certificate. The certificate is not updated until the DB instance is restarted. .. epigraph:: Set this parameter only if you are *not* using SSL/TLS to connect to the DB instance. If you are using SSL/TLS to connect to the DB instance, follow the appropriate instructions for your DB engine to rotate your SSL/TLS certificate: - For more information about rotating your SSL/TLS certificate for RDS DB engines, see `Rotating Your SSL/TLS Certificate. <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html>`_ in the *Amazon RDS User Guide.* - For more information about rotating your SSL/TLS certificate for Aurora DB engines, see `Rotating Your SSL/TLS Certificate <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html>`_ in the *Amazon Aurora User Guide* . This setting doesn't apply to RDS Custom DB instances.
9308
9367
  :param character_set_name: For supported engines, indicates that the DB instance should be associated with the specified character set. *Amazon Aurora* Not applicable. The character set is managed by the DB cluster. For more information, see `AWS::RDS::DBCluster <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html>`_ .
@@ -9532,6 +9591,15 @@ class CfnDBInstance(
9532
9591
  '''
9533
9592
  return typing.cast(builtins.str, jsii.get(self, "attrDbInstanceArn"))
9534
9593
 
9594
+ @builtins.property
9595
+ @jsii.member(jsii_name="attrDbInstanceStatus")
9596
+ def attr_db_instance_status(self) -> builtins.str:
9597
+ '''The current state of this DB instance.
9598
+
9599
+ :cloudformationAttribute: DBInstanceStatus
9600
+ '''
9601
+ return typing.cast(builtins.str, jsii.get(self, "attrDbInstanceStatus"))
9602
+
9535
9603
  @builtins.property
9536
9604
  @jsii.member(jsii_name="attrDbiResourceId")
9537
9605
  def attr_dbi_resource_id(self) -> builtins.str:
@@ -9604,6 +9672,77 @@ class CfnDBInstance(
9604
9672
  '''
9605
9673
  return typing.cast(builtins.str, jsii.get(self, "attrEndpointPort"))
9606
9674
 
9675
+ @builtins.property
9676
+ @jsii.member(jsii_name="attrInstanceCreateTime")
9677
+ def attr_instance_create_time(self) -> builtins.str:
9678
+ '''The date and time when the DB instance was created.
9679
+
9680
+ :cloudformationAttribute: InstanceCreateTime
9681
+ '''
9682
+ return typing.cast(builtins.str, jsii.get(self, "attrInstanceCreateTime"))
9683
+
9684
+ @builtins.property
9685
+ @jsii.member(jsii_name="attrIsStorageConfigUpgradeAvailable")
9686
+ def attr_is_storage_config_upgrade_available(self) -> _IResolvable_da3f097b:
9687
+ '''Indicates whether an upgrade is recommended for the storage file system configuration on the DB instance.
9688
+
9689
+ :cloudformationAttribute: IsStorageConfigUpgradeAvailable
9690
+ '''
9691
+ return typing.cast(_IResolvable_da3f097b, jsii.get(self, "attrIsStorageConfigUpgradeAvailable"))
9692
+
9693
+ @builtins.property
9694
+ @jsii.member(jsii_name="attrLatestRestorableTime")
9695
+ def attr_latest_restorable_time(self) -> builtins.str:
9696
+ '''The latest time to which a database in this DB instance can be restored with point-in-time restore.
9697
+
9698
+ :cloudformationAttribute: LatestRestorableTime
9699
+ '''
9700
+ return typing.cast(builtins.str, jsii.get(self, "attrLatestRestorableTime"))
9701
+
9702
+ @builtins.property
9703
+ @jsii.member(jsii_name="attrListenerEndpoint")
9704
+ def attr_listener_endpoint(self) -> _IResolvable_da3f097b:
9705
+ '''This data type represents the information you need to connect to an Amazon RDS DB instance.
9706
+
9707
+ This data type is used as a response element in the following actions:
9708
+
9709
+ - ``CreateDBInstance``
9710
+ - ``DescribeDBInstances``
9711
+ - ``DeleteDBInstance``
9712
+
9713
+ For the data structure that represents Amazon Aurora DB cluster endpoints, see ``DBClusterEndpoint``.
9714
+
9715
+ :cloudformationAttribute: ListenerEndpoint
9716
+ '''
9717
+ return typing.cast(_IResolvable_da3f097b, jsii.get(self, "attrListenerEndpoint"))
9718
+
9719
+ @builtins.property
9720
+ @jsii.member(jsii_name="attrListenerEndpointAddress")
9721
+ def attr_listener_endpoint_address(self) -> builtins.str:
9722
+ '''Specifies the DNS address of the DB instance.
9723
+
9724
+ :cloudformationAttribute: ListenerEndpoint.Address
9725
+ '''
9726
+ return typing.cast(builtins.str, jsii.get(self, "attrListenerEndpointAddress"))
9727
+
9728
+ @builtins.property
9729
+ @jsii.member(jsii_name="attrListenerEndpointHostedZoneId")
9730
+ def attr_listener_endpoint_hosted_zone_id(self) -> builtins.str:
9731
+ '''Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.
9732
+
9733
+ :cloudformationAttribute: ListenerEndpoint.HostedZoneId
9734
+ '''
9735
+ return typing.cast(builtins.str, jsii.get(self, "attrListenerEndpointHostedZoneId"))
9736
+
9737
+ @builtins.property
9738
+ @jsii.member(jsii_name="attrListenerEndpointPort")
9739
+ def attr_listener_endpoint_port(self) -> builtins.str:
9740
+ '''Specifies the port that the database engine is listening on.
9741
+
9742
+ :cloudformationAttribute: ListenerEndpoint.Port
9743
+ '''
9744
+ return typing.cast(builtins.str, jsii.get(self, "attrListenerEndpointPort"))
9745
+
9607
9746
  @builtins.property
9608
9747
  @jsii.member(jsii_name="attrMasterUserSecretSecretArn")
9609
9748
  def attr_master_user_secret_secret_arn(self) -> builtins.str:
@@ -9615,6 +9754,24 @@ class CfnDBInstance(
9615
9754
  '''
9616
9755
  return typing.cast(builtins.str, jsii.get(self, "attrMasterUserSecretSecretArn"))
9617
9756
 
9757
+ @builtins.property
9758
+ @jsii.member(jsii_name="attrReadReplicaDbClusterIdentifiers")
9759
+ def attr_read_replica_db_cluster_identifiers(self) -> typing.List[builtins.str]:
9760
+ '''The identifiers of Aurora DB clusters to which the RDS DB instance is replicated as a read replica.
9761
+
9762
+ :cloudformationAttribute: ReadReplicaDBClusterIdentifiers
9763
+ '''
9764
+ return typing.cast(typing.List[builtins.str], jsii.get(self, "attrReadReplicaDbClusterIdentifiers"))
9765
+
9766
+ @builtins.property
9767
+ @jsii.member(jsii_name="attrReadReplicaDbInstanceIdentifiers")
9768
+ def attr_read_replica_db_instance_identifiers(self) -> typing.List[builtins.str]:
9769
+ '''The identifiers of the read replicas associated with this DB instance.
9770
+
9771
+ :cloudformationAttribute: ReadReplicaDBInstanceIdentifiers
9772
+ '''
9773
+ return typing.cast(typing.List[builtins.str], jsii.get(self, "attrReadReplicaDbInstanceIdentifiers"))
9774
+
9618
9775
  @builtins.property
9619
9776
  @jsii.member(jsii_name="cfnProperties")
9620
9777
  def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
@@ -9790,6 +9947,7 @@ class CfnDBInstance(
9790
9947
  @builtins.property
9791
9948
  @jsii.member(jsii_name="backupTarget")
9792
9949
  def backup_target(self) -> typing.Optional[builtins.str]:
9950
+ '''The location for storing automated backups and manual snapshots.'''
9793
9951
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "backupTarget"))
9794
9952
 
9795
9953
  @backup_target.setter
@@ -11404,7 +11562,7 @@ class CfnDBInstanceProps:
11404
11562
  :param auto_minor_version_upgrade: A value that indicates whether minor engine upgrades are applied automatically to the DB instance during the maintenance window. By default, minor engine upgrades are applied automatically.
11405
11563
  :param availability_zone: The Availability Zone (AZ) where the database will be created. For information on AWS Regions and Availability Zones, see `Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ . For Amazon Aurora, each Aurora DB cluster hosts copies of its storage in three separate Availability Zones. Specify one of these Availability Zones. Aurora automatically chooses an appropriate Availability Zone if you don't specify one. Default: A random, system-chosen Availability Zone in the endpoint's AWS Region . Constraints: - The ``AvailabilityZone`` parameter can't be specified if the DB instance is a Multi-AZ deployment. - The specified Availability Zone must be in the same AWS Region as the current endpoint. Example: ``us-east-1d``
11406
11564
  :param backup_retention_period: The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups. *Amazon Aurora* Not applicable. The retention period for automated backups is managed by the DB cluster. Default: 1 Constraints: - Must be a value from 0 to 35 - Can't be set to 0 if the DB instance is a source to read replicas
11407
- :param backup_target:
11565
+ :param backup_target: The location for storing automated backups and manual snapshots. Valid Values: - ``local`` (Dedicated Local Zone) - ``outposts`` ( AWS Outposts) - ``region`` ( AWS Region ) Default: ``region`` For more information, see `Working with Amazon RDS on AWS Outposts <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html>`_ in the *Amazon RDS User Guide* .
11408
11566
  :param ca_certificate_identifier: The identifier of the CA certificate for this DB instance. For more information, see `Using SSL/TLS to encrypt a connection to a DB instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon RDS User Guide* and `Using SSL/TLS to encrypt a connection to a DB cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html>`_ in the *Amazon Aurora User Guide* .
11409
11567
  :param certificate_rotation_restart: Specifies whether the DB instance is restarted when you rotate your SSL/TLS certificate. By default, the DB instance is restarted when you rotate your SSL/TLS certificate. The certificate is not updated until the DB instance is restarted. .. epigraph:: Set this parameter only if you are *not* using SSL/TLS to connect to the DB instance. If you are using SSL/TLS to connect to the DB instance, follow the appropriate instructions for your DB engine to rotate your SSL/TLS certificate: - For more information about rotating your SSL/TLS certificate for RDS DB engines, see `Rotating Your SSL/TLS Certificate. <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html>`_ in the *Amazon RDS User Guide.* - For more information about rotating your SSL/TLS certificate for Aurora DB engines, see `Rotating Your SSL/TLS Certificate <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html>`_ in the *Amazon Aurora User Guide* . This setting doesn't apply to RDS Custom DB instances.
11410
11568
  :param character_set_name: For supported engines, indicates that the DB instance should be associated with the specified character set. *Amazon Aurora* Not applicable. The character set is managed by the DB cluster. For more information, see `AWS::RDS::DBCluster <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html>`_ .
@@ -12039,7 +12197,18 @@ class CfnDBInstanceProps:
12039
12197
 
12040
12198
  @builtins.property
12041
12199
  def backup_target(self) -> typing.Optional[builtins.str]:
12042
- '''
12200
+ '''The location for storing automated backups and manual snapshots.
12201
+
12202
+ Valid Values:
12203
+
12204
+ - ``local`` (Dedicated Local Zone)
12205
+ - ``outposts`` ( AWS Outposts)
12206
+ - ``region`` ( AWS Region )
12207
+
12208
+ Default: ``region``
12209
+
12210
+ For more information, see `Working with Amazon RDS on AWS Outposts <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html>`_ in the *Amazon RDS User Guide* .
12211
+
12043
12212
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-backuptarget
12044
12213
  '''
12045
12214
  result = self._values.get("backup_target")
@@ -23457,7 +23626,7 @@ class DatabaseClusterProps:
23457
23626
 
23458
23627
  @jsii.enum(jsii_type="aws-cdk-lib.aws_rds.DatabaseInsightsMode")
23459
23628
  class DatabaseInsightsMode(enum.Enum):
23460
- '''The database insights mode of the Aurora DB cluster.
23629
+ '''The database insights mode.
23461
23630
 
23462
23631
  :exampleMetadata: infused
23463
23632
 
@@ -23950,6 +24119,7 @@ class DatabaseInstanceLookupOptions:
23950
24119
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
23951
24120
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
23952
24121
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
24122
+ "database_insights_mode": "databaseInsightsMode",
23953
24123
  "delete_automated_backups": "deleteAutomatedBackups",
23954
24124
  "deletion_protection": "deletionProtection",
23955
24125
  "domain": "domain",
@@ -23999,6 +24169,7 @@ class DatabaseInstanceNewProps:
23999
24169
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
24000
24170
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
24001
24171
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
24172
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
24002
24173
  delete_automated_backups: typing.Optional[builtins.bool] = None,
24003
24174
  deletion_protection: typing.Optional[builtins.bool] = None,
24004
24175
  domain: typing.Optional[builtins.str] = None,
@@ -24045,6 +24216,7 @@ class DatabaseInstanceNewProps:
24045
24216
  :param cloudwatch_logs_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``Infinity``. Default: - logs never expire
24046
24217
  :param cloudwatch_logs_retention_role: The IAM role for the Lambda function associated with the custom resource that sets the retention policy. Default: - a new role is created.
24047
24218
  :param copy_tags_to_snapshot: Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance. Default: true
24219
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
24048
24220
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
24049
24221
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
24050
24222
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -24062,7 +24234,7 @@ class DatabaseInstanceNewProps:
24062
24234
  :param option_group: The option group to associate with the instance. Default: - no option group
24063
24235
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
24064
24236
  :param performance_insight_encryption_key: The AWS KMS key for encryption of Performance Insights data. Default: - default master key
24065
- :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. Default: 7 this is the free tier
24237
+ :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``. Default: 7 this is the free tier
24066
24238
  :param port: The port for the instance. Default: - the default port for the chosen engine.
24067
24239
  :param preferred_backup_window: The daily time range during which automated backups are performed. 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. Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
24068
24240
  :param preferred_maintenance_window: The weekly time range (in UTC) during which system maintenance can occur. Format: ``ddd:hh24:mi-ddd:hh24:mi`` Constraint: Minimum 30-minute window Default: - 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 https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
@@ -24118,6 +24290,7 @@ class DatabaseInstanceNewProps:
24118
24290
  cloudwatch_logs_retention=logs.RetentionDays.ONE_DAY,
24119
24291
  cloudwatch_logs_retention_role=role,
24120
24292
  copy_tags_to_snapshot=False,
24293
+ database_insights_mode=rds.DatabaseInsightsMode.STANDARD,
24121
24294
  delete_automated_backups=False,
24122
24295
  deletion_protection=False,
24123
24296
  domain="domain",
@@ -24179,6 +24352,7 @@ class DatabaseInstanceNewProps:
24179
24352
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
24180
24353
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
24181
24354
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
24355
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
24182
24356
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
24183
24357
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
24184
24358
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -24233,6 +24407,8 @@ class DatabaseInstanceNewProps:
24233
24407
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
24234
24408
  if copy_tags_to_snapshot is not None:
24235
24409
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
24410
+ if database_insights_mode is not None:
24411
+ self._values["database_insights_mode"] = database_insights_mode
24236
24412
  if delete_automated_backups is not None:
24237
24413
  self._values["delete_automated_backups"] = delete_automated_backups
24238
24414
  if deletion_protection is not None:
@@ -24411,6 +24587,15 @@ class DatabaseInstanceNewProps:
24411
24587
  result = self._values.get("copy_tags_to_snapshot")
24412
24588
  return typing.cast(typing.Optional[builtins.bool], result)
24413
24589
 
24590
+ @builtins.property
24591
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
24592
+ '''The database insights mode.
24593
+
24594
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
24595
+ '''
24596
+ result = self._values.get("database_insights_mode")
24597
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
24598
+
24414
24599
  @builtins.property
24415
24600
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
24416
24601
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -24589,6 +24774,8 @@ class DatabaseInstanceNewProps:
24589
24774
  ) -> typing.Optional["PerformanceInsightRetention"]:
24590
24775
  '''The amount of time, in days, to retain Performance Insights data.
24591
24776
 
24777
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
24778
+
24592
24779
  :default: 7 this is the free tier
24593
24780
  '''
24594
24781
  result = self._values.get("performance_insight_retention")
@@ -24822,6 +25009,7 @@ class DatabaseInstanceNewProps:
24822
25009
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
24823
25010
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
24824
25011
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
25012
+ "database_insights_mode": "databaseInsightsMode",
24825
25013
  "delete_automated_backups": "deleteAutomatedBackups",
24826
25014
  "deletion_protection": "deletionProtection",
24827
25015
  "domain": "domain",
@@ -24876,6 +25064,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24876
25064
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
24877
25065
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
24878
25066
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
25067
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
24879
25068
  delete_automated_backups: typing.Optional[builtins.bool] = None,
24880
25069
  deletion_protection: typing.Optional[builtins.bool] = None,
24881
25070
  domain: typing.Optional[builtins.str] = None,
@@ -24927,6 +25116,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24927
25116
  :param cloudwatch_logs_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``Infinity``. Default: - logs never expire
24928
25117
  :param cloudwatch_logs_retention_role: The IAM role for the Lambda function associated with the custom resource that sets the retention policy. Default: - a new role is created.
24929
25118
  :param copy_tags_to_snapshot: Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance. Default: true
25119
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
24930
25120
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
24931
25121
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
24932
25122
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -24944,7 +25134,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24944
25134
  :param option_group: The option group to associate with the instance. Default: - no option group
24945
25135
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
24946
25136
  :param performance_insight_encryption_key: The AWS KMS key for encryption of Performance Insights data. Default: - default master key
24947
- :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. Default: 7 this is the free tier
25137
+ :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``. Default: 7 this is the free tier
24948
25138
  :param port: The port for the instance. Default: - the default port for the chosen engine.
24949
25139
  :param preferred_backup_window: The daily time range during which automated backups are performed. 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. Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
24950
25140
  :param preferred_maintenance_window: The weekly time range (in UTC) during which system maintenance can occur. Format: ``ddd:hh24:mi-ddd:hh24:mi`` Constraint: Minimum 30-minute window Default: - 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 https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
@@ -25003,6 +25193,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25003
25193
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
25004
25194
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
25005
25195
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
25196
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
25006
25197
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
25007
25198
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
25008
25199
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -25064,6 +25255,8 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25064
25255
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
25065
25256
  if copy_tags_to_snapshot is not None:
25066
25257
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
25258
+ if database_insights_mode is not None:
25259
+ self._values["database_insights_mode"] = database_insights_mode
25067
25260
  if delete_automated_backups is not None:
25068
25261
  self._values["delete_automated_backups"] = delete_automated_backups
25069
25262
  if deletion_protection is not None:
@@ -25248,6 +25441,15 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25248
25441
  result = self._values.get("copy_tags_to_snapshot")
25249
25442
  return typing.cast(typing.Optional[builtins.bool], result)
25250
25443
 
25444
+ @builtins.property
25445
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
25446
+ '''The database insights mode.
25447
+
25448
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
25449
+ '''
25450
+ result = self._values.get("database_insights_mode")
25451
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
25452
+
25251
25453
  @builtins.property
25252
25454
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
25253
25455
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -25426,6 +25628,8 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25426
25628
  ) -> typing.Optional["PerformanceInsightRetention"]:
25427
25629
  '''The amount of time, in days, to retain Performance Insights data.
25428
25630
 
25631
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
25632
+
25429
25633
  :default: 7 this is the free tier
25430
25634
  '''
25431
25635
  result = self._values.get("performance_insight_retention")
@@ -25704,6 +25908,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25704
25908
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
25705
25909
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
25706
25910
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
25911
+ "database_insights_mode": "databaseInsightsMode",
25707
25912
  "delete_automated_backups": "deleteAutomatedBackups",
25708
25913
  "deletion_protection": "deletionProtection",
25709
25914
  "domain": "domain",
@@ -25761,6 +25966,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25761
25966
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
25762
25967
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
25763
25968
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
25969
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
25764
25970
  delete_automated_backups: typing.Optional[builtins.bool] = None,
25765
25971
  deletion_protection: typing.Optional[builtins.bool] = None,
25766
25972
  domain: typing.Optional[builtins.str] = None,
@@ -25815,6 +26021,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25815
26021
  :param cloudwatch_logs_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``Infinity``. Default: - logs never expire
25816
26022
  :param cloudwatch_logs_retention_role: The IAM role for the Lambda function associated with the custom resource that sets the retention policy. Default: - a new role is created.
25817
26023
  :param copy_tags_to_snapshot: Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance. Default: true
26024
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
25818
26025
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
25819
26026
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
25820
26027
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -25832,7 +26039,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25832
26039
  :param option_group: The option group to associate with the instance. Default: - no option group
25833
26040
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
25834
26041
  :param performance_insight_encryption_key: The AWS KMS key for encryption of Performance Insights data. Default: - default master key
25835
- :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. Default: 7 this is the free tier
26042
+ :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``. Default: 7 this is the free tier
25836
26043
  :param port: The port for the instance. Default: - the default port for the chosen engine.
25837
26044
  :param preferred_backup_window: The daily time range during which automated backups are performed. 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. Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
25838
26045
  :param preferred_maintenance_window: The weekly time range (in UTC) during which system maintenance can occur. Format: ``ddd:hh24:mi-ddd:hh24:mi`` Constraint: Minimum 30-minute window Default: - 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 https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
@@ -25901,6 +26108,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25901
26108
  cloudwatch_logs_retention=logs.RetentionDays.ONE_DAY,
25902
26109
  cloudwatch_logs_retention_role=role,
25903
26110
  copy_tags_to_snapshot=False,
26111
+ database_insights_mode=rds.DatabaseInsightsMode.STANDARD,
25904
26112
  database_name="databaseName",
25905
26113
  delete_automated_backups=False,
25906
26114
  deletion_protection=False,
@@ -25969,6 +26177,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25969
26177
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
25970
26178
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
25971
26179
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
26180
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
25972
26181
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
25973
26182
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
25974
26183
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -26032,6 +26241,8 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
26032
26241
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
26033
26242
  if copy_tags_to_snapshot is not None:
26034
26243
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
26244
+ if database_insights_mode is not None:
26245
+ self._values["database_insights_mode"] = database_insights_mode
26035
26246
  if delete_automated_backups is not None:
26036
26247
  self._values["delete_automated_backups"] = delete_automated_backups
26037
26248
  if deletion_protection is not None:
@@ -26224,6 +26435,15 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
26224
26435
  result = self._values.get("copy_tags_to_snapshot")
26225
26436
  return typing.cast(typing.Optional[builtins.bool], result)
26226
26437
 
26438
+ @builtins.property
26439
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
26440
+ '''The database insights mode.
26441
+
26442
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
26443
+ '''
26444
+ result = self._values.get("database_insights_mode")
26445
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
26446
+
26227
26447
  @builtins.property
26228
26448
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
26229
26449
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -26402,6 +26622,8 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
26402
26622
  ) -> typing.Optional["PerformanceInsightRetention"]:
26403
26623
  '''The amount of time, in days, to retain Performance Insights data.
26404
26624
 
26625
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
26626
+
26405
26627
  :default: 7 this is the free tier
26406
26628
  '''
26407
26629
  result = self._values.get("performance_insight_retention")
@@ -36855,7 +37077,12 @@ class PostgresEngineVersion(
36855
37077
  @jsii.python.classproperty
36856
37078
  @jsii.member(jsii_name="VER_13_17")
36857
37079
  def VER_13_17(cls) -> "PostgresEngineVersion":
36858
- '''Version "13.17".'''
37080
+ '''(deprecated) Version "13.17".
37081
+
37082
+ :deprecated: PostgreSQL 13.17 is no longer supported by Amazon RDS
37083
+
37084
+ :stability: deprecated
37085
+ '''
36859
37086
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_13_17"))
36860
37087
 
36861
37088
  @jsii.python.classproperty
@@ -36867,7 +37094,12 @@ class PostgresEngineVersion(
36867
37094
  @jsii.python.classproperty
36868
37095
  @jsii.member(jsii_name="VER_13_19")
36869
37096
  def VER_13_19(cls) -> "PostgresEngineVersion":
36870
- '''Version "13.19".'''
37097
+ '''(deprecated) Version "13.19".
37098
+
37099
+ :deprecated: PostgreSQL 13.19 is no longer supported by Amazon RDS
37100
+
37101
+ :stability: deprecated
37102
+ '''
36871
37103
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_13_19"))
36872
37104
 
36873
37105
  @jsii.python.classproperty
@@ -37024,7 +37256,12 @@ class PostgresEngineVersion(
37024
37256
  @jsii.python.classproperty
37025
37257
  @jsii.member(jsii_name="VER_14_14")
37026
37258
  def VER_14_14(cls) -> "PostgresEngineVersion":
37027
- '''Version "14.14".'''
37259
+ '''(deprecated) Version "14.14".
37260
+
37261
+ :deprecated: PostgreSQL 14.14 is no longer supported by Amazon RDS
37262
+
37263
+ :stability: deprecated
37264
+ '''
37028
37265
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_14_14"))
37029
37266
 
37030
37267
  @jsii.python.classproperty
@@ -37036,7 +37273,12 @@ class PostgresEngineVersion(
37036
37273
  @jsii.python.classproperty
37037
37274
  @jsii.member(jsii_name="VER_14_16")
37038
37275
  def VER_14_16(cls) -> "PostgresEngineVersion":
37039
- '''Version "14.16".'''
37276
+ '''(deprecated) Version "14.16".
37277
+
37278
+ :deprecated: PostgreSQL 14.16 is no longer supported by Amazon RDS
37279
+
37280
+ :stability: deprecated
37281
+ '''
37040
37282
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_14_16"))
37041
37283
 
37042
37284
  @jsii.python.classproperty
@@ -37154,7 +37396,12 @@ class PostgresEngineVersion(
37154
37396
  @jsii.python.classproperty
37155
37397
  @jsii.member(jsii_name="VER_15_11")
37156
37398
  def VER_15_11(cls) -> "PostgresEngineVersion":
37157
- '''Version "15.11".'''
37399
+ '''(deprecated) Version "15.11".
37400
+
37401
+ :deprecated: PostgreSQL 15.11 is no longer supported by Amazon RDS
37402
+
37403
+ :stability: deprecated
37404
+ '''
37158
37405
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_15_11"))
37159
37406
 
37160
37407
  @jsii.python.classproperty
@@ -37239,7 +37486,12 @@ class PostgresEngineVersion(
37239
37486
  @jsii.python.classproperty
37240
37487
  @jsii.member(jsii_name="VER_15_9")
37241
37488
  def VER_15_9(cls) -> "PostgresEngineVersion":
37242
- '''Version "15.9".'''
37489
+ '''(deprecated) Version "15.9".
37490
+
37491
+ :deprecated: PostgreSQL 15.9 is no longer supported by Amazon RDS
37492
+
37493
+ :stability: deprecated
37494
+ '''
37243
37495
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_15_9"))
37244
37496
 
37245
37497
  @jsii.python.classproperty
@@ -37285,7 +37537,12 @@ class PostgresEngineVersion(
37285
37537
  @jsii.python.classproperty
37286
37538
  @jsii.member(jsii_name="VER_16_5")
37287
37539
  def VER_16_5(cls) -> "PostgresEngineVersion":
37288
- '''Version "16.5".'''
37540
+ '''(deprecated) Version "16.5".
37541
+
37542
+ :deprecated: PostgreSQL 16.5 is no longer supported by Amazon RDS
37543
+
37544
+ :stability: deprecated
37545
+ '''
37289
37546
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_16_5"))
37290
37547
 
37291
37548
  @jsii.python.classproperty
@@ -37297,7 +37554,12 @@ class PostgresEngineVersion(
37297
37554
  @jsii.python.classproperty
37298
37555
  @jsii.member(jsii_name="VER_16_7")
37299
37556
  def VER_16_7(cls) -> "PostgresEngineVersion":
37300
- '''Version "16.7".'''
37557
+ '''(deprecated) Version "16.7".
37558
+
37559
+ :deprecated: PostgreSQL 16.7 is no longer supported by Amazon RDS
37560
+
37561
+ :stability: deprecated
37562
+ '''
37301
37563
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_16_7"))
37302
37564
 
37303
37565
  @jsii.python.classproperty
@@ -37321,7 +37583,12 @@ class PostgresEngineVersion(
37321
37583
  @jsii.python.classproperty
37322
37584
  @jsii.member(jsii_name="VER_17_1")
37323
37585
  def VER_17_1(cls) -> "PostgresEngineVersion":
37324
- '''Version "17.1".'''
37586
+ '''(deprecated) Version "17.1".
37587
+
37588
+ :deprecated: PostgreSQL 17.1 is no longer supported by Amazon RDS
37589
+
37590
+ :stability: deprecated
37591
+ '''
37325
37592
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_17_1"))
37326
37593
 
37327
37594
  @jsii.python.classproperty
@@ -37333,7 +37600,12 @@ class PostgresEngineVersion(
37333
37600
  @jsii.python.classproperty
37334
37601
  @jsii.member(jsii_name="VER_17_3")
37335
37602
  def VER_17_3(cls) -> "PostgresEngineVersion":
37336
- '''Version "17.3".'''
37603
+ '''(deprecated) Version "17.3".
37604
+
37605
+ :deprecated: PostgreSQL 17.3 is no longer supported by Amazon RDS
37606
+
37607
+ :stability: deprecated
37608
+ '''
37337
37609
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_17_3"))
37338
37610
 
37339
37611
  @jsii.python.classproperty
@@ -44621,6 +44893,7 @@ class DatabaseInstanceFromSnapshot(
44621
44893
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
44622
44894
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
44623
44895
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
44896
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
44624
44897
  delete_automated_backups: typing.Optional[builtins.bool] = None,
44625
44898
  deletion_protection: typing.Optional[builtins.bool] = None,
44626
44899
  domain: typing.Optional[builtins.str] = None,
@@ -44679,6 +44952,7 @@ class DatabaseInstanceFromSnapshot(
44679
44952
  :param cloudwatch_logs_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``Infinity``. Default: - logs never expire
44680
44953
  :param cloudwatch_logs_retention_role: The IAM role for the Lambda function associated with the custom resource that sets the retention policy. Default: - a new role is created.
44681
44954
  :param copy_tags_to_snapshot: Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance. Default: true
44955
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
44682
44956
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
44683
44957
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
44684
44958
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -44696,7 +44970,7 @@ class DatabaseInstanceFromSnapshot(
44696
44970
  :param option_group: The option group to associate with the instance. Default: - no option group
44697
44971
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
44698
44972
  :param performance_insight_encryption_key: The AWS KMS key for encryption of Performance Insights data. Default: - default master key
44699
- :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. Default: 7 this is the free tier
44973
+ :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``. Default: 7 this is the free tier
44700
44974
  :param port: The port for the instance. Default: - the default port for the chosen engine.
44701
44975
  :param preferred_backup_window: The daily time range during which automated backups are performed. 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. Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
44702
44976
  :param preferred_maintenance_window: The weekly time range (in UTC) during which system maintenance can occur. Format: ``ddd:hh24:mi-ddd:hh24:mi`` Constraint: Minimum 30-minute window Default: - 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 https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
@@ -44739,6 +45013,7 @@ class DatabaseInstanceFromSnapshot(
44739
45013
  cloudwatch_logs_retention=cloudwatch_logs_retention,
44740
45014
  cloudwatch_logs_retention_role=cloudwatch_logs_retention_role,
44741
45015
  copy_tags_to_snapshot=copy_tags_to_snapshot,
45016
+ database_insights_mode=database_insights_mode,
44742
45017
  delete_automated_backups=delete_automated_backups,
44743
45018
  deletion_protection=deletion_protection,
44744
45019
  domain=domain,
@@ -44992,6 +45267,7 @@ class DatabaseInstanceFromSnapshot(
44992
45267
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
44993
45268
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
44994
45269
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
45270
+ "database_insights_mode": "databaseInsightsMode",
44995
45271
  "delete_automated_backups": "deleteAutomatedBackups",
44996
45272
  "deletion_protection": "deletionProtection",
44997
45273
  "domain": "domain",
@@ -45052,6 +45328,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45052
45328
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
45053
45329
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
45054
45330
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
45331
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
45055
45332
  delete_automated_backups: typing.Optional[builtins.bool] = None,
45056
45333
  deletion_protection: typing.Optional[builtins.bool] = None,
45057
45334
  domain: typing.Optional[builtins.str] = None,
@@ -45109,6 +45386,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45109
45386
  :param cloudwatch_logs_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``Infinity``. Default: - logs never expire
45110
45387
  :param cloudwatch_logs_retention_role: The IAM role for the Lambda function associated with the custom resource that sets the retention policy. Default: - a new role is created.
45111
45388
  :param copy_tags_to_snapshot: Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance. Default: true
45389
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
45112
45390
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
45113
45391
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
45114
45392
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -45126,7 +45404,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45126
45404
  :param option_group: The option group to associate with the instance. Default: - no option group
45127
45405
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
45128
45406
  :param performance_insight_encryption_key: The AWS KMS key for encryption of Performance Insights data. Default: - default master key
45129
- :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. Default: 7 this is the free tier
45407
+ :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``. Default: 7 this is the free tier
45130
45408
  :param port: The port for the instance. Default: - the default port for the chosen engine.
45131
45409
  :param preferred_backup_window: The daily time range during which automated backups are performed. 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. Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
45132
45410
  :param preferred_maintenance_window: The weekly time range (in UTC) during which system maintenance can occur. Format: ``ddd:hh24:mi-ddd:hh24:mi`` Constraint: Minimum 30-minute window Default: - 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 https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
@@ -45190,6 +45468,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45190
45468
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
45191
45469
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
45192
45470
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
45471
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
45193
45472
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
45194
45473
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
45195
45474
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -45256,6 +45535,8 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45256
45535
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
45257
45536
  if copy_tags_to_snapshot is not None:
45258
45537
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
45538
+ if database_insights_mode is not None:
45539
+ self._values["database_insights_mode"] = database_insights_mode
45259
45540
  if delete_automated_backups is not None:
45260
45541
  self._values["delete_automated_backups"] = delete_automated_backups
45261
45542
  if deletion_protection is not None:
@@ -45454,6 +45735,15 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45454
45735
  result = self._values.get("copy_tags_to_snapshot")
45455
45736
  return typing.cast(typing.Optional[builtins.bool], result)
45456
45737
 
45738
+ @builtins.property
45739
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
45740
+ '''The database insights mode.
45741
+
45742
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
45743
+ '''
45744
+ result = self._values.get("database_insights_mode")
45745
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
45746
+
45457
45747
  @builtins.property
45458
45748
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
45459
45749
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -45632,6 +45922,8 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45632
45922
  ) -> typing.Optional[PerformanceInsightRetention]:
45633
45923
  '''The amount of time, in days, to retain Performance Insights data.
45634
45924
 
45925
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
45926
+
45635
45927
  :default: 7 this is the free tier
45636
45928
  '''
45637
45929
  result = self._values.get("performance_insight_retention")
@@ -45988,6 +46280,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45988
46280
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
45989
46281
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
45990
46282
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
46283
+ "database_insights_mode": "databaseInsightsMode",
45991
46284
  "delete_automated_backups": "deleteAutomatedBackups",
45992
46285
  "deletion_protection": "deletionProtection",
45993
46286
  "domain": "domain",
@@ -46049,6 +46342,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46049
46342
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
46050
46343
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
46051
46344
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
46345
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
46052
46346
  delete_automated_backups: typing.Optional[builtins.bool] = None,
46053
46347
  deletion_protection: typing.Optional[builtins.bool] = None,
46054
46348
  domain: typing.Optional[builtins.str] = None,
@@ -46107,6 +46401,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46107
46401
  :param cloudwatch_logs_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``Infinity``. Default: - logs never expire
46108
46402
  :param cloudwatch_logs_retention_role: The IAM role for the Lambda function associated with the custom resource that sets the retention policy. Default: - a new role is created.
46109
46403
  :param copy_tags_to_snapshot: Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance. Default: true
46404
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
46110
46405
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
46111
46406
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
46112
46407
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -46124,7 +46419,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46124
46419
  :param option_group: The option group to associate with the instance. Default: - no option group
46125
46420
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
46126
46421
  :param performance_insight_encryption_key: The AWS KMS key for encryption of Performance Insights data. Default: - default master key
46127
- :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. Default: 7 this is the free tier
46422
+ :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``. Default: 7 this is the free tier
46128
46423
  :param port: The port for the instance. Default: - the default port for the chosen engine.
46129
46424
  :param preferred_backup_window: The daily time range during which automated backups are performed. 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. Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
46130
46425
  :param preferred_maintenance_window: The weekly time range (in UTC) during which system maintenance can occur. Format: ``ddd:hh24:mi-ddd:hh24:mi`` Constraint: Minimum 30-minute window Default: - 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 https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
@@ -46191,6 +46486,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46191
46486
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
46192
46487
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
46193
46488
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
46489
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
46194
46490
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
46195
46491
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
46196
46492
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -46258,6 +46554,8 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46258
46554
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
46259
46555
  if copy_tags_to_snapshot is not None:
46260
46556
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
46557
+ if database_insights_mode is not None:
46558
+ self._values["database_insights_mode"] = database_insights_mode
46261
46559
  if delete_automated_backups is not None:
46262
46560
  self._values["delete_automated_backups"] = delete_automated_backups
46263
46561
  if deletion_protection is not None:
@@ -46458,6 +46756,15 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46458
46756
  result = self._values.get("copy_tags_to_snapshot")
46459
46757
  return typing.cast(typing.Optional[builtins.bool], result)
46460
46758
 
46759
+ @builtins.property
46760
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
46761
+ '''The database insights mode.
46762
+
46763
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
46764
+ '''
46765
+ result = self._values.get("database_insights_mode")
46766
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
46767
+
46461
46768
  @builtins.property
46462
46769
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
46463
46770
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -46636,6 +46943,8 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46636
46943
  ) -> typing.Optional[PerformanceInsightRetention]:
46637
46944
  '''The amount of time, in days, to retain Performance Insights data.
46638
46945
 
46946
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
46947
+
46639
46948
  :default: 7 this is the free tier
46640
46949
  '''
46641
46950
  result = self._values.get("performance_insight_retention")
@@ -47017,6 +47326,7 @@ class DatabaseInstanceReadReplica(
47017
47326
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
47018
47327
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
47019
47328
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
47329
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
47020
47330
  delete_automated_backups: typing.Optional[builtins.bool] = None,
47021
47331
  deletion_protection: typing.Optional[builtins.bool] = None,
47022
47332
  domain: typing.Optional[builtins.str] = None,
@@ -47069,6 +47379,7 @@ class DatabaseInstanceReadReplica(
47069
47379
  :param cloudwatch_logs_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``Infinity``. Default: - logs never expire
47070
47380
  :param cloudwatch_logs_retention_role: The IAM role for the Lambda function associated with the custom resource that sets the retention policy. Default: - a new role is created.
47071
47381
  :param copy_tags_to_snapshot: Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance. Default: true
47382
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
47072
47383
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
47073
47384
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
47074
47385
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -47086,7 +47397,7 @@ class DatabaseInstanceReadReplica(
47086
47397
  :param option_group: The option group to associate with the instance. Default: - no option group
47087
47398
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
47088
47399
  :param performance_insight_encryption_key: The AWS KMS key for encryption of Performance Insights data. Default: - default master key
47089
- :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. Default: 7 this is the free tier
47400
+ :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``. Default: 7 this is the free tier
47090
47401
  :param port: The port for the instance. Default: - the default port for the chosen engine.
47091
47402
  :param preferred_backup_window: The daily time range during which automated backups are performed. 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. Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
47092
47403
  :param preferred_maintenance_window: The weekly time range (in UTC) during which system maintenance can occur. Format: ``ddd:hh24:mi-ddd:hh24:mi`` Constraint: Minimum 30-minute window Default: - 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 https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
@@ -47123,6 +47434,7 @@ class DatabaseInstanceReadReplica(
47123
47434
  cloudwatch_logs_retention=cloudwatch_logs_retention,
47124
47435
  cloudwatch_logs_retention_role=cloudwatch_logs_retention_role,
47125
47436
  copy_tags_to_snapshot=copy_tags_to_snapshot,
47437
+ database_insights_mode=database_insights_mode,
47126
47438
  delete_automated_backups=delete_automated_backups,
47127
47439
  deletion_protection=deletion_protection,
47128
47440
  domain=domain,
@@ -48292,6 +48604,7 @@ class DatabaseInstance(
48292
48604
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
48293
48605
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
48294
48606
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
48607
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
48295
48608
  delete_automated_backups: typing.Optional[builtins.bool] = None,
48296
48609
  deletion_protection: typing.Optional[builtins.bool] = None,
48297
48610
  domain: typing.Optional[builtins.str] = None,
@@ -48351,6 +48664,7 @@ class DatabaseInstance(
48351
48664
  :param cloudwatch_logs_retention: The number of days log events are kept in CloudWatch Logs. When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to ``Infinity``. Default: - logs never expire
48352
48665
  :param cloudwatch_logs_retention_role: The IAM role for the Lambda function associated with the custom resource that sets the retention policy. Default: - a new role is created.
48353
48666
  :param copy_tags_to_snapshot: Indicates whether to copy all of the user-defined tags from the DB instance to snapshots of the DB instance. Default: true
48667
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
48354
48668
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
48355
48669
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
48356
48670
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -48368,7 +48682,7 @@ class DatabaseInstance(
48368
48682
  :param option_group: The option group to associate with the instance. Default: - no option group
48369
48683
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
48370
48684
  :param performance_insight_encryption_key: The AWS KMS key for encryption of Performance Insights data. Default: - default master key
48371
- :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. Default: 7 this is the free tier
48685
+ :param performance_insight_retention: The amount of time, in days, to retain Performance Insights data. If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``. Default: 7 this is the free tier
48372
48686
  :param port: The port for the instance. Default: - the default port for the chosen engine.
48373
48687
  :param preferred_backup_window: The daily time range during which automated backups are performed. 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. Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
48374
48688
  :param preferred_maintenance_window: The weekly time range (in UTC) during which system maintenance can occur. Format: ``ddd:hh24:mi-ddd:hh24:mi`` Constraint: Minimum 30-minute window Default: - 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 https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
@@ -48412,6 +48726,7 @@ class DatabaseInstance(
48412
48726
  cloudwatch_logs_retention=cloudwatch_logs_retention,
48413
48727
  cloudwatch_logs_retention_role=cloudwatch_logs_retention_role,
48414
48728
  copy_tags_to_snapshot=copy_tags_to_snapshot,
48729
+ database_insights_mode=database_insights_mode,
48415
48730
  delete_automated_backups=delete_automated_backups,
48416
48731
  deletion_protection=deletion_protection,
48417
48732
  domain=domain,
@@ -49022,6 +49337,7 @@ def _typecheckingstub__1eb14b9dcc306eabcc2963c7b6ef9b87bf8d616bb5691dbc6656242be
49022
49337
  db_instance_parameter_group_name: typing.Optional[builtins.str] = None,
49023
49338
  db_subnet_group_name: typing.Optional[builtins.str] = None,
49024
49339
  db_system_id: typing.Optional[builtins.str] = None,
49340
+ delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
49025
49341
  deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
49026
49342
  domain: typing.Optional[builtins.str] = None,
49027
49343
  domain_iam_role_name: typing.Optional[builtins.str] = None,
@@ -49176,6 +49492,12 @@ def _typecheckingstub__41f2773ed2c93659b8bf06ee2830b9675bbe867fb30ad2e89f77f72a4
49176
49492
  """Type checking stubs"""
49177
49493
  pass
49178
49494
 
49495
+ def _typecheckingstub__9e8a2ba2ab46cead449dbe97283d45de5dd8c86ea7d68521f70c997f8eb39235(
49496
+ value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
49497
+ ) -> None:
49498
+ """Type checking stubs"""
49499
+ pass
49500
+
49179
49501
  def _typecheckingstub__a96b132db813926d0ef31c223b961804a782255c93a76d8ab91de8c2ca7b0f35(
49180
49502
  value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
49181
49503
  ) -> None:
@@ -49564,6 +49886,7 @@ def _typecheckingstub__aaf089104646bb0ea95e48cd2107d642585c3eb3785a21112fc029b15
49564
49886
  db_instance_parameter_group_name: typing.Optional[builtins.str] = None,
49565
49887
  db_subnet_group_name: typing.Optional[builtins.str] = None,
49566
49888
  db_system_id: typing.Optional[builtins.str] = None,
49889
+ delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
49567
49890
  deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
49568
49891
  domain: typing.Optional[builtins.str] = None,
49569
49892
  domain_iam_role_name: typing.Optional[builtins.str] = None,
@@ -51651,6 +51974,7 @@ def _typecheckingstub__d110b1cb0043ae6adf59fc0d1bcb136b4655ac973cfbff361a0a3e2fe
51651
51974
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
51652
51975
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
51653
51976
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
51977
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
51654
51978
  delete_automated_backups: typing.Optional[builtins.bool] = None,
51655
51979
  deletion_protection: typing.Optional[builtins.bool] = None,
51656
51980
  domain: typing.Optional[builtins.str] = None,
@@ -51700,6 +52024,7 @@ def _typecheckingstub__5508238388ee4afc86f97d5f22fa50578f8a1bdeed9ade8d0210c955b
51700
52024
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
51701
52025
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
51702
52026
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
52027
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
51703
52028
  delete_automated_backups: typing.Optional[builtins.bool] = None,
51704
52029
  deletion_protection: typing.Optional[builtins.bool] = None,
51705
52030
  domain: typing.Optional[builtins.str] = None,
@@ -51754,6 +52079,7 @@ def _typecheckingstub__77d3b41152c4c7a3436d76bad0d83368717917e66a0f0cd849998fcd4
51754
52079
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
51755
52080
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
51756
52081
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
52082
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
51757
52083
  delete_automated_backups: typing.Optional[builtins.bool] = None,
51758
52084
  deletion_protection: typing.Optional[builtins.bool] = None,
51759
52085
  domain: typing.Optional[builtins.str] = None,
@@ -53019,6 +53345,7 @@ def _typecheckingstub__dbf7e60a650d0a1bea1826814200716f46cd1f59eea36a42193653d7f
53019
53345
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53020
53346
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53021
53347
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53348
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53022
53349
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53023
53350
  deletion_protection: typing.Optional[builtins.bool] = None,
53024
53351
  domain: typing.Optional[builtins.str] = None,
@@ -53095,6 +53422,7 @@ def _typecheckingstub__f06d86058a0a7538eb7dbf55de032c8cf05f7fa7b4ab5d5c1d47f7617
53095
53422
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53096
53423
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53097
53424
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53425
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53098
53426
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53099
53427
  deletion_protection: typing.Optional[builtins.bool] = None,
53100
53428
  domain: typing.Optional[builtins.str] = None,
@@ -53155,6 +53483,7 @@ def _typecheckingstub__23675ebe667ec40ba6afd82bf8b65d901cc9a4bfc79be222b108037d5
53155
53483
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53156
53484
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53157
53485
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53486
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53158
53487
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53159
53488
  deletion_protection: typing.Optional[builtins.bool] = None,
53160
53489
  domain: typing.Optional[builtins.str] = None,
@@ -53223,6 +53552,7 @@ def _typecheckingstub__b2082895d1c502ba05a38a32c44782a7480089cd804d396ed1b41ca4a
53223
53552
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53224
53553
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53225
53554
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53555
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53226
53556
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53227
53557
  deletion_protection: typing.Optional[builtins.bool] = None,
53228
53558
  domain: typing.Optional[builtins.str] = None,
@@ -53462,6 +53792,7 @@ def _typecheckingstub__cb12c4cf0f41b623c75db1c295b846314e730919538b3374019067232
53462
53792
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53463
53793
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53464
53794
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53795
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53465
53796
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53466
53797
  deletion_protection: typing.Optional[builtins.bool] = None,
53467
53798
  domain: typing.Optional[builtins.str] = None,