aws-cdk-lib 2.204.0__py3-none-any.whl → 2.206.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 (49) hide show
  1. aws_cdk/__init__.py +170 -92
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.204.0.jsii.tgz → aws-cdk-lib@2.206.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_aiops/__init__.py +89 -39
  5. aws_cdk/aws_applicationautoscaling/__init__.py +2 -2
  6. aws_cdk/aws_arczonalshift/__init__.py +4 -1
  7. aws_cdk/aws_b2bi/__init__.py +32 -16
  8. aws_cdk/aws_bedrock/__init__.py +198 -10
  9. aws_cdk/aws_cassandra/__init__.py +156 -0
  10. aws_cdk/aws_cloudformation/__init__.py +74 -72
  11. aws_cdk/aws_cloudfront/__init__.py +1181 -485
  12. aws_cdk/aws_cloudfront_origins/__init__.py +26 -21
  13. aws_cdk/aws_cloudwatch/__init__.py +61 -0
  14. aws_cdk/aws_codebuild/__init__.py +216 -36
  15. aws_cdk/aws_datasync/__init__.py +2 -2
  16. aws_cdk/aws_docdb/__init__.py +78 -0
  17. aws_cdk/aws_dynamodb/__init__.py +207 -35
  18. aws_cdk/aws_ec2/__init__.py +32 -30
  19. aws_cdk/aws_ecs/__init__.py +718 -213
  20. aws_cdk/aws_emrserverless/__init__.py +5 -5
  21. aws_cdk/aws_events/__init__.py +58 -3
  22. aws_cdk/aws_events_targets/__init__.py +7 -2
  23. aws_cdk/aws_evs/__init__.py +7 -7
  24. aws_cdk/aws_fsx/__init__.py +138 -78
  25. aws_cdk/aws_gamelift/__init__.py +19 -0
  26. aws_cdk/aws_glue/__init__.py +3 -3
  27. aws_cdk/aws_iot/__init__.py +1 -1
  28. aws_cdk/aws_kinesis/__init__.py +67 -13
  29. aws_cdk/aws_kinesisfirehose/__init__.py +28 -1
  30. aws_cdk/aws_lex/__init__.py +36 -19
  31. aws_cdk/aws_neptune/__init__.py +12 -12
  32. aws_cdk/aws_odb/__init__.py +4049 -0
  33. aws_cdk/aws_omics/__init__.py +1 -1
  34. aws_cdk/aws_qbusiness/__init__.py +471 -4
  35. aws_cdk/aws_quicksight/__init__.py +185 -16
  36. aws_cdk/aws_rds/__init__.py +169 -17
  37. aws_cdk/aws_redshiftserverless/__init__.py +72 -45
  38. aws_cdk/aws_route53/__init__.py +41 -19
  39. aws_cdk/aws_s3tables/__init__.py +1005 -0
  40. aws_cdk/aws_sagemaker/__init__.py +20 -0
  41. aws_cdk/aws_synthetics/__init__.py +141 -37
  42. aws_cdk/aws_transfer/__init__.py +23 -1
  43. aws_cdk/custom_resources/__init__.py +32 -4
  44. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/METADATA +1 -1
  45. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/RECORD +49 -48
  46. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/LICENSE +0 -0
  47. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/NOTICE +0 -0
  48. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/WHEEL +0 -0
  49. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/top_level.txt +0 -0
