aws-cdk-lib 2.206.0__py3-none-any.whl → 2.207.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.

@@ -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
 
@@ -5490,7 +5504,7 @@ class CfnDBCluster(
5490
5504
  :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
5505
  :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
5506
  :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.
5507
+ :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
5508
  :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
5509
  :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
5510
  :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
@@ -5535,7 +5549,7 @@ class CfnDBCluster(
5535
5549
  :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
5550
  :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
5551
  :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
5552
+ :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
5553
  :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
5554
  :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
5555
  :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`` .
@@ -7684,7 +7698,7 @@ class CfnDBClusterProps:
7684
7698
  :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
7699
  :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
7700
  :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.
7701
+ :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
7702
  :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
7703
  :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
7704
  :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
@@ -7729,7 +7743,7 @@ class CfnDBClusterProps:
7729
7743
  :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
7744
  :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
7745
  :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
7746
+ :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
7747
  :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
7748
  :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
7749
  :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`` .
@@ -8107,6 +8121,8 @@ class CfnDBClusterProps:
8107
8121
 
8108
8122
  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
8123
 
8124
+ *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.
8125
+
8110
8126
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-clusterscalabilitytype
8111
8127
  '''
8112
8128
  result = self._values.get("cluster_scalability_type")
@@ -8925,6 +8941,7 @@ class CfnDBClusterProps:
8925
8941
  Constraints:
8926
8942
 
8927
8943
  - Must match the identifier of an existing DBCluster.
8944
+ - Cannot be specified if ``SourceDbClusterResourceId`` is specified. You must specify either ``SourceDBClusterIdentifier`` or ``SourceDbClusterResourceId`` , but not both.
8928
8945
 
8929
8946
  Valid for: Aurora DB clusters and Multi-AZ DB clusters
8930
8947
 
@@ -9302,7 +9319,7 @@ class CfnDBInstance(
9302
9319
  :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
9320
  :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
9321
  :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:
9322
+ :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
9323
  :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
9324
  :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
9325
  :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>`_ .
@@ -9790,6 +9807,7 @@ class CfnDBInstance(
9790
9807
  @builtins.property
9791
9808
  @jsii.member(jsii_name="backupTarget")
9792
9809
  def backup_target(self) -> typing.Optional[builtins.str]:
9810
+ '''The location for storing automated backups and manual snapshots.'''
9793
9811
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "backupTarget"))
9794
9812
 
9795
9813
  @backup_target.setter
@@ -11404,7 +11422,7 @@ class CfnDBInstanceProps:
11404
11422
  :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
11423
  :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
11424
  :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:
11425
+ :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
11426
  :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
11427
  :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
11428
  :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 +12057,18 @@ class CfnDBInstanceProps:
12039
12057
 
12040
12058
  @builtins.property
12041
12059
  def backup_target(self) -> typing.Optional[builtins.str]:
12042
- '''
12060
+ '''The location for storing automated backups and manual snapshots.
12061
+
12062
+ Valid Values:
12063
+
12064
+ - ``local`` (Dedicated Local Zone)
12065
+ - ``outposts`` ( AWS Outposts)
12066
+ - ``region`` ( AWS Region )
12067
+
12068
+ Default: ``region``
12069
+
12070
+ 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* .
12071
+
12043
12072
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-backuptarget
12044
12073
  '''
12045
12074
  result = self._values.get("backup_target")
@@ -23457,7 +23486,7 @@ class DatabaseClusterProps:
23457
23486
 
23458
23487
  @jsii.enum(jsii_type="aws-cdk-lib.aws_rds.DatabaseInsightsMode")
23459
23488
  class DatabaseInsightsMode(enum.Enum):
23460
- '''The database insights mode of the Aurora DB cluster.
23489
+ '''The database insights mode.
23461
23490
 
23462
23491
  :exampleMetadata: infused
23463
23492
 
@@ -23950,6 +23979,7 @@ class DatabaseInstanceLookupOptions:
23950
23979
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
23951
23980
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
23952
23981
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
23982
+ "database_insights_mode": "databaseInsightsMode",
23953
23983
  "delete_automated_backups": "deleteAutomatedBackups",
23954
23984
  "deletion_protection": "deletionProtection",
23955
23985
  "domain": "domain",
@@ -23999,6 +24029,7 @@ class DatabaseInstanceNewProps:
23999
24029
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
24000
24030
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
24001
24031
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
24032
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
24002
24033
  delete_automated_backups: typing.Optional[builtins.bool] = None,
24003
24034
  deletion_protection: typing.Optional[builtins.bool] = None,
24004
24035
  domain: typing.Optional[builtins.str] = None,
@@ -24045,6 +24076,7 @@ class DatabaseInstanceNewProps:
24045
24076
  :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
24077
  :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
24078
  :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
24079
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
24048
24080
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
24049
24081
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
24050
24082
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -24062,7 +24094,7 @@ class DatabaseInstanceNewProps:
24062
24094
  :param option_group: The option group to associate with the instance. Default: - no option group
24063
24095
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
24064
24096
  :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
24097
+ :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
24098
  :param port: The port for the instance. Default: - the default port for the chosen engine.
24067
24099
  :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
24100
  :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 +24150,7 @@ class DatabaseInstanceNewProps:
24118
24150
  cloudwatch_logs_retention=logs.RetentionDays.ONE_DAY,
24119
24151
  cloudwatch_logs_retention_role=role,
24120
24152
  copy_tags_to_snapshot=False,
24153
+ database_insights_mode=rds.DatabaseInsightsMode.STANDARD,
24121
24154
  delete_automated_backups=False,
24122
24155
  deletion_protection=False,
24123
24156
  domain="domain",
@@ -24179,6 +24212,7 @@ class DatabaseInstanceNewProps:
24179
24212
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
24180
24213
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
24181
24214
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
24215
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
24182
24216
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
24183
24217
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
24184
24218
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -24233,6 +24267,8 @@ class DatabaseInstanceNewProps:
24233
24267
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
24234
24268
  if copy_tags_to_snapshot is not None:
24235
24269
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
24270
+ if database_insights_mode is not None:
24271
+ self._values["database_insights_mode"] = database_insights_mode
24236
24272
  if delete_automated_backups is not None:
24237
24273
  self._values["delete_automated_backups"] = delete_automated_backups
24238
24274
  if deletion_protection is not None:
@@ -24411,6 +24447,15 @@ class DatabaseInstanceNewProps:
24411
24447
  result = self._values.get("copy_tags_to_snapshot")
24412
24448
  return typing.cast(typing.Optional[builtins.bool], result)
24413
24449
 
24450
+ @builtins.property
24451
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
24452
+ '''The database insights mode.
24453
+
24454
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
24455
+ '''
24456
+ result = self._values.get("database_insights_mode")
24457
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
24458
+
24414
24459
  @builtins.property
24415
24460
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
24416
24461
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -24589,6 +24634,8 @@ class DatabaseInstanceNewProps:
24589
24634
  ) -> typing.Optional["PerformanceInsightRetention"]:
24590
24635
  '''The amount of time, in days, to retain Performance Insights data.
24591
24636
 
24637
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
24638
+
24592
24639
  :default: 7 this is the free tier
24593
24640
  '''
24594
24641
  result = self._values.get("performance_insight_retention")
@@ -24822,6 +24869,7 @@ class DatabaseInstanceNewProps:
24822
24869
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
24823
24870
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
24824
24871
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
24872
+ "database_insights_mode": "databaseInsightsMode",
24825
24873
  "delete_automated_backups": "deleteAutomatedBackups",
24826
24874
  "deletion_protection": "deletionProtection",
24827
24875
  "domain": "domain",
@@ -24876,6 +24924,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24876
24924
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
24877
24925
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
24878
24926
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
24927
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
24879
24928
  delete_automated_backups: typing.Optional[builtins.bool] = None,
24880
24929
  deletion_protection: typing.Optional[builtins.bool] = None,
24881
24930
  domain: typing.Optional[builtins.str] = None,
@@ -24927,6 +24976,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24927
24976
  :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
24977
  :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
24978
  :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
24979
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
24930
24980
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
24931
24981
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
24932
24982
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -24944,7 +24994,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24944
24994
  :param option_group: The option group to associate with the instance. Default: - no option group
24945
24995
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
24946
24996
  :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
24997
+ :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
24998
  :param port: The port for the instance. Default: - the default port for the chosen engine.
24949
24999
  :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
25000
  :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 +25053,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25003
25053
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
25004
25054
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
25005
25055
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
25056
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
25006
25057
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
25007
25058
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
25008
25059
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -25064,6 +25115,8 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25064
25115
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
25065
25116
  if copy_tags_to_snapshot is not None:
25066
25117
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
25118
+ if database_insights_mode is not None:
25119
+ self._values["database_insights_mode"] = database_insights_mode
25067
25120
  if delete_automated_backups is not None:
25068
25121
  self._values["delete_automated_backups"] = delete_automated_backups
25069
25122
  if deletion_protection is not None:
@@ -25248,6 +25301,15 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25248
25301
  result = self._values.get("copy_tags_to_snapshot")
25249
25302
  return typing.cast(typing.Optional[builtins.bool], result)
25250
25303
 
25304
+ @builtins.property
25305
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
25306
+ '''The database insights mode.
25307
+
25308
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
25309
+ '''
25310
+ result = self._values.get("database_insights_mode")
25311
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
25312
+
25251
25313
  @builtins.property
25252
25314
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
25253
25315
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -25426,6 +25488,8 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25426
25488
  ) -> typing.Optional["PerformanceInsightRetention"]:
