aws-cdk-lib 2.181.1__py3-none-any.whl → 2.183.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 (69) hide show
  1. aws_cdk/__init__.py +751 -41
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.181.1.jsii.tgz → aws-cdk-lib@2.183.0.jsii.tgz} +0 -0
  4. aws_cdk/assertions/__init__.py +59 -0
  5. aws_cdk/aws_apigateway/__init__.py +122 -66
  6. aws_cdk/aws_applicationautoscaling/__init__.py +4 -0
  7. aws_cdk/aws_appsync/__init__.py +30 -4
  8. aws_cdk/aws_autoscaling/__init__.py +409 -36
  9. aws_cdk/aws_batch/__init__.py +638 -14
  10. aws_cdk/aws_bedrock/__init__.py +6009 -2326
  11. aws_cdk/aws_ce/__init__.py +141 -3
  12. aws_cdk/aws_certificatemanager/__init__.py +24 -0
  13. aws_cdk/aws_cloudformation/__init__.py +310 -35
  14. aws_cdk/aws_cloudfront/__init__.py +1 -0
  15. aws_cdk/aws_cloudtrail/__init__.py +8 -8
  16. aws_cdk/aws_codebuild/__init__.py +4 -10
  17. aws_cdk/aws_cognito/__init__.py +3 -3
  18. aws_cdk/aws_datazone/__init__.py +82 -0
  19. aws_cdk/aws_dms/__init__.py +350 -0
  20. aws_cdk/aws_ec2/__init__.py +95 -17
  21. aws_cdk/aws_ecr/__init__.py +10 -4
  22. aws_cdk/aws_ecs/__init__.py +58 -9
  23. aws_cdk/aws_eks/__init__.py +32 -3
  24. aws_cdk/aws_elasticache/__init__.py +3 -3
  25. aws_cdk/aws_emr/__init__.py +9 -3
  26. aws_cdk/aws_fsx/__init__.py +2 -0
  27. aws_cdk/aws_gameliftstreams/__init__.py +1205 -0
  28. aws_cdk/aws_guardduty/__init__.py +38 -26
  29. aws_cdk/aws_iam/__init__.py +295 -37
  30. aws_cdk/aws_inspector/__init__.py +180 -1
  31. aws_cdk/aws_iot/__init__.py +616 -22
  32. aws_cdk/aws_iotfleetwise/__init__.py +72 -10
  33. aws_cdk/aws_iotsitewise/__init__.py +14 -11
  34. aws_cdk/aws_kafkaconnect/__init__.py +4 -2
  35. aws_cdk/aws_kinesisfirehose/__init__.py +6 -0
  36. aws_cdk/aws_lambda/__init__.py +17 -0
  37. aws_cdk/aws_logs/__init__.py +135 -0
  38. aws_cdk/aws_medialive/__init__.py +86 -86
  39. aws_cdk/aws_mediapackagev2/__init__.py +22 -14
  40. aws_cdk/aws_msk/__init__.py +236 -128
  41. aws_cdk/aws_neptunegraph/__init__.py +3 -3
  42. aws_cdk/aws_opensearchserverless/__init__.py +1031 -0
  43. aws_cdk/aws_opensearchservice/__init__.py +261 -1
  44. aws_cdk/aws_pcaconnectorad/__init__.py +30 -4
  45. aws_cdk/aws_pipes/__init__.py +6 -2
  46. aws_cdk/aws_quicksight/__init__.py +6712 -20758
  47. aws_cdk/aws_rds/__init__.py +174 -30
  48. aws_cdk/aws_redshift/__init__.py +8 -8
  49. aws_cdk/aws_s3/__init__.py +8 -0
  50. aws_cdk/aws_sagemaker/__init__.py +80 -18
  51. aws_cdk/aws_securitylake/__init__.py +3 -0
  52. aws_cdk/aws_sns/__init__.py +76 -1
  53. aws_cdk/aws_synthetics/__init__.py +2 -0
  54. aws_cdk/aws_transfer/__init__.py +241 -40
  55. aws_cdk/aws_vpclattice/__init__.py +144 -9
  56. aws_cdk/aws_wafv2/__init__.py +790 -0
  57. aws_cdk/aws_wisdom/__init__.py +3 -110
  58. aws_cdk/aws_workspacesthinclient/__init__.py +4 -4
  59. aws_cdk/aws_workspacesweb/__init__.py +179 -2
  60. aws_cdk/aws_xray/__init__.py +195 -0
  61. aws_cdk/cloud_assembly_schema/__init__.py +224 -4
  62. aws_cdk/custom_resources/__init__.py +65 -8
  63. aws_cdk/cx_api/__init__.py +2 -1
  64. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.183.0.dist-info}/METADATA +2 -2
  65. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.183.0.dist-info}/RECORD +69 -68
  66. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.183.0.dist-info}/LICENSE +0 -0
  67. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.183.0.dist-info}/NOTICE +0 -0
  68. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.183.0.dist-info}/WHEEL +0 -0
  69. {aws_cdk_lib-2.181.1.dist-info → aws_cdk_lib-2.183.0.dist-info}/top_level.txt +0 -0
@@ -464,6 +464,27 @@ cluster = rds.DatabaseCluster(self, "Database",
464
464
  )