@@ -1844,6 +1844,26 @@ db_from_lookup = rds.DatabaseInstance.from_lookup(self, "dbFromLookup",
1844
1844
  db_from_lookup.grant_connect(my_user_role, "my-user-id")
1845
1845
  ```
1846
1846
 
1847
+ ## Importing existing DatabaseCluster
1848
+
1849
+ ### Lookup DatabaseCluster by clusterIdentifier
1850
+
1851
+ You can lookup an existing DatabaseCluster by its clusterIdentifier using `DatabaseCluster.fromLookup()`. This method returns an `IDatabaseCluster`.
1852
+
1853
+ Here's how `DatabaseCluster.fromLookup()` can be used:
1854
+
1855
+ ```python
1856
+ # my_user_role: iam.Role
1857
+
1858
+
1859
+ cluster_from_lookup = rds.DatabaseCluster.from_lookup(self, "ClusterFromLookup",
1860
+ cluster_identifier="my-cluster-id"
1861
+ )
1862
+
1863
+ # Grant a connection
1864
+ cluster_from_lookup.grant_connect(my_user_role, "my-user-id")
1865
+ ```
1866
+
1847
1867
  ## Limitless Database Cluster
1848
1868
 
1849
1869
  Amazon Aurora [PostgreSQL Limitless Database](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/limitless.html) provides automated horizontal scaling to process millions of write transactions per second and manages petabytes of data while maintaining the simplicity of operating inside a single database.
@@ -4361,6 +4381,12 @@ class AuroraPostgresEngineVersion(
4361
4381
  '''Version "17.4".'''
4362
4382
  return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_17_4"))
4363
4383
 
4384
+ @jsii.python.classproperty
4385
+ @jsii.member(jsii_name="VER_17_5")
4386
+ def VER_17_5(cls) -> "AuroraPostgresEngineVersion":
4387
+ '''Version "17.5".'''
4388
+ return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_17_5"))
4389
+
4364
4390
  @jsii.python.classproperty
4365
4391
  @jsii.member(jsii_name="VER_9_6_11")
4366
4392
  def VER_9_6_11(cls) -> "AuroraPostgresEngineVersion":
@@ -9093,6 +9119,7 @@ class CfnDBInstance(
9093
9119
  auto_minor_version_upgrade=False,
9094
9120
  availability_zone="availabilityZone",
9095
9121
  backup_retention_period=123,
9122
+ backup_target="backupTarget",
9096
9123
  ca_certificate_identifier="caCertificateIdentifier",
9097
9124
  certificate_rotation_restart=False,
9098
9125
  character_set_name="characterSetName",
@@ -9190,6 +9217,7 @@ class CfnDBInstance(
9190
9217
  auto_minor_version_upgrade: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
9191
9218
  availability_zone: typing.Optional[builtins.str] = None,
9192
9219
  backup_retention_period: typing.Optional[jsii.Number] = None,
9220
+ backup_target: typing.Optional[builtins.str] = None,
9193
9221
  ca_certificate_identifier: typing.Optional[builtins.str] = None,
9194
9222
  certificate_rotation_restart: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
9195
9223
  character_set_name: typing.Optional[builtins.str] = None,
@@ -9274,6 +9302,7 @@ class CfnDBInstance(
9274
9302
  :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.
9275
9303
  :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``
9276
9304
  :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:
9277
9306
  :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* .
9278
9307
  :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.
9279
9308
  :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>`_ .
@@ -9315,7 +9344,7 @@ class CfnDBInstance(
9315
9344
  :param max_allocated_storage: The upper limit in gibibytes (GiB) to which Amazon RDS can automatically scale the storage of the DB instance. For more information about this setting, including limitations that apply to it, see `Managing capacity automatically with Amazon RDS storage autoscaling <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to the following DB instances: - Amazon Aurora (Storage is managed by the DB cluster.) - RDS Custom
9316
9345
  :param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collection of Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, then you must set ``MonitoringInterval`` to a value other than ``0`` . This setting doesn't apply to RDS Custom DB instances. Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60`` Default: ``0``
9317
9346
  :param monitoring_role_arn: The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, ``arn:aws:iam:123456789012:role/emaccess`` . For information on creating a monitoring role, see `Setting Up and Enabling Enhanced Monitoring <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling>`_ in the *Amazon RDS User Guide* . If ``MonitoringInterval`` is set to a value other than ``0`` , then you must supply a ``MonitoringRoleArn`` value. This setting doesn't apply to RDS Custom DB instances.
9318
- :param multi_az: Specifies whether the DB instance is a Multi-AZ deployment. You can't set the ``AvailabilityZone`` parameter if the DB instance is a Multi-AZ deployment. This setting doesn't apply to the following DB instances: - Amazon Aurora (DB instance Availability Zones (AZs) are managed by the DB cluster.) - RDS Custom
9347
+ :param multi_az: Specifies whether the DB instance is a Multi-AZ deployment. You can't set the ``AvailabilityZone`` parameter if the DB instance is a Multi-AZ deployment. This setting doesn't apply to Amazon Aurora because the DB instance Availability Zones (AZs) are managed by the DB cluster.
9319
9348
  :param nchar_character_set_name: The name of the NCHAR character set for the Oracle DB instance. This setting doesn't apply to RDS Custom DB instances.
9320
9349
  :param network_type: The network type of the DB instance. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB instance. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon RDS User Guide.*
9321
9350
  :param option_group_name: Indicates that the DB instance should be associated with the specified option group. Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group. Also, that option group can't be removed from a DB instance once it is associated with a DB instance.
@@ -9360,6 +9389,7 @@ class CfnDBInstance(
9360
9389
  auto_minor_version_upgrade=auto_minor_version_upgrade,
9361
9390
  availability_zone=availability_zone,
9362
9391
  backup_retention_period=backup_retention_period,
9392
+ backup_target=backup_target,
9363
9393
  ca_certificate_identifier=ca_certificate_identifier,
9364
9394
  certificate_rotation_restart=certificate_rotation_restart,
9365
9395
  character_set_name=character_set_name,
@@ -9757,6 +9787,18 @@ class CfnDBInstance(
9757
9787
  check_type(argname="argument value", value=value, expected_type=type_hints["value"])
9758
9788
  jsii.set(self, "backupRetentionPeriod", value) # pyright: ignore[reportArgumentType]
9759
9789
 
9790
+ @builtins.property
9791
+ @jsii.member(jsii_name="backupTarget")
9792
+ def backup_target(self) -> typing.Optional[builtins.str]:
9793
+ return typing.cast(typing.Optional[builtins.str], jsii.get(self, "backupTarget"))
9794
+
9795
+ @backup_target.setter
9796
+ def backup_target(self, value: typing.Optional[builtins.str]) -> None:
9797
+ if __debug__:
9798
+ type_hints = typing.get_type_hints(_typecheckingstub__2d01b6bd3366a70d949ce4b76b7922f17c0009fda45951b31e9665ddfed4729e)
9799
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
9800
+ jsii.set(self, "backupTarget", value) # pyright: ignore[reportArgumentType]
9801
+
9760
9802
  @builtins.property
9761
9803
  @jsii.member(jsii_name="caCertificateIdentifier")
9762
9804
  def ca_certificate_identifier(self) -> typing.Optional[builtins.str]:
@@ -11191,6 +11233,7 @@ class CfnDBInstance(
11191
11233
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
11192
11234
  "availability_zone": "availabilityZone",
11193
11235
  "backup_retention_period": "backupRetentionPeriod",
11236
+ "backup_target": "backupTarget",
11194
11237
  "ca_certificate_identifier": "caCertificateIdentifier",
11195
11238
  "certificate_rotation_restart": "certificateRotationRestart",
11196
11239
  "character_set_name": "characterSetName",
@@ -11277,6 +11320,7 @@ class CfnDBInstanceProps:
11277
11320
  auto_minor_version_upgrade: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
11278
11321
  availability_zone: typing.Optional[builtins.str] = None,
11279
11322
  backup_retention_period: typing.Optional[jsii.Number] = None,
11323
+ backup_target: typing.Optional[builtins.str] = None,
11280
11324
  ca_certificate_identifier: typing.Optional[builtins.str] = None,
11281
11325
  certificate_rotation_restart: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
11282
11326
  character_set_name: typing.Optional[builtins.str] = None,
@@ -11360,6 +11404,7 @@ class CfnDBInstanceProps:
11360
11404
  :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.
11361
11405
  :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``
11362
11406
  :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:
11363
11408
  :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* .
11364
11409
  :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.
11365
11410
  :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>`_ .
@@ -11401,7 +11446,7 @@ class CfnDBInstanceProps:
11401
11446
  :param max_allocated_storage: The upper limit in gibibytes (GiB) to which Amazon RDS can automatically scale the storage of the DB instance. For more information about this setting, including limitations that apply to it, see `Managing capacity automatically with Amazon RDS storage autoscaling <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to the following DB instances: - Amazon Aurora (Storage is managed by the DB cluster.) - RDS Custom
11402
11447
  :param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collection of Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, then you must set ``MonitoringInterval`` to a value other than ``0`` . This setting doesn't apply to RDS Custom DB instances. Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60`` Default: ``0``
11403
11448
  :param monitoring_role_arn: The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, ``arn:aws:iam:123456789012:role/emaccess`` . For information on creating a monitoring role, see `Setting Up and Enabling Enhanced Monitoring <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling>`_ in the *Amazon RDS User Guide* . If ``MonitoringInterval`` is set to a value other than ``0`` , then you must supply a ``MonitoringRoleArn`` value. This setting doesn't apply to RDS Custom DB instances.
11404
- :param multi_az: Specifies whether the DB instance is a Multi-AZ deployment. You can't set the ``AvailabilityZone`` parameter if the DB instance is a Multi-AZ deployment. This setting doesn't apply to the following DB instances: - Amazon Aurora (DB instance Availability Zones (AZs) are managed by the DB cluster.) - RDS Custom
11449
+ :param multi_az: Specifies whether the DB instance is a Multi-AZ deployment. You can't set the ``AvailabilityZone`` parameter if the DB instance is a Multi-AZ deployment. This setting doesn't apply to Amazon Aurora because the DB instance Availability Zones (AZs) are managed by the DB cluster.
11405
11450
  :param nchar_character_set_name: The name of the NCHAR character set for the Oracle DB instance. This setting doesn't apply to RDS Custom DB instances.
11406
11451
  :param network_type: The network type of the DB instance. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB instance. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon RDS User Guide.*
11407
11452
  :param option_group_name: Indicates that the DB instance should be associated with the specified option group. Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group. Also, that option group can't be removed from a DB instance once it is associated with a DB instance.
@@ -11454,6 +11499,7 @@ class CfnDBInstanceProps:
11454
11499
  auto_minor_version_upgrade=False,
11455
11500
  availability_zone="availabilityZone",
11456
11501
  backup_retention_period=123,
11502
+ backup_target="backupTarget",
11457
11503
  ca_certificate_identifier="caCertificateIdentifier",
11458
11504
  certificate_rotation_restart=False,
11459
11505
  character_set_name="characterSetName",
@@ -11547,6 +11593,7 @@ class CfnDBInstanceProps:
11547
11593
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
11548
11594
  check_type(argname="argument availability_zone", value=availability_zone, expected_type=type_hints["availability_zone"])
11549
11595
  check_type(argname="argument backup_retention_period", value=backup_retention_period, expected_type=type_hints["backup_retention_period"])
11596
+ check_type(argname="argument backup_target", value=backup_target, expected_type=type_hints["backup_target"])
11550
11597
  check_type(argname="argument ca_certificate_identifier", value=ca_certificate_identifier, expected_type=type_hints["ca_certificate_identifier"])
11551
11598
  check_type(argname="argument certificate_rotation_restart", value=certificate_rotation_restart, expected_type=type_hints["certificate_rotation_restart"])
11552
11599
  check_type(argname="argument character_set_name", value=character_set_name, expected_type=type_hints["character_set_name"])
@@ -11638,6 +11685,8 @@ class CfnDBInstanceProps:
11638
11685
  self._values["availability_zone"] = availability_zone
11639
11686
  if backup_retention_period is not None:
11640
11687
  self._values["backup_retention_period"] = backup_retention_period
11688
+ if backup_target is not None:
11689
+ self._values["backup_target"] = backup_target
11641
11690
  if ca_certificate_identifier is not None:
11642
11691
  self._values["ca_certificate_identifier"] = ca_certificate_identifier
11643
11692
  if certificate_rotation_restart is not None:
@@ -11988,6 +12037,14 @@ class CfnDBInstanceProps:
11988
12037
  result = self._values.get("backup_retention_period")
11989
12038
  return typing.cast(typing.Optional[jsii.Number], result)
11990
12039
 
12040
+ @builtins.property
12041
+ def backup_target(self) -> typing.Optional[builtins.str]:
12042
+ '''
12043
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-backuptarget
12044
+ '''
12045
+ result = self._values.get("backup_target")
12046
+ return typing.cast(typing.Optional[builtins.str], result)
12047
+
11991
12048
  @builtins.property
11992
12049
  def ca_certificate_identifier(self) -> typing.Optional[builtins.str]:
11993
12050
  '''The identifier of the CA certificate for this DB instance.
@@ -12890,10 +12947,7 @@ class CfnDBInstanceProps:
12890
12947
 
12891
12948
  You can't set the ``AvailabilityZone`` parameter if the DB instance is a Multi-AZ deployment.
12892
12949
 
12893
- This setting doesn't apply to the following DB instances:
12894
-
12895
- - Amazon Aurora (DB instance Availability Zones (AZs) are managed by the DB cluster.)
12896
- - RDS Custom
12950
+ This setting doesn't apply to Amazon Aurora because the DB instance Availability Zones (AZs) are managed by the DB cluster.
12897
12951
 
12898
12952
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-multiaz
12899
12953
  '''
@@ -22353,6 +22407,57 @@ class DatabaseClusterFromSnapshotProps:
22353
22407
  )
22354
22408
 
22355
22409
 
22410
+ @jsii.data_type(
22411
+ jsii_type="aws-cdk-lib.aws_rds.DatabaseClusterLookupOptions",
22412
+ jsii_struct_bases=[],
22413
+ name_mapping={"cluster_identifier": "clusterIdentifier"},
22414
+ )
22415
+ class DatabaseClusterLookupOptions:
22416
+ def __init__(self, *, cluster_identifier: builtins.str) -> None:
22417
+ '''Properties for looking up an existing DatabaseCluster.
22418
+
22419
+ :param cluster_identifier: The cluster identifier of the DatabaseCluster.
22420
+
22421
+ :exampleMetadata: infused
22422
+
22423
+ Example::
22424
+
22425
+ # my_user_role: iam.Role
22426
+
22427
+
22428
+ cluster_from_lookup = rds.DatabaseCluster.from_lookup(self, "ClusterFromLookup",
22429
+ cluster_identifier="my-cluster-id"
22430
+ )
22431
+
22432
+ # Grant a connection
22433
+ cluster_from_lookup.grant_connect(my_user_role, "my-user-id")
22434
+ '''
22435
+ if __debug__:
22436
+ type_hints = typing.get_type_hints(_typecheckingstub__87588f52192df76e2f82453b5ba55840986615a954d2a6865cc65bf5b83b9cf0)
22437
+ check_type(argname="argument cluster_identifier", value=cluster_identifier, expected_type=type_hints["cluster_identifier"])
22438
+ self._values: typing.Dict[builtins.str, typing.Any] = {
22439
+ "cluster_identifier": cluster_identifier,
22440
+ }
22441
+
22442
+ @builtins.property
22443
+ def cluster_identifier(self) -> builtins.str:
22444
+ '''The cluster identifier of the DatabaseCluster.'''
22445
+ result = self._values.get("cluster_identifier")
22446
+ assert result is not None, "Required property 'cluster_identifier' is missing"
22447
+ return typing.cast(builtins.str, result)
22448
+
22449
+ def __eq__(self, rhs: typing.Any) -> builtins.bool:
22450
+ return isinstance(rhs, self.__class__) and rhs._values == self._values
22451
+
22452
+ def __ne__(self, rhs: typing.Any) -> builtins.bool:
22453
+ return not (rhs == self)
22454
+
22455
+ def __repr__(self) -> str:
22456
+ return "DatabaseClusterLookupOptions(%s)" % ", ".join(
22457
+ k + "=" + repr(v) for k, v in self._values.items()
22458
+ )
22459
+
22460
+
22356
22461
  @jsii.data_type(
22357
22462
  jsii_type="aws-cdk-lib.aws_rds.DatabaseClusterProps",
22358
22463
  jsii_struct_bases=[],
@@ -47488,20 +47593,19 @@ class DatabaseCluster(
47488
47593
  # vpc: ec2.Vpc
47489
47594
 
47490
47595
  cluster = rds.DatabaseCluster(self, "Database",
47491
- engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_01_0),
47492
- credentials=rds.Credentials.from_generated_secret("clusteradmin"), # Optional - will default to 'admin' username and generated password
47493
- writer=rds.ClusterInstance.provisioned("writer",
47494
- publicly_accessible=False
47495
- ),
47496
- readers=[
47497
- rds.ClusterInstance.provisioned("reader1", promotion_tier=1),
47498
- rds.ClusterInstance.serverless_v2("reader2")
47499
- ],
47500
- vpc_subnets=ec2.SubnetSelection(
47501
- subnet_type=ec2.SubnetType.PRIVATE_WITH_EGRESS
47596
+ engine=rds.DatabaseClusterEngine.aurora_mysql(
47597
+ version=rds.AuroraMysqlEngineVersion.VER_3_03_0
47502
47598
  ),
47599
+ writer=rds.ClusterInstance.provisioned("writer"),
47503
47600
  vpc=vpc
47504
47601
  )
47602
+
47603
+ proxy = rds.DatabaseProxy(self, "Proxy",
47604
+ proxy_target=rds.ProxyTarget.from_cluster(cluster),
47605
+ secrets=[cluster.secret],
47606
+ vpc=vpc,
47607
+ client_password_auth_type=rds.ClientPasswordAuthType.MYSQL_NATIVE_PASSWORD
47608
+ )
47505
47609
  '''
47506
47610
 
47507
47611
  def __init__(
@@ -47740,6 +47844,29 @@ class DatabaseCluster(
47740
47844
 
47741
47845
  return typing.cast(IDatabaseCluster, jsii.sinvoke(cls, "fromDatabaseClusterAttributes", [scope, id, attrs]))
47742
47846
 
47847
+ @jsii.member(jsii_name="fromLookup")
47848
+ @builtins.classmethod
47849
+ def from_lookup(
47850
+ cls,
47851
+ scope: _constructs_77d1e7e8.Construct,
47852
+ id: builtins.str,
47853
+ *,
47854
+ cluster_identifier: builtins.str,
47855
+ ) -> IDatabaseCluster:
47856
+ '''Lookup an existing DatabaseCluster using clusterIdentifier.
47857
+
47858
+ :param scope: -
47859
+ :param id: -
47860
+ :param cluster_identifier: The cluster identifier of the DatabaseCluster.
47861
+ '''
47862
+ if __debug__:
47863
+ type_hints = typing.get_type_hints(_typecheckingstub__6aab9826e2a2cfbf0083d7663ae5f4bed5c3539c635512cbafd5e42752054c11)
47864
+ check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
47865
+ check_type(argname="argument id", value=id, expected_type=type_hints["id"])
47866
+ options = DatabaseClusterLookupOptions(cluster_identifier=cluster_identifier)
47867
+
47868
+ return typing.cast(IDatabaseCluster, jsii.sinvoke(cls, "fromLookup", [scope, id, options]))
47869
+
47743
47870
  @jsii.member(jsii_name="addRotationMultiUser")
47744
47871
  def add_rotation_multi_user(
47745
47872
  self,
@@ -48589,6 +48716,7 @@ __all__ = [
48589
48716
  "DatabaseClusterEngine",
48590
48717
  "DatabaseClusterFromSnapshot",
48591
48718
  "DatabaseClusterFromSnapshotProps",
48719
+ "DatabaseClusterLookupOptions",
48592
48720
  "DatabaseClusterProps",
48593
48721
  "DatabaseInsightsMode",
48594
48722
  "DatabaseInstance",
@@ -49496,6 +49624,7 @@ def _typecheckingstub__255b0779ca741853674876540bf77279f6293bea05de2cd18724d2b92
49496
49624
  auto_minor_version_upgrade: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
49497
49625
  availability_zone: typing.Optional[builtins.str] = None,
49498
49626
  backup_retention_period: typing.Optional[jsii.Number] = None,
49627
+ backup_target: typing.Optional[builtins.str] = None,
49499
49628
  ca_certificate_identifier: typing.Optional[builtins.str] = None,
49500
49629
  certificate_rotation_restart: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
49501
49630
  character_set_name: typing.Optional[builtins.str] = None,
@@ -49642,6 +49771,12 @@ def _typecheckingstub__fd3e9f688b875610637e10e82f5815bcffe370acaf10d2173ec8c9703
49642
49771
  """Type checking stubs"""
49643
49772
  pass
49644
49773
 
49774
+ def _typecheckingstub__2d01b6bd3366a70d949ce4b76b7922f17c0009fda45951b31e9665ddfed4729e(
49775
+ value: typing.Optional[builtins.str],
49776
+ ) -> None:
49777
+ """Type checking stubs"""
49778
+ pass
49779
+
49645
49780
  def _typecheckingstub__62ccd61fdb1bb7842d321fcd1476ed686baf586bf907671076cafd6ba9e2c776(
49646
49781
  value: typing.Optional[builtins.str],
49647
49782
  ) -> None:
@@ -50115,6 +50250,7 @@ def _typecheckingstub__3bddb1be0bd1f1699e3a084c5859d94d8879ff15011f2f2eaac29ec16
50115
50250
  auto_minor_version_upgrade: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
50116
50251
  availability_zone: typing.Optional[builtins.str] = None,
50117
50252
  backup_retention_period: typing.Optional[jsii.Number] = None,
50253
+ backup_target: typing.Optional[builtins.str] = None,
50118
50254
  ca_certificate_identifier: typing.Optional[builtins.str] = None,
50119
50255
  certificate_rotation_restart: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
50120
50256
  character_set_name: typing.Optional[builtins.str] = None,
@@ -51417,6 +51553,13 @@ def _typecheckingstub__1e44b5aef872ca17869a17181382f06cd0166bdbe07e2c33701d3bf1e
51417
51553
  """Type checking stubs"""
51418
51554
  pass
51419
51555
 
51556
+ def _typecheckingstub__87588f52192df76e2f82453b5ba55840986615a954d2a6865cc65bf5b83b9cf0(
51557
+ *,
51558
+ cluster_identifier: builtins.str,
51559
+ ) -> None:
51560
+ """Type checking stubs"""
51561
+ pass
51562
+
51420
51563
  def _typecheckingstub__a32e21c90ab65d3cfdb3b7ef2a0d741ba1528ec8824cd1817d1e485b427eeca4(
51421
51564
  *,
51422
51565
  engine: IClusterEngine,
@@ -53258,6 +53401,15 @@ def _typecheckingstub__d7cb0d9ec8799a7f25049acfbf2838c0699426663debfac03fac47054
53258
53401
  """Type checking stubs"""
53259
53402
  pass
53260
53403
 
53404
+ def _typecheckingstub__6aab9826e2a2cfbf0083d7663ae5f4bed5c3539c635512cbafd5e42752054c11(
53405
+ scope: _constructs_77d1e7e8.Construct,
53406
+ id: builtins.str,
53407
+ *,
53408
+ cluster_identifier: builtins.str,
53409
+ ) -> None:
53410
+ """Type checking stubs"""
53411
+ pass
53412
+
53261
53413
  def _typecheckingstub__ad0046a8afbf99af323d7c44377c74d563a781f7a5854b98860dd1e08070d210(
53262
53414
  id: builtins.str,
53263
53415
  *,