25427
25489
  '''The amount of time, in days, to retain Performance Insights data.
25428
25490
 
25491
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
25492
+
25429
25493
  :default: 7 this is the free tier
25430
25494
  '''
25431
25495
  result = self._values.get("performance_insight_retention")
@@ -25704,6 +25768,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
25704
25768
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
25705
25769
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
25706
25770
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
25771
+ "database_insights_mode": "databaseInsightsMode",
25707
25772
  "delete_automated_backups": "deleteAutomatedBackups",
25708
25773
  "deletion_protection": "deletionProtection",
25709
25774
  "domain": "domain",
@@ -25761,6 +25826,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25761
25826
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
25762
25827
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
25763
25828
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
25829
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
25764
25830
  delete_automated_backups: typing.Optional[builtins.bool] = None,
25765
25831
  deletion_protection: typing.Optional[builtins.bool] = None,
25766
25832
  domain: typing.Optional[builtins.str] = None,
@@ -25815,6 +25881,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25815
25881
  :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
25882
  :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
25883
  :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
25884
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
25818
25885
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
25819
25886
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
25820
25887
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -25832,7 +25899,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25832
25899
  :param option_group: The option group to associate with the instance. Default: - no option group
25833
25900
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
25834
25901
  :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
25902
+ :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
25903
  :param port: The port for the instance. Default: - the default port for the chosen engine.