465
465
  ```
466
466
 
467
+ ### Creating a read replica cluster
468
+
469
+ Use `replicationSourceIdentifier` to create a read replica cluster:
470
+
471
+ ```python
472
+ # vpc: ec2.Vpc
473
+ # primary_cluster: rds.DatabaseCluster
474
+
475
+
476
+ rds.DatabaseCluster(self, "DatabaseCluster",
477
+ engine=rds.DatabaseClusterEngine.aurora_mysql(
478
+ version=rds.AuroraMysqlEngineVersion.VER_3_03_0
479
+ ),
480
+ writer=rds.ClusterInstance.serverless_v2("Writer"),
481
+ vpc=vpc,
482
+ replication_source_identifier=primary_cluster.cluster_arn
483
+ )
484
+ ```
485
+
486
+ **Note**: Cannot create a read replica cluster with `credentials` as the value is inherited from the source DB cluster.
487
+
467
488
  ## Starting an instance database
468
489
 
469
490
  To set up an instance database, define a `DatabaseInstance`. You must
@@ -2238,17 +2259,11 @@ class AuroraMysqlClusterEngineProps:
2238
2259
 
2239
2260
  cluster = rds.DatabaseCluster(self, "Database",
2240
2261
  engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_01_0),
2241
- credentials=rds.Credentials.from_generated_secret("clusteradmin"), # Optional - will default to 'admin' username and generated password
2242
- writer=rds.ClusterInstance.provisioned("writer",
2243
- publicly_accessible=False
2244
- ),
2245
- readers=[
2246
- rds.ClusterInstance.provisioned("reader1", promotion_tier=1),
2247
- rds.ClusterInstance.serverless_v2("reader2")
2248
- ],
2249
- vpc_subnets=ec2.SubnetSelection(
2250
- subnet_type=ec2.SubnetType.PRIVATE_WITH_EGRESS
2262
+ writer=rds.ClusterInstance.provisioned("Instance",
2263
+ instance_type=ec2.InstanceType.of(ec2.InstanceClass.BURSTABLE3, ec2.InstanceSize.SMALL)
2251
2264
  ),
2265
+ readers=[rds.ClusterInstance.provisioned("reader")],
2266
+ instance_update_behaviour=rds.InstanceUpdateBehaviour.ROLLING, # Optional - defaults to rds.InstanceUpdateBehaviour.BULK
2252
2267
  vpc=vpc
2253
2268
  )
2254
2269
  '''
@@ -5131,7 +5146,7 @@ class CfnDBCluster(
5131
5146
  :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
5132
5147
  :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.
5133
5148
  :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
5134
- :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 only
5149
+ :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
5135
5150
  :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
5136
5151
  :param db_cluster_identifier: The DB cluster identifier. This parameter is stored as a lowercase string. Constraints: - Must contain from 1 to 63 letters, numbers, or hyphens. - First character must be a letter. - Can't end with a hyphen or contain two consecutive hyphens. Example: ``my-cluster1`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
5137
5152
  :param db_cluster_instance_class: The compute and memory capacity of each DB instance in the Multi-AZ DB cluster, for example ``db.m6gd.xlarge`` . Not all DB instance classes are available in all AWS Regions , or for all database engines. For the full list of DB instance classes and availability for your engine, see `DB instance class <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html>`_ in the *Amazon RDS User Guide* . This setting is required to create a Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only
@@ -7325,7 +7340,7 @@ class CfnDBClusterProps:
7325
7340
  :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
7326
7341
  :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.
7327
7342
  :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
7328
- :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 only
7343
+ :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
7329
7344
  :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
7330
7345
  :param db_cluster_identifier: The DB cluster identifier. This parameter is stored as a lowercase string. Constraints: - Must contain from 1 to 63 letters, numbers, or hyphens. - First character must be a letter. - Can't end with a hyphen or contain two consecutive hyphens. Example: ``my-cluster1`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
7331
7346
  :param db_cluster_instance_class: The compute and memory capacity of each DB instance in the Multi-AZ DB cluster, for example ``db.m6gd.xlarge`` . Not all DB instance classes are available in all AWS Regions , or for all database engines. For the full list of DB instance classes and availability for your engine, see `DB instance class <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html>`_ in the *Amazon RDS User Guide* . This setting is required to create a Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only
@@ -7770,7 +7785,7 @@ class CfnDBClusterProps:
7770
7785
 
7771
7786
  If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465.
7772
7787
 
7773
- Valid for Cluster Type: Aurora DB clusters only
7788
+ Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
7774
7789
 
7775
7790
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-databaseinsightsmode
7776
7791
  '''
@@ -8955,7 +8970,7 @@ class CfnDBInstance(
8955
8970
  :param db_parameter_group_name: The name of an existing DB parameter group or a reference to an `AWS::RDS::DBParameterGroup <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-dbparametergroup.html>`_ resource created in the template. To list all of the available DB parameter group names, use the following command: ``aws rds describe-db-parameter-groups --query "DBParameterGroups[].DBParameterGroupName" --output text`` .. epigraph:: If any of the data members of the referenced parameter group are changed during an update, the DB instance might need to be restarted, which causes some interruption. If the parameter group contains static parameters, whether they were changed or not, an update triggers a reboot. If you don't specify a value for ``DBParameterGroupName`` property, the default DB parameter group for the specified engine and engine version is used.
8956
8971
  :param db_security_groups: A list of the DB security groups to assign to the DB instance. The list can include both the name of existing DB security groups or references to AWS::RDS::DBSecurityGroup resources created in the template. If you set DBSecurityGroups, you must not set VPCSecurityGroups, and vice versa. Also, note that the DBSecurityGroups property exists only for backwards compatibility with older regions and is no longer recommended for providing security information to an RDS DB instance. Instead, use VPCSecurityGroups. .. epigraph:: If you specify this property, AWS CloudFormation sends only the following properties (if specified) to Amazon RDS during create operations: - ``AllocatedStorage`` - ``AutoMinorVersionUpgrade`` - ``AvailabilityZone`` - ``BackupRetentionPeriod`` - ``CharacterSetName`` - ``DBInstanceClass`` - ``DBName`` - ``DBParameterGroupName`` - ``DBSecurityGroups`` - ``DBSubnetGroupName`` - ``Engine`` - ``EngineVersion`` - ``Iops`` - ``LicenseModel`` - ``MasterUsername`` - ``MasterUserPassword`` - ``MultiAZ`` - ``OptionGroupName`` - ``PreferredBackupWindow`` - ``PreferredMaintenanceWindow`` All other properties are ignored. Specify a virtual private cloud (VPC) security group if you want to submit other properties, such as ``StorageType`` , ``StorageEncrypted`` , or ``KmsKeyId`` . If you're already using the ``DBSecurityGroups`` property, you can't use these other properties by updating your DB instance to use a VPC security group. You must recreate the DB instance.
8957
8972
  :param db_snapshot_identifier: The name or Amazon Resource Name (ARN) of the DB snapshot that's used to restore the DB instance. If you're restoring from a shared manual DB snapshot, you must specify the ARN of the snapshot. By specifying this property, you can create a DB instance from the specified DB snapshot. If the ``DBSnapshotIdentifier`` property is an empty string or the ``AWS::RDS::DBInstance`` declaration has no ``DBSnapshotIdentifier`` property, AWS CloudFormation creates a new database. If the property contains a value (other than an empty string), AWS CloudFormation creates a database from the specified snapshot. If a snapshot with the specified name doesn't exist, AWS CloudFormation can't create the database and it rolls back the stack. Some DB instance properties aren't valid when you restore from a snapshot, such as the ``MasterUsername`` and ``MasterUserPassword`` properties, and the point-in-time recovery properties ``RestoreTime`` and ``UseLatestRestorableTime`` . For information about the properties that you can specify, see the ```RestoreDBInstanceFromDBSnapshot`` <https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html>`_ action in the *Amazon RDS API Reference* . After you restore a DB instance with a ``DBSnapshotIdentifier`` property, you must specify the same ``DBSnapshotIdentifier`` property for any future updates to the DB instance. When you specify this property for an update, the DB instance is not restored from the DB snapshot again, and the data in the database is not changed. However, if you don't specify the ``DBSnapshotIdentifier`` property, an empty DB instance is created, and the original DB instance is deleted. If you specify a property that is different from the previous snapshot restore property, a new DB instance is restored from the specified ``DBSnapshotIdentifier`` property, and the original DB instance is deleted. If you specify the ``DBSnapshotIdentifier`` property to restore a DB instance (as opposed to specifying it for DB instance updates), then don't specify the following properties: - ``CharacterSetName`` - ``DBClusterIdentifier`` - ``DBName`` - ``KmsKeyId`` - ``MasterUsername`` - ``MasterUserPassword`` - ``PromotionTier`` - ``SourceDBInstanceIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an unencrypted snapshot) - ``Timezone`` *Amazon Aurora* Not applicable. Snapshot restore is managed by the DB cluster.
8958
- :param db_subnet_group_name: A DB subnet group to associate with the DB instance. If you update this value, the new subnet group must be a subnet group in a new VPC. If there's no DB subnet group, then the DB instance isn't a VPC DB instance. For more information about using Amazon RDS in a VPC, see `Amazon VPC and Amazon RDS <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to Amazon Aurora DB instances. The DB subnet group is managed by the DB cluster. If specified, the setting must match the DB cluster setting.
8973
+ :param db_subnet_group_name: A DB subnet group to associate with the DB instance. If you update this value, the new subnet group must be a subnet group in a new VPC. If you don't specify a DB subnet group, RDS uses the default DB subnet group if one exists. If a default DB subnet group does not exist, and you don't specify a ``DBSubnetGroupName`` , the DB instance fails to launch. For more information about using Amazon RDS in a VPC, see `Amazon VPC and Amazon RDS <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to Amazon Aurora DB instances. The DB subnet group is managed by the DB cluster. If specified, the setting must match the DB cluster setting.
8959
8974
  :param db_system_id: The Oracle system identifier (SID), which is the name of the Oracle database instance that manages your database files. In this context, the term "Oracle database instance" refers exclusively to the system global area (SGA) and Oracle background processes. If you don't specify a SID, the value defaults to ``RDSCDB`` . The Oracle SID is also the name of your CDB.
8960
8975
  :param dedicated_log_volume: Indicates whether the DB instance has a dedicated log volume (DLV) enabled.
8961
8976
  :param delete_automated_backups: A value that indicates whether to remove automated backups immediately after the DB instance is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB instance is deleted. *Amazon Aurora* Not applicable. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the DB cluster are not deleted.
@@ -11027,7 +11042,7 @@ class CfnDBInstanceProps:
11027
11042
  :param db_parameter_group_name: The name of an existing DB parameter group or a reference to an `AWS::RDS::DBParameterGroup <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-dbparametergroup.html>`_ resource created in the template. To list all of the available DB parameter group names, use the following command: ``aws rds describe-db-parameter-groups --query "DBParameterGroups[].DBParameterGroupName" --output text`` .. epigraph:: If any of the data members of the referenced parameter group are changed during an update, the DB instance might need to be restarted, which causes some interruption. If the parameter group contains static parameters, whether they were changed or not, an update triggers a reboot. If you don't specify a value for ``DBParameterGroupName`` property, the default DB parameter group for the specified engine and engine version is used.
11028
11043
  :param db_security_groups: A list of the DB security groups to assign to the DB instance. The list can include both the name of existing DB security groups or references to AWS::RDS::DBSecurityGroup resources created in the template. If you set DBSecurityGroups, you must not set VPCSecurityGroups, and vice versa. Also, note that the DBSecurityGroups property exists only for backwards compatibility with older regions and is no longer recommended for providing security information to an RDS DB instance. Instead, use VPCSecurityGroups. .. epigraph:: If you specify this property, AWS CloudFormation sends only the following properties (if specified) to Amazon RDS during create operations: - ``AllocatedStorage`` - ``AutoMinorVersionUpgrade`` - ``AvailabilityZone`` - ``BackupRetentionPeriod`` - ``CharacterSetName`` - ``DBInstanceClass`` - ``DBName`` - ``DBParameterGroupName`` - ``DBSecurityGroups`` - ``DBSubnetGroupName`` - ``Engine`` - ``EngineVersion`` - ``Iops`` - ``LicenseModel`` - ``MasterUsername`` - ``MasterUserPassword`` - ``MultiAZ`` - ``OptionGroupName`` - ``PreferredBackupWindow`` - ``PreferredMaintenanceWindow`` All other properties are ignored. Specify a virtual private cloud (VPC) security group if you want to submit other properties, such as ``StorageType`` , ``StorageEncrypted`` , or ``KmsKeyId`` . If you're already using the ``DBSecurityGroups`` property, you can't use these other properties by updating your DB instance to use a VPC security group. You must recreate the DB instance.
11029
11044
  :param db_snapshot_identifier: The name or Amazon Resource Name (ARN) of the DB snapshot that's used to restore the DB instance. If you're restoring from a shared manual DB snapshot, you must specify the ARN of the snapshot. By specifying this property, you can create a DB instance from the specified DB snapshot. If the ``DBSnapshotIdentifier`` property is an empty string or the ``AWS::RDS::DBInstance`` declaration has no ``DBSnapshotIdentifier`` property, AWS CloudFormation creates a new database. If the property contains a value (other than an empty string), AWS CloudFormation creates a database from the specified snapshot. If a snapshot with the specified name doesn't exist, AWS CloudFormation can't create the database and it rolls back the stack. Some DB instance properties aren't valid when you restore from a snapshot, such as the ``MasterUsername`` and ``MasterUserPassword`` properties, and the point-in-time recovery properties ``RestoreTime`` and ``UseLatestRestorableTime`` . For information about the properties that you can specify, see the ```RestoreDBInstanceFromDBSnapshot`` <https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html>`_ action in the *Amazon RDS API Reference* . After you restore a DB instance with a ``DBSnapshotIdentifier`` property, you must specify the same ``DBSnapshotIdentifier`` property for any future updates to the DB instance. When you specify this property for an update, the DB instance is not restored from the DB snapshot again, and the data in the database is not changed. However, if you don't specify the ``DBSnapshotIdentifier`` property, an empty DB instance is created, and the original DB instance is deleted. If you specify a property that is different from the previous snapshot restore property, a new DB instance is restored from the specified ``DBSnapshotIdentifier`` property, and the original DB instance is deleted. If you specify the ``DBSnapshotIdentifier`` property to restore a DB instance (as opposed to specifying it for DB instance updates), then don't specify the following properties: - ``CharacterSetName`` - ``DBClusterIdentifier`` - ``DBName`` - ``KmsKeyId`` - ``MasterUsername`` - ``MasterUserPassword`` - ``PromotionTier`` - ``SourceDBInstanceIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an unencrypted snapshot) - ``Timezone`` *Amazon Aurora* Not applicable. Snapshot restore is managed by the DB cluster.
11030
- :param db_subnet_group_name: A DB subnet group to associate with the DB instance. If you update this value, the new subnet group must be a subnet group in a new VPC. If there's no DB subnet group, then the DB instance isn't a VPC DB instance. For more information about using Amazon RDS in a VPC, see `Amazon VPC and Amazon RDS <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to Amazon Aurora DB instances. The DB subnet group is managed by the DB cluster. If specified, the setting must match the DB cluster setting.
11045
+ :param db_subnet_group_name: A DB subnet group to associate with the DB instance. If you update this value, the new subnet group must be a subnet group in a new VPC. If you don't specify a DB subnet group, RDS uses the default DB subnet group if one exists. If a default DB subnet group does not exist, and you don't specify a ``DBSubnetGroupName`` , the DB instance fails to launch. For more information about using Amazon RDS in a VPC, see `Amazon VPC and Amazon RDS <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to Amazon Aurora DB instances. The DB subnet group is managed by the DB cluster. If specified, the setting must match the DB cluster setting.
11031
11046
  :param db_system_id: The Oracle system identifier (SID), which is the name of the Oracle database instance that manages your database files. In this context, the term "Oracle database instance" refers exclusively to the system global area (SGA) and Oracle background processes. If you don't specify a SID, the value defaults to ``RDSCDB`` . The Oracle SID is also the name of your CDB.
11032
11047
  :param dedicated_log_volume: Indicates whether the DB instance has a dedicated log volume (DLV) enabled.
11033
11048
  :param delete_automated_backups: A value that indicates whether to remove automated backups immediately after the DB instance is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB instance is deleted. *Amazon Aurora* Not applicable. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the DB cluster are not deleted.
@@ -11948,7 +11963,7 @@ class CfnDBInstanceProps:
11948
11963
 
11949
11964
  If you update this value, the new subnet group must be a subnet group in a new VPC.
11950
11965
 
11951
- If there's no DB subnet group, then the DB instance isn't a VPC DB instance.
11966
+ If you don't specify a DB subnet group, RDS uses the default DB subnet group if one exists. If a default DB subnet group does not exist, and you don't specify a ``DBSubnetGroupName`` , the DB instance fails to launch.
11952
11967
 
11953
11968
  For more information about using Amazon RDS in a VPC, see `Amazon VPC and Amazon RDS <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html>`_ in the *Amazon RDS User Guide* .
11954
11969
 
@@ -14846,7 +14861,7 @@ class CfnDBProxyTargetGroup(
14846
14861
  '''Specifies the settings that control the size and behavior of the connection pool associated with a ``DBProxyTargetGroup`` .