25837
25904
  :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
25905
  :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 +25968,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25901
25968
  cloudwatch_logs_retention=logs.RetentionDays.ONE_DAY,
25902
25969
  cloudwatch_logs_retention_role=role,
25903
25970
  copy_tags_to_snapshot=False,
25971
+ database_insights_mode=rds.DatabaseInsightsMode.STANDARD,
25904
25972
  database_name="databaseName",
25905
25973
  delete_automated_backups=False,
25906
25974
  deletion_protection=False,
@@ -25969,6 +26037,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25969
26037
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
25970
26038
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
25971
26039
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
26040
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
25972
26041
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
25973
26042
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
25974
26043
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -26032,6 +26101,8 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
26032
26101
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
26033
26102
  if copy_tags_to_snapshot is not None:
26034
26103
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
26104
+ if database_insights_mode is not None:
26105
+ self._values["database_insights_mode"] = database_insights_mode
26035
26106
  if delete_automated_backups is not None:
26036
26107
  self._values["delete_automated_backups"] = delete_automated_backups
26037
26108
  if deletion_protection is not None:
@@ -26224,6 +26295,15 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
26224
26295
  result = self._values.get("copy_tags_to_snapshot")
26225
26296
  return typing.cast(typing.Optional[builtins.bool], result)
26226
26297
 