14847
14862
 
14848
14863
  :param connection_borrow_timeout: The number of seconds for a proxy to wait for a connection to become available in the connection pool. This setting only applies when the proxy has opened its maximum number of connections and all connections are busy with client sessions. Default: ``120`` Constraints: - Must be between 0 and 3600.
14849
- :param init_query: One or more SQL statements for the proxy to run when opening each new database connection. Typically used with ``SET`` statements to make sure that each connection has identical settings such as time zone and character set. For multiple statements, use semicolons as the separator. You can also include multiple variables in a single ``SET`` statement, such as ``SET x=1, y=2`` . Default: no initialization query
14864
+ :param init_query: Add an initialization query, or modify the current one. You can specify one or more SQL statements for the proxy to run when opening each new database connection. The setting is typically used with ``SET`` statements to make sure that each connection has identical settings. Make sure that the query you add is valid. To include multiple variables in a single ``SET`` statement, use comma separators. For example: ``SET variable1=value1, variable2=value2`` For multiple statements, use semicolons as the separator. Default: no initialization query
14850
14865
  :param max_connections_percent: The maximum size of the connection pool for each target in a target group. The value is expressed as a percentage of the ``max_connections`` setting for the RDS DB instance or Aurora DB cluster used by the target group. If you specify ``MaxIdleConnectionsPercent`` , then you must also include a value for this parameter. Default: ``10`` for RDS for Microsoft SQL Server, and ``100`` for all other engines Constraints: - Must be between 1 and 100.
14851
14866
  :param max_idle_connections_percent: A value that controls how actively the proxy closes idle database connections in the connection pool. The value is expressed as a percentage of the ``max_connections`` setting for the RDS DB instance or Aurora DB cluster used by the target group. With a high value, the proxy leaves a high percentage of idle database connections open. A low value causes the proxy to close more idle connections and return them to the database. If you specify this parameter, then you must also include a value for ``MaxConnectionsPercent`` . Default: The default value is half of the value of ``MaxConnectionsPercent`` . For example, if ``MaxConnectionsPercent`` is 80, then the default value of ``MaxIdleConnectionsPercent`` is 40. If the value of ``MaxConnectionsPercent`` isn't specified, then for SQL Server, ``MaxIdleConnectionsPercent`` is ``5`` , and for all other engines, the default is ``50`` . Constraints: - Must be between 0 and the value of ``MaxConnectionsPercent`` .
14852
14867
  :param session_pinning_filters: Each item in the list represents a class of SQL operations that normally cause all later statements in a session using a proxy to be pinned to the same underlying database connection. Including an item in the list exempts that class of SQL operations from the pinning behavior. Default: no session pinning filters
@@ -14906,9 +14921,13 @@ class CfnDBProxyTargetGroup(
14906
14921
 
14907
14922
  @builtins.property
14908
14923
  def init_query(self) -> typing.Optional[builtins.str]:
14909
- '''One or more SQL statements for the proxy to run when opening each new database connection.
14924
+ '''Add an initialization query, or modify the current one.
14910
14925
 
14911
- Typically used with ``SET`` statements to make sure that each connection has identical settings such as time zone and character set. For multiple statements, use semicolons as the separator. You can also include multiple variables in a single ``SET`` statement, such as ``SET x=1, y=2`` .
14926
+ You can specify one or more SQL statements for the proxy to run when opening each new database connection. The setting is typically used with ``SET`` statements to make sure that each connection has identical settings. Make sure that the query you add is valid. To include multiple variables in a single ``SET`` statement, use comma separators.
14927
+
14928
+ For example: ``SET variable1=value1, variable2=value2``
14929
+
14930
+ For multiple statements, use semicolons as the separator.
14912
14931
 
14913
14932
  Default: no initialization query
14914
14933
 
@@ -21950,6 +21969,7 @@ class DatabaseClusterFromSnapshotProps:
21950
21969
  "preferred_maintenance_window": "preferredMaintenanceWindow",
21951
21970
  "readers": "readers",
21952
21971
  "removal_policy": "removalPolicy",
21972
+ "replication_source_identifier": "replicationSourceIdentifier",
21953
21973
  "s3_export_buckets": "s3ExportBuckets",
21954
21974
  "s3_export_role": "s3ExportRole",
21955
21975
  "s3_import_buckets": "s3ImportBuckets",
@@ -22007,6 +22027,7 @@ class DatabaseClusterProps:
22007
22027
  preferred_maintenance_window: typing.Optional[builtins.str] = None,
22008
22028
  readers: typing.Optional[typing.Sequence["IClusterInstance"]] = None,
22009
22029
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
22030
+ replication_source_identifier: typing.Optional[builtins.str] = None,
22010
22031
  s3_export_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
22011
22032
  s3_export_role: typing.Optional[_IRole_235f5d8e] = None,
22012
22033
  s3_import_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
@@ -22061,6 +22082,7 @@ class DatabaseClusterProps:
22061
22082
  :param preferred_maintenance_window: A preferred maintenance window day/time range. Should be specified as a range ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). Example: 'Sun:23:45-Mon:00:15' Default: - 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.
22062
22083
  :param readers: A list of instances to create as cluster reader instances. Default: - no readers are created. The cluster will have a single writer/reader
22063
22084
  :param removal_policy: The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update. Default: - RemovalPolicy.SNAPSHOT (remove the cluster and instances, but retain a snapshot of the data)
22085
+ :param replication_source_identifier: The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a read replica. Cannot be used with credentials. Default: - This DB Cluster is not a read replica
22064
22086
  :param s3_export_buckets: S3 buckets that you want to load data into. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ExportRole`` is used. For MySQL: Default: - None
22065
22087
  :param s3_export_role: Role that will be associated with this DB cluster to enable S3 export. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ExportBuckets`` is used. To use this property with Aurora PostgreSQL, it must be configured with the S3 export feature enabled when creating the DatabaseClusterEngine For MySQL: Default: - New role is created if ``s3ExportBuckets`` is set, no role is defined otherwise
22066
22088
  :param s3_import_buckets: S3 buckets that you want to load data from. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ImportRole`` is used. For MySQL: Default: - None
@@ -22143,6 +22165,7 @@ class DatabaseClusterProps:
22143
22165
  check_type(argname="argument preferred_maintenance_window", value=preferred_maintenance_window, expected_type=type_hints["preferred_maintenance_window"])
22144
22166
  check_type(argname="argument readers", value=readers, expected_type=type_hints["readers"])
22145
22167
  check_type(argname="argument removal_policy", value=removal_policy, expected_type=type_hints["removal_policy"])
22168
+ check_type(argname="argument replication_source_identifier", value=replication_source_identifier, expected_type=type_hints["replication_source_identifier"])
22146
22169
  check_type(argname="argument s3_export_buckets", value=s3_export_buckets, expected_type=type_hints["s3_export_buckets"])
22147
22170
  check_type(argname="argument s3_export_role", value=s3_export_role, expected_type=type_hints["s3_export_role"])
22148
22171
  check_type(argname="argument s3_import_buckets", value=s3_import_buckets, expected_type=type_hints["s3_import_buckets"])
@@ -22232,6 +22255,8 @@ class DatabaseClusterProps:
22232
22255
  self._values["readers"] = readers
22233
22256
  if removal_policy is not None:
22234
22257
  self._values["removal_policy"] = removal_policy
22258
+ if replication_source_identifier is not None:
22259
+ self._values["replication_source_identifier"] = replication_source_identifier
22235
22260
  if s3_export_buckets is not None:
22236
22261
  self._values["s3_export_buckets"] = s3_export_buckets
22237
22262
  if s3_export_role is not None:
@@ -22670,6 +22695,17 @@ class DatabaseClusterProps:
22670
22695
  result = self._values.get("removal_policy")
22671
22696
  return typing.cast(typing.Optional[_RemovalPolicy_9f93c814], result)
22672
22697
 
22698
+ @builtins.property
22699
+ def replication_source_identifier(self) -> typing.Optional[builtins.str]:
22700
+ '''The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a read replica.
22701
+
22702
+ Cannot be used with credentials.
22703
+
22704
+ :default: - This DB Cluster is not a read replica
22705
+ '''
22706
+ result = self._values.get("replication_source_identifier")
22707
+ return typing.cast(typing.Optional[builtins.str], result)
22708
+
22673
22709
  @builtins.property
22674
22710
  def s3_export_buckets(self) -> typing.Optional[typing.List[_IBucket_42e086fd]]:
22675
22711
  '''S3 buckets that you want to load data into. This feature is only supported by the Aurora database engine.
@@ -31172,6 +31208,12 @@ class MariaDbEngineVersion(
31172
31208
  '''Version "10.11.10".'''
31173
31209
  return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_11_10"))
31174
31210
 
31211
+ @jsii.python.classproperty
31212
+ @jsii.member(jsii_name="VER_10_11_11")
31213
+ def VER_10_11_11(cls) -> "MariaDbEngineVersion":
31214
+ '''Version "10.11.11".'''
31215
+ return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_11_11"))
31216
+
31175
31217
  @jsii.python.classproperty
31176
31218
  @jsii.member(jsii_name="VER_10_11_4")
31177
31219
  def VER_10_11_4(cls) -> "MariaDbEngineVersion":
@@ -31777,6 +31819,12 @@ class MariaDbEngineVersion(
31777
31819
  '''Version "10.5.27".'''
31778
31820
  return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_5_27"))
31779
31821
 
31822
+ @jsii.python.classproperty
31823
+ @jsii.member(jsii_name="VER_10_5_28")
31824
+ def VER_10_5_28(cls) -> "MariaDbEngineVersion":
31825
+ '''Version "10.5.28".'''
31826
+ return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_5_28"))
31827
+
31780
31828
  @jsii.python.classproperty
31781
31829
  @jsii.member(jsii_name="VER_10_5_8")
31782
31830
  def VER_10_5_8(cls) -> "MariaDbEngineVersion":
@@ -31886,6 +31934,12 @@ class MariaDbEngineVersion(
31886
31934
  '''Version "10.6.20".'''
31887
31935
  return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_6_20"))
31888
31936
 
31937
+ @jsii.python.classproperty
31938
+ @jsii.member(jsii_name="VER_10_6_21")
31939
+ def VER_10_6_21(cls) -> "MariaDbEngineVersion":
31940
+ '''Version "10.6.21".'''
31941
+ return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_6_21"))
31942
+
31889
31943
  @jsii.python.classproperty
31890
31944
  @jsii.member(jsii_name="VER_10_6_5")
31891
31945
  def VER_10_6_5(cls) -> "MariaDbEngineVersion":
@@ -31931,6 +31985,12 @@ class MariaDbEngineVersion(
31931
31985
  '''Version "11.4.4".'''
31932
31986
  return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_11_4_4"))
31933
31987
 
31988
+ @jsii.python.classproperty
31989
+ @jsii.member(jsii_name="VER_11_4_5")
31990
+ def VER_11_4_5(cls) -> "MariaDbEngineVersion":
31991
+ '''Version "11.4.5".'''
31992
+ return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_11_4_5"))
31993
+
31934
31994
  @builtins.property
31935
31995
  @jsii.member(jsii_name="mariaDbFullVersion")
31936
31996
  def maria_db_full_version(self) -> builtins.str:
@@ -32387,6 +32447,18 @@ class MysqlEngineVersion(
32387
32447
  '''Version "5.7.44-rds.20240808".'''
32388
32448
  return typing.cast("MysqlEngineVersion", jsii.sget(cls, "VER_5_7_44_RDS_20240808"))
32389
32449
 
32450
+ @jsii.python.classproperty
32451
+ @jsii.member(jsii_name="VER_5_7_44_RDS_20250103")
32452
+ def VER_5_7_44_RDS_20250103(cls) -> "MysqlEngineVersion":
32453
+ '''Version "5.7.44-rds.20250103".'''
32454
+ return typing.cast("MysqlEngineVersion", jsii.sget(cls, "VER_5_7_44_RDS_20250103"))
32455
+
32456
+ @jsii.python.classproperty
32457
+ @jsii.member(jsii_name="VER_5_7_44_RDS_20250213")
32458
+ def VER_5_7_44_RDS_20250213(cls) -> "MysqlEngineVersion":
32459
+ '''Version "5.7.44-rds.20250213".'''
32460
+ return typing.cast("MysqlEngineVersion", jsii.sget(cls, "VER_5_7_44_RDS_20250213"))
32461
+
32390
32462
  @jsii.python.classproperty
32391
32463
  @jsii.member(jsii_name="VER_8_0")
32392
32464
  def VER_8_0(cls) -> "MysqlEngineVersion":
@@ -32617,12 +32689,24 @@ class MysqlEngineVersion(
32617
32689
  '''Version "8.0.40".'''
32618
32690
  return typing.cast("MysqlEngineVersion", jsii.sget(cls, "VER_8_0_40"))
32619
32691
 
32692
+ @jsii.python.classproperty
32693
+ @jsii.member(jsii_name="VER_8_0_41")
32694
+ def VER_8_0_41(cls) -> "MysqlEngineVersion":
32695
+ '''Version "8.0.41".'''
32696
+ return typing.cast("MysqlEngineVersion", jsii.sget(cls, "VER_8_0_41"))
32697
+
32620
32698
  @jsii.python.classproperty
32621
32699
  @jsii.member(jsii_name="VER_8_4_3")
32622
32700
  def VER_8_4_3(cls) -> "MysqlEngineVersion":
32623
32701
  '''Version "8.4.3".'''
32624
32702
  return typing.cast("MysqlEngineVersion", jsii.sget(cls, "VER_8_4_3"))
32625
32703
 
32704
+ @jsii.python.classproperty
32705
+ @jsii.member(jsii_name="VER_8_4_4")
32706
+ def VER_8_4_4(cls) -> "MysqlEngineVersion":
32707
+ '''Version "8.4.4".'''
32708
+ return typing.cast("MysqlEngineVersion", jsii.sget(cls, "VER_8_4_4"))
32709
+
32626
32710
  @builtins.property
32627
32711
  @jsii.member(jsii_name="mysqlFullVersion")
32628
32712
  def mysql_full_version(self) -> builtins.str:
@@ -35645,19 +35729,34 @@ class PostgresEngineVersion(
35645
35729
  @jsii.python.classproperty
35646
35730
  @jsii.member(jsii_name="VER_13_11")
35647
35731
  def VER_13_11(cls) -> "PostgresEngineVersion":
35648
- '''Version "13.11".'''
35732
+ '''(deprecated) Version "13.11".
35733
+
35734
+ :deprecated: PostgreSQL 13.11 is no longer supported by Amazon RDS.
35735
+
35736
+ :stability: deprecated
35737
+ '''
35649
35738
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_13_11"))
35650
35739
 
35651
35740
  @jsii.python.classproperty
35652
35741
  @jsii.member(jsii_name="VER_13_12")
35653
35742
  def VER_13_12(cls) -> "PostgresEngineVersion":
35654
- '''Version "13.12".'''
35743
+ '''(deprecated) Version "13.12".
35744
+
35745
+ :deprecated: PostgreSQL 13.12 is no longer supported by Amazon RDS.
35746
+
35747
+ :stability: deprecated
35748
+ '''
35655
35749
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_13_12"))
35656
35750
 
35657
35751
  @jsii.python.classproperty
35658
35752
  @jsii.member(jsii_name="VER_13_13")
35659
35753
  def VER_13_13(cls) -> "PostgresEngineVersion":
35660
- '''Version "13.13".'''
35754
+ '''(deprecated) Version "13.13".
35755
+
35756
+ :deprecated: PostgreSQL 13.13 is no longer supported by Amazon RDS.
35757
+
35758
+ :stability: deprecated
35759
+ '''
35661
35760
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_13_13"))
35662
35761
 
35663
35762
  @jsii.python.classproperty
@@ -35810,13 +35909,23 @@ class PostgresEngineVersion(
35810
35909
  @jsii.python.classproperty
35811
35910
  @jsii.member(jsii_name="VER_14_10")
35812
35911
  def VER_14_10(cls) -> "PostgresEngineVersion":
35813
- '''Version "14.10".'''
35912
+ '''(deprecated) Version "14.10".
35913
+
35914
+ :deprecated: PostgreSQL 14.10 is no longer supported by Amazon RDS.
35915
+
35916
+ :stability: deprecated
35917
+ '''
35814
35918
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_14_10"))
35815
35919
 
35816
35920
  @jsii.python.classproperty
35817
35921
  @jsii.member(jsii_name="VER_14_11")
35818
35922
  def VER_14_11(cls) -> "PostgresEngineVersion":
35819
- '''Version "14.11".'''
35923
+ '''(deprecated) Version "14.11".
35924
+
35925
+ :deprecated: PostgreSQL 14.11 is no longer supported by Amazon RDS.
35926
+
35927
+ :stability: deprecated
35928
+ '''
35820
35929
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_14_11"))
35821
35930
 
35822
35931
  @jsii.python.classproperty
@@ -35935,7 +36044,12 @@ class PostgresEngineVersion(
35935
36044
  @jsii.python.classproperty
35936
36045
  @jsii.member(jsii_name="VER_14_9")
35937
36046
  def VER_14_9(cls) -> "PostgresEngineVersion":
35938
- '''Version "14.9".'''
36047
+ '''(deprecated) Version "14.9".
36048
+
36049
+ :deprecated: PostgreSQL 14.9 is no longer supported by Amazon RDS.
36050
+
36051
+ :stability: deprecated
36052
+ '''
35939
36053
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_14_9"))
35940
36054
 
35941
36055
  @jsii.python.classproperty
@@ -35987,19 +36101,34 @@ class PostgresEngineVersion(
35987
36101
  @jsii.python.classproperty
35988
36102
  @jsii.member(jsii_name="VER_15_4")
35989
36103
  def VER_15_4(cls) -> "PostgresEngineVersion":
35990
- '''Version "15.4".'''
36104
+ '''(deprecated) Version "15.4".
36105
+
36106
+ :deprecated: PostgreSQL 15.4 is no longer supported by Amazon RDS.
36107
+
36108
+ :stability: deprecated
36109
+ '''
35991
36110
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_15_4"))
35992
36111
 
35993
36112
  @jsii.python.classproperty
35994
36113
  @jsii.member(jsii_name="VER_15_5")
35995
36114
  def VER_15_5(cls) -> "PostgresEngineVersion":
35996
- '''Version "15.5".'''
36115
+ '''(deprecated) Version "15.5".
36116
+
36117
+ :deprecated: PostgreSQL 15.5 is no longer supported by Amazon RDS
36118
+
36119
+ :stability: deprecated
36120
+ '''
35997
36121
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_15_5"))
35998
36122
 
35999
36123
  @jsii.python.classproperty
36000
36124
  @jsii.member(jsii_name="VER_15_6")
36001
36125
  def VER_15_6(cls) -> "PostgresEngineVersion":
36002
- '''Version "15.6".'''
36126
+ '''(deprecated) Version "15.6".
36127
+
36128
+ :deprecated: PostgreSQL 15.6 is no longer supported by Amazon RDS
36129
+
36130
+ :stability: deprecated
36131
+ '''
36003
36132
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_15_6"))
36004
36133
 
36005
36134
  @jsii.python.classproperty
@@ -36029,13 +36158,23 @@ class PostgresEngineVersion(
36029
36158
  @jsii.python.classproperty
36030
36159
  @jsii.member(jsii_name="VER_16_1")
36031
36160
  def VER_16_1(cls) -> "PostgresEngineVersion":
36032
- '''Version "16.1".'''
36161
+ '''(deprecated) Version "16.1".
36162
+
36163
+ :deprecated: PostgreSQL 16.1 is no longer supported by Amazon RDS
36164
+
36165
+ :stability: deprecated
36166
+ '''
36033
36167
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_16_1"))
36034
36168
 
36035
36169
  @jsii.python.classproperty
36036
36170
  @jsii.member(jsii_name="VER_16_2")
36037
36171
  def VER_16_2(cls) -> "PostgresEngineVersion":
36038
- '''Version "16.2".'''
36172
+ '''(deprecated) Version "16.2".
36173
+
36174
+ :deprecated: PostgreSQL 16.2 is no longer supported by Amazon RDS
36175
+
36176
+ :stability: deprecated
36177
+ '''
36039
36178
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_16_2"))
36040
36179
 
36041
36180
  @jsii.python.classproperty
@@ -46044,6 +46183,7 @@ class DatabaseCluster(
46044
46183
  preferred_maintenance_window: typing.Optional[builtins.str] = None,
46045
46184
  readers: typing.Optional[typing.Sequence[IClusterInstance]] = None,
46046
46185
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
46186
+ replication_source_identifier: typing.Optional[builtins.str] = None,
46047
46187
  s3_export_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
46048
46188
  s3_export_role: typing.Optional[_IRole_235f5d8e] = None,
46049
46189
  s3_import_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
@@ -46099,6 +46239,7 @@ class DatabaseCluster(
46099
46239
  :param preferred_maintenance_window: A preferred maintenance window day/time range. Should be specified as a range ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). Example: 'Sun:23:45-Mon:00:15' Default: - 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.
46100
46240
  :param readers: A list of instances to create as cluster reader instances. Default: - no readers are created. The cluster will have a single writer/reader
46101
46241
  :param removal_policy: The removal policy to apply when the cluster and its instances are removed from the stack or replaced during an update. Default: - RemovalPolicy.SNAPSHOT (remove the cluster and instances, but retain a snapshot of the data)
46242
+ :param replication_source_identifier: The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB cluster is created as a read replica. Cannot be used with credentials. Default: - This DB Cluster is not a read replica
46102
46243
  :param s3_export_buckets: S3 buckets that you want to load data into. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ExportRole`` is used. For MySQL: Default: - None
46103
46244
  :param s3_export_role: Role that will be associated with this DB cluster to enable S3 export. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ExportBuckets`` is used. To use this property with Aurora PostgreSQL, it must be configured with the S3 export feature enabled when creating the DatabaseClusterEngine For MySQL: Default: - New role is created if ``s3ExportBuckets`` is set, no role is defined otherwise
46104
46245
  :param s3_import_buckets: S3 buckets that you want to load data from. This feature is only supported by the Aurora database engine. This property must not be used if ``s3ImportRole`` is used. For MySQL: Default: - None
@@ -46156,6 +46297,7 @@ class DatabaseCluster(
46156
46297
  preferred_maintenance_window=preferred_maintenance_window,
46157
46298
  readers=readers,
46158
46299
  removal_policy=removal_policy,
46300
+ replication_source_identifier=replication_source_identifier,
46159
46301
  s3_export_buckets=s3_export_buckets,
46160
46302
  s3_export_role=s3_export_role,
46161
46303
  s3_import_buckets=s3_import_buckets,
@@ -49904,6 +50046,7 @@ def _typecheckingstub__a32e21c90ab65d3cfdb3b7ef2a0d741ba1528ec8824cd1817d1e485b4
49904
50046
  preferred_maintenance_window: typing.Optional[builtins.str] = None,
49905
50047
  readers: typing.Optional[typing.Sequence[IClusterInstance]] = None,
49906
50048
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
50049
+ replication_source_identifier: typing.Optional[builtins.str] = None,
49907
50050
  s3_export_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
49908
50051
  s3_export_role: typing.Optional[_IRole_235f5d8e] = None,
49909
50052
  s3_import_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
@@ -51624,6 +51767,7 @@ def _typecheckingstub__c6184cbbefaa372690b9776dafecbf5857cf9bfbab91d1666aad22c56
51624
51767
  preferred_maintenance_window: typing.Optional[builtins.str] = None,
51625
51768
  readers: typing.Optional[typing.Sequence[IClusterInstance]] = None,
51626
51769
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
51770
+ replication_source_identifier: typing.Optional[builtins.str] = None,
51627
51771
  s3_export_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
51628
51772
  s3_export_role: typing.Optional[_IRole_235f5d8e] = None,
51629
51773
  s3_import_buckets: typing.Optional[typing.Sequence[_IBucket_42e086fd]] = None,
@@ -5122,7 +5122,7 @@ class CfnIntegration(
5122
5122
  metaclass=jsii.JSIIMeta,
5123
5123
  jsii_type="aws-cdk-lib.aws_redshift.CfnIntegration",
5124
5124
  ):
5125
- '''Describes a zero-ETL integration.
5125
+ '''Describes a zero-ETL or S3 integration.
5126
5126
 
5127
5127
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html
5128
5128
  :cloudformationResource: AWS::Redshift::Integration
@@ -5168,9 +5168,9 @@ class CfnIntegration(
5168
5168
  :param id: Construct identifier for this resource (unique in its scope).
5169
5169
  :param source_arn: The Amazon Resource Name (ARN) of the database used as the source for replication.
5170
5170
  :param target_arn: The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.
5171
- :param additional_encryption_context: The encryption context for the integration. For more information, see `Encryption context <https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#encrypt_context>`_ in the *AWS Key Management Service Developer Guide* .
5171
+ :param additional_encryption_context: The encryption context for the integration. For more information, see `Encryption context <https://docs.aws.amazon.com/>`_ in the *AWS Key Management Service Developer Guide* .
5172
5172
  :param integration_name: The name of the integration.
5173
- :param kms_key_id: The AWS Key Management Service ( AWS KMS ) key identifier for the key used to encrypt the integration.
5173
+ :param kms_key_id: The AWS Key Management Service ( AWS KMS) key identifier for the key used to encrypt the integration.
5174
5174
  :param tags: The list of tags associated with the integration.
5175
5175
  '''