26298
+ @builtins.property
26299
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
26300
+ '''The database insights mode.
26301
+
26302
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
26303
+ '''
26304
+ result = self._values.get("database_insights_mode")
26305
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
26306
+
26227
26307
  @builtins.property
26228
26308
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
26229
26309
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -26402,6 +26482,8 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
26402
26482
  ) -> typing.Optional["PerformanceInsightRetention"]:
26403
26483
  '''The amount of time, in days, to retain Performance Insights data.
26404
26484
 
26485
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
26486
+
26405
26487
  :default: 7 this is the free tier
26406
26488
  '''
26407
26489
  result = self._values.get("performance_insight_retention")
@@ -44621,6 +44703,7 @@ class DatabaseInstanceFromSnapshot(
44621
44703
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
44622
44704
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
44623
44705
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
44706
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
44624
44707
  delete_automated_backups: typing.Optional[builtins.bool] = None,
44625
44708
  deletion_protection: typing.Optional[builtins.bool] = None,
44626
44709
  domain: typing.Optional[builtins.str] = None,
@@ -44679,6 +44762,7 @@ class DatabaseInstanceFromSnapshot(
44679
44762
  :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
44763
  :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
44764
  :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
44765
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
44682
44766
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
44683
44767
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
44684
44768
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -44696,7 +44780,7 @@ class DatabaseInstanceFromSnapshot(
44696
44780
  :param option_group: The option group to associate with the instance. Default: - no option group
44697
44781
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
44698
44782
  :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
44783
+ :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
44784
  :param port: The port for the instance. Default: - the default port for the chosen engine.
44701
44785
  :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
44786
  :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 +44823,7 @@ class DatabaseInstanceFromSnapshot(
44739
44823
  cloudwatch_logs_retention=cloudwatch_logs_retention,
44740
44824
  cloudwatch_logs_retention_role=cloudwatch_logs_retention_role,
44741
44825
  copy_tags_to_snapshot=copy_tags_to_snapshot,
44826
+ database_insights_mode=database_insights_mode,
44742
44827
  delete_automated_backups=delete_automated_backups,
44743
44828
  deletion_protection=deletion_protection,
44744
44829
  domain=domain,
@@ -44992,6 +45077,7 @@ class DatabaseInstanceFromSnapshot(
44992
45077
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
44993
45078
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
44994
45079
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
45080
+ "database_insights_mode": "databaseInsightsMode",
44995
45081
  "delete_automated_backups": "deleteAutomatedBackups",
44996
45082
  "deletion_protection": "deletionProtection",
44997
45083
  "domain": "domain",
@@ -45052,6 +45138,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45052
45138
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
45053
45139
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
45054
45140
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
45141
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
45055
45142
  delete_automated_backups: typing.Optional[builtins.bool] = None,
45056
45143
  deletion_protection: typing.Optional[builtins.bool] = None,
45057
45144
  domain: typing.Optional[builtins.str] = None,
@@ -45109,6 +45196,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45109
45196
  :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
45197
  :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
45198
  :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
45199
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
45112
45200
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
45113
45201
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
45114
45202
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -45126,7 +45214,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45126
45214
  :param option_group: The option group to associate with the instance. Default: - no option group
45127
45215
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
45128
45216
  :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
45217
+ :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
45218
  :param port: The port for the instance. Default: - the default port for the chosen engine.
45131
45219
  :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
45220
  :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 +45278,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45190
45278
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
45191
45279
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
45192
45280
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
45281
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
45193
45282
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
45194
45283
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
45195
45284
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -45256,6 +45345,8 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45256
45345
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
45257
45346
  if copy_tags_to_snapshot is not None:
45258
45347
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
45348
+ if database_insights_mode is not None:
45349
+ self._values["database_insights_mode"] = database_insights_mode
45259
45350
  if delete_automated_backups is not None:
45260
45351
  self._values["delete_automated_backups"] = delete_automated_backups
45261
45352
  if deletion_protection is not None:
@@ -45454,6 +45545,15 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45454
45545
  result = self._values.get("copy_tags_to_snapshot")
45455
45546
  return typing.cast(typing.Optional[builtins.bool], result)
45456
45547
 
45548
+ @builtins.property
45549
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
45550
+ '''The database insights mode.
45551
+
45552
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
45553
+ '''
45554
+ result = self._values.get("database_insights_mode")
45555
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
45556
+
45457
45557
  @builtins.property
45458
45558
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
45459
45559
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -45632,6 +45732,8 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45632
45732
  ) -> typing.Optional[PerformanceInsightRetention]:
45633
45733
  '''The amount of time, in days, to retain Performance Insights data.
45634
45734
 
45735
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
45736
+
45635
45737
  :default: 7 this is the free tier
45636
45738
  '''
45637
45739
  result = self._values.get("performance_insight_retention")
@@ -45988,6 +46090,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
45988
46090
  "cloudwatch_logs_retention": "cloudwatchLogsRetention",
45989
46091
  "cloudwatch_logs_retention_role": "cloudwatchLogsRetentionRole",
45990
46092
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
46093
+ "database_insights_mode": "databaseInsightsMode",
45991
46094
  "delete_automated_backups": "deleteAutomatedBackups",
45992
46095
  "deletion_protection": "deletionProtection",
45993
46096
  "domain": "domain",
@@ -46049,6 +46152,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46049
46152
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
46050
46153
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
46051
46154
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
46155
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
46052
46156
  delete_automated_backups: typing.Optional[builtins.bool] = None,
46053
46157
  deletion_protection: typing.Optional[builtins.bool] = None,
46054
46158
  domain: typing.Optional[builtins.str] = None,
@@ -46107,6 +46211,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46107
46211
  :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
46212
  :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
46213
  :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
46214
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
46110
46215
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
46111
46216
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
46112
46217
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -46124,7 +46229,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46124
46229
  :param option_group: The option group to associate with the instance. Default: - no option group
46125
46230
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
46126
46231
  :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
46232
+ :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
46233
  :param port: The port for the instance. Default: - the default port for the chosen engine.
46129
46234
  :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
46235
  :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 +46296,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46191
46296
  check_type(argname="argument cloudwatch_logs_retention", value=cloudwatch_logs_retention, expected_type=type_hints["cloudwatch_logs_retention"])
46192
46297
  check_type(argname="argument cloudwatch_logs_retention_role", value=cloudwatch_logs_retention_role, expected_type=type_hints["cloudwatch_logs_retention_role"])
46193
46298
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
46299
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
46194
46300
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
46195
46301
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
46196
46302
  check_type(argname="argument domain", value=domain, expected_type=type_hints["domain"])
@@ -46258,6 +46364,8 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46258
46364
  self._values["cloudwatch_logs_retention_role"] = cloudwatch_logs_retention_role
46259
46365
  if copy_tags_to_snapshot is not None:
46260
46366
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
46367
+ if database_insights_mode is not None:
46368
+ self._values["database_insights_mode"] = database_insights_mode
46261
46369
  if delete_automated_backups is not None:
46262
46370
  self._values["delete_automated_backups"] = delete_automated_backups
46263
46371
  if deletion_protection is not None:
@@ -46458,6 +46566,15 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46458
46566
  result = self._values.get("copy_tags_to_snapshot")
46459
46567
  return typing.cast(typing.Optional[builtins.bool], result)
46460
46568
 
46569
+ @builtins.property
46570
+ def database_insights_mode(self) -> typing.Optional[DatabaseInsightsMode]:
46571
+ '''The database insights mode.
46572
+
46573
+ :default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
46574
+ '''
46575
+ result = self._values.get("database_insights_mode")
46576
+ return typing.cast(typing.Optional[DatabaseInsightsMode], result)
46577
+
46461
46578
  @builtins.property
46462
46579
  def delete_automated_backups(self) -> typing.Optional[builtins.bool]:
46463
46580
  '''Indicates whether automated backups should be deleted or retained when you delete a DB instance.
@@ -46636,6 +46753,8 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
46636
46753
  ) -> typing.Optional[PerformanceInsightRetention]:
46637
46754
  '''The amount of time, in days, to retain Performance Insights data.
46638
46755
 
46756
+ If you set ``databaseInsightsMode`` to ``DatabaseInsightsMode.ADVANCED``, you must set this property to ``PerformanceInsightRetention.MONTHS_15``.
46757
+
46639
46758
  :default: 7 this is the free tier
46640
46759
  '''
46641
46760
  result = self._values.get("performance_insight_retention")
@@ -47017,6 +47136,7 @@ class DatabaseInstanceReadReplica(
47017
47136
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
47018
47137
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
47019
47138
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
47139
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
47020
47140
  delete_automated_backups: typing.Optional[builtins.bool] = None,
47021
47141
  deletion_protection: typing.Optional[builtins.bool] = None,
47022
47142
  domain: typing.Optional[builtins.str] = None,
@@ -47069,6 +47189,7 @@ class DatabaseInstanceReadReplica(
47069
47189
  :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
47190
  :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
47191
  :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
47192
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
47072
47193
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
47073
47194
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
47074
47195
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -47086,7 +47207,7 @@ class DatabaseInstanceReadReplica(
47086
47207
  :param option_group: The option group to associate with the instance. Default: - no option group
47087
47208
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
47088
47209
  :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
47210
+ :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
47211
  :param port: The port for the instance. Default: - the default port for the chosen engine.
47091
47212
  :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
47213
  :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 +47244,7 @@ class DatabaseInstanceReadReplica(
47123
47244
  cloudwatch_logs_retention=cloudwatch_logs_retention,
47124
47245
  cloudwatch_logs_retention_role=cloudwatch_logs_retention_role,
47125
47246
  copy_tags_to_snapshot=copy_tags_to_snapshot,
47247
+ database_insights_mode=database_insights_mode,
47126
47248
  delete_automated_backups=delete_automated_backups,
47127
47249
  deletion_protection=deletion_protection,
47128
47250
  domain=domain,
@@ -48292,6 +48414,7 @@ class DatabaseInstance(
48292
48414
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
48293
48415
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
48294
48416
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
48417
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
48295
48418
  delete_automated_backups: typing.Optional[builtins.bool] = None,
48296
48419
  deletion_protection: typing.Optional[builtins.bool] = None,
48297
48420
  domain: typing.Optional[builtins.str] = None,
@@ -48351,6 +48474,7 @@ class DatabaseInstance(
48351
48474
  :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
48475
  :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
48476
  :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
48477
+ :param database_insights_mode: The database insights mode. Default: - DatabaseInsightsMode.STANDARD when performance insights are enabled, otherwise not set.
48354
48478
  :param delete_automated_backups: Indicates whether automated backups should be deleted or retained when you delete a DB instance. Default: true
48355
48479
  :param deletion_protection: Indicates whether the DB instance should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
48356
48480
  :param domain: The Active Directory directory ID to create the DB instance in. Default: - Do not join domain
@@ -48368,7 +48492,7 @@ class DatabaseInstance(
48368
48492
  :param option_group: The option group to associate with the instance. Default: - no option group
48369
48493
  :param parameter_group: The DB parameter group to associate with the instance. Default: - no parameter group
48370
48494
  :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
48495
+ :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
48496
  :param port: The port for the instance. Default: - the default port for the chosen engine.
48373
48497
  :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
48498
  :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 +48536,7 @@ class DatabaseInstance(
48412
48536
  cloudwatch_logs_retention=cloudwatch_logs_retention,
48413
48537
  cloudwatch_logs_retention_role=cloudwatch_logs_retention_role,
48414
48538
  copy_tags_to_snapshot=copy_tags_to_snapshot,
48539
+ database_insights_mode=database_insights_mode,
48415
48540
  delete_automated_backups=delete_automated_backups,
48416
48541
  deletion_protection=deletion_protection,
48417
48542
  domain=domain,
@@ -51651,6 +51776,7 @@ def _typecheckingstub__d110b1cb0043ae6adf59fc0d1bcb136b4655ac973cfbff361a0a3e2fe
51651
51776
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
51652
51777
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
51653
51778
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
51779
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
51654
51780
  delete_automated_backups: typing.Optional[builtins.bool] = None,
51655
51781
  deletion_protection: typing.Optional[builtins.bool] = None,
51656
51782
  domain: typing.Optional[builtins.str] = None,
@@ -51700,6 +51826,7 @@ def _typecheckingstub__5508238388ee4afc86f97d5f22fa50578f8a1bdeed9ade8d0210c955b
51700
51826
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
51701
51827
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
51702
51828
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
51829
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
51703
51830
  delete_automated_backups: typing.Optional[builtins.bool] = None,
51704
51831
  deletion_protection: typing.Optional[builtins.bool] = None,
51705
51832
  domain: typing.Optional[builtins.str] = None,
@@ -51754,6 +51881,7 @@ def _typecheckingstub__77d3b41152c4c7a3436d76bad0d83368717917e66a0f0cd849998fcd4
51754
51881
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
51755
51882
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
51756
51883
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
51884
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
51757
51885
  delete_automated_backups: typing.Optional[builtins.bool] = None,
51758
51886
  deletion_protection: typing.Optional[builtins.bool] = None,
51759
51887
  domain: typing.Optional[builtins.str] = None,
@@ -53019,6 +53147,7 @@ def _typecheckingstub__dbf7e60a650d0a1bea1826814200716f46cd1f59eea36a42193653d7f
53019
53147
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53020
53148
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53021
53149
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53150
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53022
53151
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53023
53152
  deletion_protection: typing.Optional[builtins.bool] = None,
53024
53153
  domain: typing.Optional[builtins.str] = None,
@@ -53095,6 +53224,7 @@ def _typecheckingstub__f06d86058a0a7538eb7dbf55de032c8cf05f7fa7b4ab5d5c1d47f7617
53095
53224
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53096
53225
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53097
53226
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53227
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53098
53228
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53099
53229
  deletion_protection: typing.Optional[builtins.bool] = None,
53100
53230
  domain: typing.Optional[builtins.str] = None,
@@ -53155,6 +53285,7 @@ def _typecheckingstub__23675ebe667ec40ba6afd82bf8b65d901cc9a4bfc79be222b108037d5
53155
53285
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53156
53286
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53157
53287
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53288
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53158
53289
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53159
53290
  deletion_protection: typing.Optional[builtins.bool] = None,
53160
53291
  domain: typing.Optional[builtins.str] = None,
@@ -53223,6 +53354,7 @@ def _typecheckingstub__b2082895d1c502ba05a38a32c44782a7480089cd804d396ed1b41ca4a
53223
53354
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53224
53355
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53225
53356
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53357
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53226
53358
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53227
53359
  deletion_protection: typing.Optional[builtins.bool] = None,
53228
53360
  domain: typing.Optional[builtins.str] = None,
@@ -53462,6 +53594,7 @@ def _typecheckingstub__cb12c4cf0f41b623c75db1c295b846314e730919538b3374019067232
53462
53594
  cloudwatch_logs_retention: typing.Optional[_RetentionDays_070f99f0] = None,
53463
53595
  cloudwatch_logs_retention_role: typing.Optional[_IRole_235f5d8e] = None,
53464
53596
  copy_tags_to_snapshot: typing.Optional[builtins.bool] = None,
53597
+ database_insights_mode: typing.Optional[DatabaseInsightsMode] = None,
53465
53598
  delete_automated_backups: typing.Optional[builtins.bool] = None,
53466
53599
  deletion_protection: typing.Optional[builtins.bool] = None,
53467
53600
  domain: typing.Optional[builtins.str] = None,