5176
5176
  if __debug__:
@@ -5307,7 +5307,7 @@ class CfnIntegration(
5307
5307
  @builtins.property
5308
5308
  @jsii.member(jsii_name="kmsKeyId")
5309
5309
  def kms_key_id(self) -> typing.Optional[builtins.str]:
5310
- '''The AWS Key Management Service ( AWS KMS ) key identifier for the key used to encrypt the integration.'''
5310
+ '''The AWS Key Management Service ( AWS KMS) key identifier for the key used to encrypt the integration.'''
5311
5311
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "kmsKeyId"))
5312
5312
 
5313
5313
  @kms_key_id.setter
@@ -5358,9 +5358,9 @@ class CfnIntegrationProps:
5358
5358
 
5359
5359
  :param source_arn: The Amazon Resource Name (ARN) of the database used as the source for replication.
5360
5360
  :param target_arn: The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.
5361
- :param additional_encryption_context: The encryption context for the integration. For more information, see `Encryption context <https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#encrypt_context>`_ in the *AWS Key Management Service Developer Guide* .
5361
+ :param additional_encryption_context: The encryption context for the integration. For more information, see `Encryption context <https://docs.aws.amazon.com/>`_ in the *AWS Key Management Service Developer Guide* .
5362
5362
  :param integration_name: The name of the integration.
5363
- :param kms_key_id: The AWS Key Management Service ( AWS KMS ) key identifier for the key used to encrypt the integration.
5363
+ :param kms_key_id: The AWS Key Management Service ( AWS KMS) key identifier for the key used to encrypt the integration.
5364
5364
  :param tags: The list of tags associated with the integration.
5365
5365
 
5366
5366
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html
@@ -5435,7 +5435,7 @@ class CfnIntegrationProps:
5435
5435
  ) -> typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]]:
5436
5436
  '''The encryption context for the integration.
5437
5437
 
5438
- For more information, see `Encryption context <https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#encrypt_context>`_ in the *AWS Key Management Service Developer Guide* .
5438
+ For more information, see `Encryption context <https://docs.aws.amazon.com/>`_ in the *AWS Key Management Service Developer Guide* .
5439
5439
 
5440
5440
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html#cfn-redshift-integration-additionalencryptioncontext
5441
5441
  '''
@@ -5453,7 +5453,7 @@ class CfnIntegrationProps:
5453
5453
 
5454
5454
  @builtins.property
5455
5455
  def kms_key_id(self) -> typing.Optional[builtins.str]:
5456
- '''The AWS Key Management Service ( AWS KMS ) key identifier for the key used to encrypt the integration.
5456
+ '''The AWS Key Management Service ( AWS KMS) key identifier for the key used to encrypt the integration.
5457
5457
 
5458
5458
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html#cfn-redshift-integration-kmskeyid
5459
5459
  '''
@@ -15740,6 +15740,14 @@ class EventType(enum.Enum):
15740
15740
  An event is not generated when a request results in no change to an
15741
15741
  object’s ACL.
15742
15742
  '''
15743
+ OBJECT_RESTORE = "OBJECT_RESTORE"
15744
+ '''Using restore object event types you can receive notifications for initiation and completion when restoring objects from the S3 Glacier storage class.
15745
+
15746
+ You use s3:ObjectRestore:* to request notification of
15747
+ any restoration event.
15748
+ '''
15749
+ REPLICATION = "REPLICATION"
15750
+ '''You receive this notification event for any object replication event.'''
15743
15751
 
15744
15752
 
15745
15753
  @jsii.data_type(