aws-cdk-lib 2.173.4__py3-none-any.whl → 2.174.1__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 (91) hide show
  1. aws_cdk/__init__.py +210 -181
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.173.4.jsii.tgz → aws-cdk-lib@2.174.1.jsii.tgz} +0 -0
  4. aws_cdk/aws_amazonmq/__init__.py +18 -0
  5. aws_cdk/aws_apigateway/__init__.py +127 -168
  6. aws_cdk/aws_appconfig/__init__.py +498 -1
  7. aws_cdk/aws_applicationautoscaling/__init__.py +4 -1
  8. aws_cdk/aws_appsync/__init__.py +4 -0
  9. aws_cdk/aws_autoscaling/__init__.py +96 -0
  10. aws_cdk/aws_batch/__init__.py +662 -237
  11. aws_cdk/aws_bedrock/__init__.py +2122 -181
  12. aws_cdk/aws_cassandra/__init__.py +476 -4
  13. aws_cdk/aws_cleanrooms/__init__.py +1227 -20
  14. aws_cdk/aws_cloudformation/__init__.py +172 -169
  15. aws_cdk/aws_cloudfront/__init__.py +773 -26
  16. aws_cdk/aws_cloudtrail/__init__.py +8 -2
  17. aws_cdk/aws_codebuild/__init__.py +83 -0
  18. aws_cdk/aws_codepipeline/__init__.py +2 -1
  19. aws_cdk/aws_cognito/__init__.py +232 -200
  20. aws_cdk/aws_connect/__init__.py +187 -36
  21. aws_cdk/aws_connectcampaignsv2/__init__.py +106 -12
  22. aws_cdk/aws_databrew/__init__.py +69 -1
  23. aws_cdk/aws_datasync/__init__.py +33 -28
  24. aws_cdk/aws_datazone/__init__.py +141 -41
  25. aws_cdk/aws_dlm/__init__.py +20 -10
  26. aws_cdk/aws_dms/__init__.py +736 -22
  27. aws_cdk/aws_docdb/__init__.py +134 -0
  28. aws_cdk/aws_dynamodb/__init__.py +76 -4
  29. aws_cdk/aws_ec2/__init__.py +1233 -65
  30. aws_cdk/aws_ecr/__init__.py +31 -0
  31. aws_cdk/aws_ecr_assets/__init__.py +5 -0
  32. aws_cdk/aws_ecs/__init__.py +88 -11
  33. aws_cdk/aws_efs/__init__.py +15 -8
  34. aws_cdk/aws_eks/__init__.py +114 -45
  35. aws_cdk/aws_elasticloadbalancingv2/__init__.py +2 -2
  36. aws_cdk/aws_emrserverless/__init__.py +143 -0
  37. aws_cdk/aws_events/__init__.py +50 -30
  38. aws_cdk/aws_fis/__init__.py +33 -33
  39. aws_cdk/aws_fsx/__init__.py +20 -10
  40. aws_cdk/aws_glue/__init__.py +34 -11
  41. aws_cdk/aws_greengrass/__init__.py +8 -8
  42. aws_cdk/aws_guardduty/__init__.py +1 -1
  43. aws_cdk/aws_imagebuilder/__init__.py +45 -47
  44. aws_cdk/aws_internetmonitor/__init__.py +3 -3
  45. aws_cdk/aws_invoicing/__init__.py +55 -30
  46. aws_cdk/aws_iot/__init__.py +1117 -4
  47. aws_cdk/aws_iot1click/__init__.py +17 -7
  48. aws_cdk/aws_kendra/__init__.py +4 -6
  49. aws_cdk/aws_lambda/__init__.py +15 -1
  50. aws_cdk/aws_logs/__init__.py +4011 -86
  51. aws_cdk/aws_m2/__init__.py +41 -0
  52. aws_cdk/aws_mediaconnect/__init__.py +202 -7
  53. aws_cdk/aws_mediaconvert/__init__.py +39 -0
  54. aws_cdk/aws_memorydb/__init__.py +22 -22
  55. aws_cdk/aws_networkmanager/__init__.py +758 -0
  56. aws_cdk/aws_opensearchservice/__init__.py +222 -0
  57. aws_cdk/aws_organizations/__init__.py +5 -3
  58. aws_cdk/aws_pcs/__init__.py +3038 -0
  59. aws_cdk/aws_pipes/__init__.py +10 -10
  60. aws_cdk/aws_qbusiness/__init__.py +415 -140
  61. aws_cdk/aws_quicksight/__init__.py +59795 -49748
  62. aws_cdk/aws_ram/__init__.py +5 -11
  63. aws_cdk/aws_rbin/__init__.py +28 -16
  64. aws_cdk/aws_rds/__init__.py +186 -31
  65. aws_cdk/aws_redshiftserverless/__init__.py +156 -0
  66. aws_cdk/aws_resiliencehub/__init__.py +2 -1
  67. aws_cdk/aws_route53_targets/__init__.py +5 -5
  68. aws_cdk/aws_s3/__init__.py +25 -15
  69. aws_cdk/aws_s3express/__init__.py +7 -7
  70. aws_cdk/aws_s3tables/__init__.py +683 -0
  71. aws_cdk/aws_sagemaker/__init__.py +580 -195
  72. aws_cdk/aws_secretsmanager/__init__.py +2 -0
  73. aws_cdk/aws_securityhub/__init__.py +41 -165
  74. aws_cdk/aws_servicediscovery/__init__.py +10 -3
  75. aws_cdk/aws_ses/__init__.py +190 -5
  76. aws_cdk/aws_sns/__init__.py +7 -3
  77. aws_cdk/aws_synthetics/__init__.py +29 -4
  78. aws_cdk/aws_transfer/__init__.py +8 -0
  79. aws_cdk/aws_vpclattice/__init__.py +147 -77
  80. aws_cdk/aws_wafv2/__init__.py +20 -8
  81. aws_cdk/aws_wisdom/__init__.py +162 -111
  82. aws_cdk/aws_workspaces/__init__.py +10 -4
  83. aws_cdk/cloud_assembly_schema/__init__.py +22 -0
  84. aws_cdk/custom_resources/__init__.py +31 -0
  85. aws_cdk/cx_api/__init__.py +19 -0
  86. {aws_cdk_lib-2.173.4.dist-info → aws_cdk_lib-2.174.1.dist-info}/LICENSE +1 -1
  87. {aws_cdk_lib-2.173.4.dist-info → aws_cdk_lib-2.174.1.dist-info}/METADATA +2 -2
  88. {aws_cdk_lib-2.173.4.dist-info → aws_cdk_lib-2.174.1.dist-info}/NOTICE +1 -1
  89. {aws_cdk_lib-2.173.4.dist-info → aws_cdk_lib-2.174.1.dist-info}/RECORD +91 -89
  90. {aws_cdk_lib-2.173.4.dist-info → aws_cdk_lib-2.174.1.dist-info}/WHEEL +0 -0
  91. {aws_cdk_lib-2.173.4.dist-info → aws_cdk_lib-2.174.1.dist-info}/top_level.txt +0 -0
@@ -4895,6 +4895,7 @@ class CfnDBCluster(
4895
4895
  backup_retention_period=123,
4896
4896
  cluster_scalability_type="clusterScalabilityType",
4897
4897
  copy_tags_to_snapshot=False,
4898
+ database_insights_mode="databaseInsightsMode",
4898
4899
  database_name="databaseName",
4899
4900
  db_cluster_identifier="dbClusterIdentifier",
4900
4901
  db_cluster_instance_class="dbClusterInstanceClass",
@@ -4947,7 +4948,8 @@ class CfnDBCluster(
4947
4948
  ),
4948
4949
  serverless_v2_scaling_configuration=rds.CfnDBCluster.ServerlessV2ScalingConfigurationProperty(
4949
4950
  max_capacity=123,
4950
- min_capacity=123
4951
+ min_capacity=123,
4952
+ seconds_until_auto_pause=123
4951
4953
  ),
4952
4954
  snapshot_identifier="snapshotIdentifier",
4953
4955
  source_db_cluster_identifier="sourceDbClusterIdentifier",
@@ -4976,6 +4978,7 @@ class CfnDBCluster(
4976
4978
  backup_retention_period: typing.Optional[jsii.Number] = None,
4977
4979
  cluster_scalability_type: typing.Optional[builtins.str] = None,
4978
4980
  copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
4981
+ database_insights_mode: typing.Optional[builtins.str] = None,
4979
4982
  database_name: typing.Optional[builtins.str] = None,
4980
4983
  db_cluster_identifier: typing.Optional[builtins.str] = None,
4981
4984
  db_cluster_instance_class: typing.Optional[builtins.str] = None,
@@ -5031,12 +5034,13 @@ class CfnDBCluster(
5031
5034
  :param id: Construct identifier for this resource (unique in its scope).
5032
5035
  :param allocated_storage: The amount of storage in gibibytes (GiB) to allocate to each DB instance in the Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only This setting is required to create a Multi-AZ DB cluster.
5033
5036
  :param associated_roles: Provides a list of the AWS Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other Amazon Web Services on your behalf. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5034
- :param auto_minor_version_upgrade: Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. By default, minor engine upgrades are applied automatically. Valid for Cluster Type: Multi-AZ DB clusters only
5037
+ :param auto_minor_version_upgrade: Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. By default, minor engine upgrades are applied automatically. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
5035
5038
  :param availability_zones: A list of Availability Zones (AZs) where instances in the DB cluster can be created. For information on AWS Regions and Availability Zones, see `Choosing the Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters only
5036
5039
  :param backtrack_window: The target backtrack window, in seconds. To disable backtracking, set this value to ``0`` . Valid for Cluster Type: Aurora MySQL DB clusters only Default: ``0`` Constraints: - If specified, this value must be set to a number from 0 to 259,200 (72 hours).
5037
5040
  :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
5038
5041
  :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.
5039
5042
  :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
5043
+ :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
5040
5044
  :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
5041
5045
  :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
5042
5046
  :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
@@ -5049,7 +5053,7 @@ class CfnDBCluster(
5049
5053
  :param domain_iam_role_name: Specifies the name of the IAM role to use when making API calls to the Directory Service. Valid for: Aurora DB clusters only
5050
5054
  :param enable_cloudwatch_logs_exports: The list of log types that need to be enabled for exporting to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see `Publishing Database Logs to Amazon CloudWatch Logs <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch>`_ in the *Amazon Aurora User Guide* . *Aurora MySQL* Valid values: ``audit`` , ``error`` , ``general`` , ``slowquery`` *Aurora PostgreSQL* Valid values: ``postgresql`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
5051
5055
  :param enable_global_write_forwarding: Specifies whether to enable this DB cluster to forward write operations to the primary cluster of a global cluster (Aurora global database). By default, write operations are not allowed on Aurora DB clusters that are secondary clusters in an Aurora global database. You can set this value only on Aurora DB clusters that are members of an Aurora global database. With this parameter enabled, a secondary cluster can forward writes to the current primary cluster, and the resulting changes are replicated back to this cluster. For the primary DB cluster of an Aurora global database, this value is used immediately if the primary is demoted by a global cluster API operation, but it does nothing until then. Valid for Cluster Type: Aurora DB clusters only
5052
- :param enable_http_endpoint: Specifies whether to enable the HTTP endpoint for the DB cluster. By default, the HTTP endpoint isn't enabled. When enabled, the HTTP endpoint provides a connectionless web service API (RDS Data API) for running SQL queries on the DB cluster. You can also query your database from inside the RDS console with the RDS query editor. RDS Data API is supported with the following DB clusters: - Aurora PostgreSQL Serverless v2 and provisioned - Aurora PostgreSQL and Aurora MySQL Serverless v1 For more information, see `Using RDS Data API <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html>`_ in the *Amazon Aurora User Guide* . Valid for Cluster Type: Aurora DB clusters only
5056
+ :param enable_http_endpoint: Specifies whether to enable the HTTP endpoint for the DB cluster. By default, the HTTP endpoint isn't enabled. When enabled, the HTTP endpoint provides a connectionless web service API (RDS Data API) for running SQL queries on the DB cluster. You can also query your database from inside the RDS console with the RDS query editor. For more information, see `Using RDS Data API <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html>`_ in the *Amazon Aurora User Guide* . Valid for Cluster Type: Aurora DB clusters only
5053
5057
  :param enable_iam_database_authentication: A value that indicates whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. By default, mapping is disabled. For more information, see `IAM Database Authentication <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html>`_ in the *Amazon Aurora User Guide.* Valid for: Aurora DB clusters only
5054
5058
  :param enable_local_write_forwarding: Specifies whether read replicas can forward write operations to the writer DB instance in the DB cluster. By default, write operations aren't allowed on reader DB instances. Valid for: Aurora DB clusters only
5055
5059
  :param engine: The name of the database engine to be used for this DB cluster. Valid Values: - ``aurora-mysql`` - ``aurora-postgresql`` - ``mysql`` - ``postgres`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -5062,13 +5066,13 @@ class CfnDBCluster(
5062
5066
  :param manage_master_user_password: Specifies whether to manage the master user password with AWS Secrets Manager. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.* Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Constraints: - Can't manage the master user password with AWS Secrets Manager if ``MasterUserPassword`` is specified.
5063
5067
  :param master_username: The name of the master user for the DB cluster. .. epigraph:: If you specify the ``SourceDBClusterIdentifier`` , ``SnapshotIdentifier`` , or ``GlobalClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, the snapshot, or the primary DB cluster for the global database cluster, respectively. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5064
5068
  :param master_user_password: The master password for the DB instance. .. epigraph:: If you specify the ``SourceDBClusterIdentifier`` , ``SnapshotIdentifier`` , or ``GlobalClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, the snapshot, or the primary DB cluster for the global database cluster, respectively. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5065
- :param master_user_secret: The secret managed by RDS in AWS Secrets Manager for the master user password. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
5066
- :param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off collecting Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` . Valid for Cluster Type: Multi-AZ DB clusters only Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60`` Default: ``0``
5067
- :param monitoring_role_arn: The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example is ``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`` , supply a ``MonitoringRoleArn`` value. Valid for Cluster Type: Multi-AZ DB clusters only
5069
+ :param master_user_secret: The secret managed by RDS in AWS Secrets Manager for the master user password. .. epigraph:: When you restore a DB cluster from a snapshot, Amazon RDS generates a new secret instead of reusing the secret specified in the ``SecretArn`` property. This ensures that the restored DB cluster is securely managed with a dedicated secret. To maintain consistent integration with your application, you might need to update resource configurations to reference the newly created secret. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
5070
+ :param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off collecting Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60`` Default: ``0``
5071
+ :param monitoring_role_arn: The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example is ``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`` , supply a ``MonitoringRoleArn`` value. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
5068
5072
  :param network_type: The network type of the DB cluster. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB cluster. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon Aurora User Guide.* Valid for: Aurora DB clusters only
5069
- :param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Multi-AZ DB clusters only
5070
- :param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Multi-AZ DB clusters only
5071
- :param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Multi-AZ DB clusters only Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
5073
+ :param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
5074
+ :param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
5075
+ :param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
5072
5076
  :param port: The port number on which the DB instances in the DB cluster accept connections. Default: - When ``EngineMode`` is ``provisioned`` , ``3306`` (for both Aurora MySQL and Aurora PostgreSQL) - When ``EngineMode`` is ``serverless`` : - ``3306`` when ``Engine`` is ``aurora`` or ``aurora-mysql`` - ``5432`` when ``Engine`` is ``aurora-postgresql`` .. epigraph:: The ``No interruption`` on update behavior only applies to DB clusters. If you are updating a DB instance, see `Port <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-port>`_ for the AWS::RDS::DBInstance resource. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5073
5077
  :param preferred_backup_window: The daily time range during which automated backups are created. For more information, see `Backup Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow>`_ in the *Amazon Aurora User Guide.* Constraints: - Must be in the format ``hh24:mi-hh24:mi`` . - Must be in Universal Coordinated Time (UTC). - Must not conflict with the preferred maintenance window. - Must be at least 30 minutes. Valid for: Aurora DB clusters and Multi-AZ DB clusters
5074
5078
  :param preferred_maintenance_window: The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC). Format: ``ddd:hh24:mi-ddd:hh24:mi`` The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week. To see the time blocks available, see `Adjusting the Preferred DB Cluster Maintenance Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora>`_ in the *Amazon Aurora User Guide.* Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun. Constraints: Minimum 30-minute window. Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -5100,6 +5104,7 @@ class CfnDBCluster(
5100
5104
  backup_retention_period=backup_retention_period,
5101
5105
  cluster_scalability_type=cluster_scalability_type,
5102
5106
  copy_tags_to_snapshot=copy_tags_to_snapshot,
5107
+ database_insights_mode=database_insights_mode,
5103
5108
  database_name=database_name,
5104
5109
  db_cluster_identifier=db_cluster_identifier,
5105
5110
  db_cluster_instance_class=db_cluster_instance_class,
@@ -5416,6 +5421,19 @@ class CfnDBCluster(
5416
5421
  check_type(argname="argument value", value=value, expected_type=type_hints["value"])
5417
5422
  jsii.set(self, "copyTagsToSnapshot", value) # pyright: ignore[reportArgumentType]
5418
5423
 
5424
+ @builtins.property
5425
+ @jsii.member(jsii_name="databaseInsightsMode")
5426
+ def database_insights_mode(self) -> typing.Optional[builtins.str]:
5427
+ '''The mode of Database Insights to enable for the DB cluster.'''
5428
+ return typing.cast(typing.Optional[builtins.str], jsii.get(self, "databaseInsightsMode"))
5429
+
5430
+ @database_insights_mode.setter
5431
+ def database_insights_mode(self, value: typing.Optional[builtins.str]) -> None:
5432
+ if __debug__:
5433
+ type_hints = typing.get_type_hints(_typecheckingstub__95529055a06b2a5642399d211890b3949094262771feb4c9ba4efe7d394d8efa)
5434
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
5435
+ jsii.set(self, "databaseInsightsMode", value) # pyright: ignore[reportArgumentType]
5436
+
5419
5437
  @builtins.property
5420
5438
  @jsii.member(jsii_name="databaseName")
5421
5439
  def database_name(self) -> typing.Optional[builtins.str]:
@@ -6615,7 +6633,11 @@ class CfnDBCluster(
6615
6633
  @jsii.data_type(
6616
6634
  jsii_type="aws-cdk-lib.aws_rds.CfnDBCluster.ServerlessV2ScalingConfigurationProperty",
6617
6635
  jsii_struct_bases=[],
6618
- name_mapping={"max_capacity": "maxCapacity", "min_capacity": "minCapacity"},
6636
+ name_mapping={
6637
+ "max_capacity": "maxCapacity",
6638
+ "min_capacity": "minCapacity",
6639
+ "seconds_until_auto_pause": "secondsUntilAutoPause",
6640
+ },
6619
6641
  )
6620
6642
  class ServerlessV2ScalingConfigurationProperty:
6621
6643
  def __init__(
@@ -6623,6 +6645,7 @@ class CfnDBCluster(
6623
6645
  *,
6624
6646
  max_capacity: typing.Optional[jsii.Number] = None,
6625
6647
  min_capacity: typing.Optional[jsii.Number] = None,
6648
+ seconds_until_auto_pause: typing.Optional[jsii.Number] = None,
6626
6649
  ) -> None:
6627
6650
  '''The ``ServerlessV2ScalingConfiguration`` property type specifies the scaling configuration of an Aurora Serverless V2 DB cluster.
6628
6651
 
@@ -6636,6 +6659,7 @@ class CfnDBCluster(
6636
6659
 
6637
6660
  :param max_capacity: The maximum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 40, 40.5, 41, and so on. The largest value that you can use is 128. The maximum capacity must be higher than 0.5 ACUs. For more information, see `Choosing the maximum Aurora Serverless v2 capacity setting for a cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.setting-capacity.html#aurora-serverless-v2.max_capacity_considerations>`_ in the *Amazon Aurora User Guide* . Aurora automatically sets certain parameters for Aurora Serverless V2 DB instances to values that depend on the maximum ACU value in the capacity range. When you update the maximum capacity value, the ``ParameterApplyStatus`` value for the DB instance changes to ``pending-reboot`` . You can update the parameter values by rebooting the DB instance after changing the capacity range.
6638
6661
  :param min_capacity: The minimum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 8, 8.5, 9, and so on. For Aurora versions that support the Aurora Serverless v2 auto-pause feature, the smallest value that you can use is 0. For versions that don't support Aurora Serverless v2 auto-pause, the smallest value that you can use is 0.5.
6662
+ :param seconds_until_auto_pause: Specifies the number of seconds an Aurora Serverless v2 DB instance must be idle before Aurora attempts to automatically pause it. Specify a value between 300 seconds (five minutes) and 86,400 seconds (one day). The default is 300 seconds.
6639
6663
 
6640
6664
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-dbcluster-serverlessv2scalingconfiguration.html
6641
6665
  :exampleMetadata: fixture=_generated
@@ -6648,18 +6672,22 @@ class CfnDBCluster(
6648
6672
 
6649
6673
  serverless_v2_scaling_configuration_property = rds.CfnDBCluster.ServerlessV2ScalingConfigurationProperty(
6650
6674
  max_capacity=123,
6651
- min_capacity=123
6675
+ min_capacity=123,
6676
+ seconds_until_auto_pause=123
6652
6677
  )
6653
6678
  '''
6654
6679
  if __debug__:
6655
6680
  type_hints = typing.get_type_hints(_typecheckingstub__5a6717af18f7b2b042b74ca423a540eb39f5ae817292b338733c6a3cee2b4284)
6656
6681
  check_type(argname="argument max_capacity", value=max_capacity, expected_type=type_hints["max_capacity"])
6657
6682
  check_type(argname="argument min_capacity", value=min_capacity, expected_type=type_hints["min_capacity"])
6683
+ check_type(argname="argument seconds_until_auto_pause", value=seconds_until_auto_pause, expected_type=type_hints["seconds_until_auto_pause"])
6658
6684
  self._values: typing.Dict[builtins.str, typing.Any] = {}
6659
6685
  if max_capacity is not None:
6660
6686
  self._values["max_capacity"] = max_capacity
6661
6687
  if min_capacity is not None:
6662
6688
  self._values["min_capacity"] = min_capacity
6689
+ if seconds_until_auto_pause is not None:
6690
+ self._values["seconds_until_auto_pause"] = seconds_until_auto_pause
6663
6691
 
6664
6692
  @builtins.property
6665
6693
  def max_capacity(self) -> typing.Optional[jsii.Number]:
@@ -6687,6 +6715,17 @@ class CfnDBCluster(
6687
6715
  result = self._values.get("min_capacity")
6688
6716
  return typing.cast(typing.Optional[jsii.Number], result)
6689
6717
 
6718
+ @builtins.property
6719
+ def seconds_until_auto_pause(self) -> typing.Optional[jsii.Number]:
6720
+ '''Specifies the number of seconds an Aurora Serverless v2 DB instance must be idle before Aurora attempts to automatically pause it.
6721
+
6722
+ Specify a value between 300 seconds (five minutes) and 86,400 seconds (one day). The default is 300 seconds.
6723
+
6724
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-dbcluster-serverlessv2scalingconfiguration.html#cfn-rds-dbcluster-serverlessv2scalingconfiguration-secondsuntilautopause
6725
+ '''
6726
+ result = self._values.get("seconds_until_auto_pause")
6727
+ return typing.cast(typing.Optional[jsii.Number], result)
6728
+
6690
6729
  def __eq__(self, rhs: typing.Any) -> builtins.bool:
6691
6730
  return isinstance(rhs, self.__class__) and rhs._values == self._values
6692
6731
 
@@ -7070,6 +7109,7 @@ class CfnDBClusterParameterGroupProps:
7070
7109
  "backup_retention_period": "backupRetentionPeriod",
7071
7110
  "cluster_scalability_type": "clusterScalabilityType",
7072
7111
  "copy_tags_to_snapshot": "copyTagsToSnapshot",
7112
+ "database_insights_mode": "databaseInsightsMode",
7073
7113
  "database_name": "databaseName",
7074
7114
  "db_cluster_identifier": "dbClusterIdentifier",
7075
7115
  "db_cluster_instance_class": "dbClusterInstanceClass",
@@ -7133,6 +7173,7 @@ class CfnDBClusterProps:
7133
7173
  backup_retention_period: typing.Optional[jsii.Number] = None,
7134
7174
  cluster_scalability_type: typing.Optional[builtins.str] = None,
7135
7175
  copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
7176
+ database_insights_mode: typing.Optional[builtins.str] = None,
7136
7177
  database_name: typing.Optional[builtins.str] = None,
7137
7178
  db_cluster_identifier: typing.Optional[builtins.str] = None,
7138
7179
  db_cluster_instance_class: typing.Optional[builtins.str] = None,
@@ -7187,12 +7228,13 @@ class CfnDBClusterProps:
7187
7228
 
7188
7229
  :param allocated_storage: The amount of storage in gibibytes (GiB) to allocate to each DB instance in the Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only This setting is required to create a Multi-AZ DB cluster.
7189
7230
  :param associated_roles: Provides a list of the AWS Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other Amazon Web Services on your behalf. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7190
- :param auto_minor_version_upgrade: Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. By default, minor engine upgrades are applied automatically. Valid for Cluster Type: Multi-AZ DB clusters only
7231
+ :param auto_minor_version_upgrade: Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. By default, minor engine upgrades are applied automatically. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
7191
7232
  :param availability_zones: A list of Availability Zones (AZs) where instances in the DB cluster can be created. For information on AWS Regions and Availability Zones, see `Choosing the Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters only
7192
7233
  :param backtrack_window: The target backtrack window, in seconds. To disable backtracking, set this value to ``0`` . Valid for Cluster Type: Aurora MySQL DB clusters only Default: ``0`` Constraints: - If specified, this value must be set to a number from 0 to 259,200 (72 hours).
7193
7234
  :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
7194
7235
  :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.
7195
7236
  :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
7237
+ :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
7196
7238
  :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
7197
7239
  :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
7198
7240
  :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
@@ -7205,7 +7247,7 @@ class CfnDBClusterProps:
7205
7247
  :param domain_iam_role_name: Specifies the name of the IAM role to use when making API calls to the Directory Service. Valid for: Aurora DB clusters only
7206
7248
  :param enable_cloudwatch_logs_exports: The list of log types that need to be enabled for exporting to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see `Publishing Database Logs to Amazon CloudWatch Logs <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch>`_ in the *Amazon Aurora User Guide* . *Aurora MySQL* Valid values: ``audit`` , ``error`` , ``general`` , ``slowquery`` *Aurora PostgreSQL* Valid values: ``postgresql`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
7207
7249
  :param enable_global_write_forwarding: Specifies whether to enable this DB cluster to forward write operations to the primary cluster of a global cluster (Aurora global database). By default, write operations are not allowed on Aurora DB clusters that are secondary clusters in an Aurora global database. You can set this value only on Aurora DB clusters that are members of an Aurora global database. With this parameter enabled, a secondary cluster can forward writes to the current primary cluster, and the resulting changes are replicated back to this cluster. For the primary DB cluster of an Aurora global database, this value is used immediately if the primary is demoted by a global cluster API operation, but it does nothing until then. Valid for Cluster Type: Aurora DB clusters only
7208
- :param enable_http_endpoint: Specifies whether to enable the HTTP endpoint for the DB cluster. By default, the HTTP endpoint isn't enabled. When enabled, the HTTP endpoint provides a connectionless web service API (RDS Data API) for running SQL queries on the DB cluster. You can also query your database from inside the RDS console with the RDS query editor. RDS Data API is supported with the following DB clusters: - Aurora PostgreSQL Serverless v2 and provisioned - Aurora PostgreSQL and Aurora MySQL Serverless v1 For more information, see `Using RDS Data API <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html>`_ in the *Amazon Aurora User Guide* . Valid for Cluster Type: Aurora DB clusters only
7250
+ :param enable_http_endpoint: Specifies whether to enable the HTTP endpoint for the DB cluster. By default, the HTTP endpoint isn't enabled. When enabled, the HTTP endpoint provides a connectionless web service API (RDS Data API) for running SQL queries on the DB cluster. You can also query your database from inside the RDS console with the RDS query editor. For more information, see `Using RDS Data API <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html>`_ in the *Amazon Aurora User Guide* . Valid for Cluster Type: Aurora DB clusters only
7209
7251
  :param enable_iam_database_authentication: A value that indicates whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. By default, mapping is disabled. For more information, see `IAM Database Authentication <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html>`_ in the *Amazon Aurora User Guide.* Valid for: Aurora DB clusters only
7210
7252
  :param enable_local_write_forwarding: Specifies whether read replicas can forward write operations to the writer DB instance in the DB cluster. By default, write operations aren't allowed on reader DB instances. Valid for: Aurora DB clusters only
7211
7253
  :param engine: The name of the database engine to be used for this DB cluster. Valid Values: - ``aurora-mysql`` - ``aurora-postgresql`` - ``mysql`` - ``postgres`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -7218,13 +7260,13 @@ class CfnDBClusterProps:
7218
7260
  :param manage_master_user_password: Specifies whether to manage the master user password with AWS Secrets Manager. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.* Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Constraints: - Can't manage the master user password with AWS Secrets Manager if ``MasterUserPassword`` is specified.
7219
7261
  :param master_username: The name of the master user for the DB cluster. .. epigraph:: If you specify the ``SourceDBClusterIdentifier`` , ``SnapshotIdentifier`` , or ``GlobalClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, the snapshot, or the primary DB cluster for the global database cluster, respectively. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7220
7262
  :param master_user_password: The master password for the DB instance. .. epigraph:: If you specify the ``SourceDBClusterIdentifier`` , ``SnapshotIdentifier`` , or ``GlobalClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, the snapshot, or the primary DB cluster for the global database cluster, respectively. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7221
- :param master_user_secret: The secret managed by RDS in AWS Secrets Manager for the master user password. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
7222
- :param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off collecting Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` . Valid for Cluster Type: Multi-AZ DB clusters only Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60`` Default: ``0``
7223
- :param monitoring_role_arn: The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example is ``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`` , supply a ``MonitoringRoleArn`` value. Valid for Cluster Type: Multi-AZ DB clusters only
7263
+ :param master_user_secret: The secret managed by RDS in AWS Secrets Manager for the master user password. .. epigraph:: When you restore a DB cluster from a snapshot, Amazon RDS generates a new secret instead of reusing the secret specified in the ``SecretArn`` property. This ensures that the restored DB cluster is securely managed with a dedicated secret. To maintain consistent integration with your application, you might need to update resource configurations to reference the newly created secret. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
7264
+ :param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off collecting Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60`` Default: ``0``
7265
+ :param monitoring_role_arn: The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example is ``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`` , supply a ``MonitoringRoleArn`` value. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
7224
7266
  :param network_type: The network type of the DB cluster. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB cluster. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon Aurora User Guide.* Valid for: Aurora DB clusters only
7225
- :param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Multi-AZ DB clusters only
7226
- :param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Multi-AZ DB clusters only
7227
- :param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Multi-AZ DB clusters only Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
7267
+ :param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
7268
+ :param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
7269
+ :param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
7228
7270
  :param port: The port number on which the DB instances in the DB cluster accept connections. Default: - When ``EngineMode`` is ``provisioned`` , ``3306`` (for both Aurora MySQL and Aurora PostgreSQL) - When ``EngineMode`` is ``serverless`` : - ``3306`` when ``Engine`` is ``aurora`` or ``aurora-mysql`` - ``5432`` when ``Engine`` is ``aurora-postgresql`` .. epigraph:: The ``No interruption`` on update behavior only applies to DB clusters. If you are updating a DB instance, see `Port <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-port>`_ for the AWS::RDS::DBInstance resource. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7229
7271
  :param preferred_backup_window: The daily time range during which automated backups are created. For more information, see `Backup Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow>`_ in the *Amazon Aurora User Guide.* Constraints: - Must be in the format ``hh24:mi-hh24:mi`` . - Must be in Universal Coordinated Time (UTC). - Must not conflict with the preferred maintenance window. - Must be at least 30 minutes. Valid for: Aurora DB clusters and Multi-AZ DB clusters
7230
7272
  :param preferred_maintenance_window: The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC). Format: ``ddd:hh24:mi-ddd:hh24:mi`` The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week. To see the time blocks available, see `Adjusting the Preferred DB Cluster Maintenance Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora>`_ in the *Amazon Aurora User Guide.* Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun. Constraints: Minimum 30-minute window. Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -7266,6 +7308,7 @@ class CfnDBClusterProps:
7266
7308
  backup_retention_period=123,
7267
7309
  cluster_scalability_type="clusterScalabilityType",
7268
7310
  copy_tags_to_snapshot=False,
7311
+ database_insights_mode="databaseInsightsMode",
7269
7312
  database_name="databaseName",
7270
7313
  db_cluster_identifier="dbClusterIdentifier",
7271
7314
  db_cluster_instance_class="dbClusterInstanceClass",
@@ -7318,7 +7361,8 @@ class CfnDBClusterProps:
7318
7361
  ),
7319
7362
  serverless_v2_scaling_configuration=rds.CfnDBCluster.ServerlessV2ScalingConfigurationProperty(
7320
7363
  max_capacity=123,
7321
- min_capacity=123
7364
+ min_capacity=123,
7365
+ seconds_until_auto_pause=123
7322
7366
  ),
7323
7367
  snapshot_identifier="snapshotIdentifier",
7324
7368
  source_db_cluster_identifier="sourceDbClusterIdentifier",
@@ -7343,6 +7387,7 @@ class CfnDBClusterProps:
7343
7387
  check_type(argname="argument backup_retention_period", value=backup_retention_period, expected_type=type_hints["backup_retention_period"])
7344
7388
  check_type(argname="argument cluster_scalability_type", value=cluster_scalability_type, expected_type=type_hints["cluster_scalability_type"])
7345
7389
  check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
7390
+ check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
7346
7391
  check_type(argname="argument database_name", value=database_name, expected_type=type_hints["database_name"])
7347
7392
  check_type(argname="argument db_cluster_identifier", value=db_cluster_identifier, expected_type=type_hints["db_cluster_identifier"])
7348
7393
  check_type(argname="argument db_cluster_instance_class", value=db_cluster_instance_class, expected_type=type_hints["db_cluster_instance_class"])
@@ -7409,6 +7454,8 @@ class CfnDBClusterProps:
7409
7454
  self._values["cluster_scalability_type"] = cluster_scalability_type
7410
7455
  if copy_tags_to_snapshot is not None:
7411
7456
  self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
7457
+ if database_insights_mode is not None:
7458
+ self._values["database_insights_mode"] = database_insights_mode
7412
7459
  if database_name is not None:
7413
7460
  self._values["database_name"] = database_name
7414
7461
  if db_cluster_identifier is not None:
@@ -7544,7 +7591,7 @@ class CfnDBClusterProps:
7544
7591
 
7545
7592
  By default, minor engine upgrades are applied automatically.
7546
7593
 
7547
- Valid for Cluster Type: Multi-AZ DB clusters only
7594
+ Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
7548
7595
 
7549
7596
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-autominorversionupgrade
7550
7597
  '''
@@ -7626,6 +7673,19 @@ class CfnDBClusterProps:
7626
7673
  result = self._values.get("copy_tags_to_snapshot")
7627
7674
  return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
7628
7675
 
7676
+ @builtins.property
7677
+ def database_insights_mode(self) -> typing.Optional[builtins.str]:
7678
+ '''The mode of Database Insights to enable for the DB cluster.
7679
+
7680
+ If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465.
7681
+
7682
+ Valid for Cluster Type: Aurora DB clusters only
7683
+
7684
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-databaseinsightsmode
7685
+ '''
7686
+ result = self._values.get("database_insights_mode")
7687
+ return typing.cast(typing.Optional[builtins.str], result)
7688
+
7629
7689
  @builtins.property
7630
7690
  def database_name(self) -> typing.Optional[builtins.str]:
7631
7691
  '''The name of your database.
@@ -7827,11 +7887,6 @@ class CfnDBClusterProps:
7827
7887
 
7828
7888
  When enabled, the HTTP endpoint provides a connectionless web service API (RDS Data API) for running SQL queries on the DB cluster. You can also query your database from inside the RDS console with the RDS query editor.
7829
7889
 
7830
- RDS Data API is supported with the following DB clusters:
7831
-
7832
- - Aurora PostgreSQL Serverless v2 and provisioned
7833
- - Aurora PostgreSQL and Aurora MySQL Serverless v1
7834
-
7835
7890
  For more information, see `Using RDS Data API <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html>`_ in the *Amazon Aurora User Guide* .
7836
7891
 
7837
7892
  Valid for Cluster Type: Aurora DB clusters only
@@ -8089,6 +8144,10 @@ class CfnDBClusterProps:
8089
8144
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDBCluster.MasterUserSecretProperty]]:
8090
8145
  '''The secret managed by RDS in AWS Secrets Manager for the master user password.
8091
8146
 
8147
+ .. epigraph::
8148
+
8149
+ When you restore a DB cluster from a snapshot, Amazon RDS generates a new secret instead of reusing the secret specified in the ``SecretArn`` property. This ensures that the restored DB cluster is securely managed with a dedicated secret. To maintain consistent integration with your application, you might need to update resource configurations to reference the newly created secret.
8150
+
8092
8151
  For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
8093
8152
 
8094
8153
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-masterusersecret
@@ -8104,7 +8163,7 @@ class CfnDBClusterProps:
8104
8163
 
8105
8164
  If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` .
8106
8165
 
8107
- Valid for Cluster Type: Multi-AZ DB clusters only
8166
+ Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
8108
8167
 
8109
8168
  Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60``
8110
8169
 
@@ -8123,7 +8182,7 @@ class CfnDBClusterProps:
8123
8182
 
8124
8183
  If ``MonitoringInterval`` is set to a value other than ``0`` , supply a ``MonitoringRoleArn`` value.
8125
8184
 
8126
- Valid for Cluster Type: Multi-AZ DB clusters only
8185
+ Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
8127
8186
 
8128
8187
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-monitoringrolearn
8129
8188
  '''
@@ -8158,7 +8217,7 @@ class CfnDBClusterProps:
8158
8217
 
8159
8218
  For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* .
8160
8219
 
8161
- Valid for Cluster Type: Multi-AZ DB clusters only
8220
+ Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
8162
8221
 
8163
8222
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-performanceinsightsenabled
8164
8223
  '''
@@ -8173,7 +8232,7 @@ class CfnDBClusterProps:
8173
8232
 
8174
8233
  If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region .
8175
8234
 
8176
- Valid for Cluster Type: Multi-AZ DB clusters only
8235
+ Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
8177
8236
 
8178
8237
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-performanceinsightskmskeyid
8179
8238
  '''
@@ -8184,7 +8243,7 @@ class CfnDBClusterProps:
8184
8243
  def performance_insights_retention_period(self) -> typing.Optional[jsii.Number]:
8185
8244
  '''The number of days to retain Performance Insights data.
8186
8245
 
8187
- Valid for Cluster Type: Multi-AZ DB clusters only
8246
+ Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
8188
8247
 
8189
8248
  Valid Values:
8190
8249
 
@@ -8620,6 +8679,7 @@ class CfnDBInstance(
8620
8679
  db_security_groups=["dbSecurityGroups"],
8621
8680
  db_snapshot_identifier="dbSnapshotIdentifier",
8622
8681
  db_subnet_group_name="dbSubnetGroupName",
8682
+ db_system_id="dbSystemId",
8623
8683
  dedicated_log_volume=False,
8624
8684
  delete_automated_backups=False,
8625
8685
  deletion_protection=False,
@@ -8719,6 +8779,7 @@ class CfnDBInstance(
8719
8779
  db_security_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
8720
8780
  db_snapshot_identifier: typing.Optional[builtins.str] = None,
8721
8781
  db_subnet_group_name: typing.Optional[builtins.str] = None,
8782
+ db_system_id: typing.Optional[builtins.str] = None,
8722
8783
  dedicated_log_volume: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
8723
8784
  delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
8724
8785
  deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
@@ -8801,6 +8862,7 @@ class CfnDBInstance(
8801
8862
  :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.
8802
8863
  :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. For information about the properties that you can specify, see the ``RestoreDBInstanceFromDBSnapshot`` 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.
8803
8864
  :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.
8865
+ :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.
8804
8866
  :param dedicated_log_volume: Indicates whether the DB instance has a dedicated log volume (DLV) enabled.
8805
8867
  :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.
8806
8868
  :param deletion_protection: Specifies whether the DB instance has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection isn't enabled. For more information, see `Deleting a DB Instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html>`_ . This setting doesn't apply to Amazon Aurora DB instances. You can enable or disable deletion protection for the DB cluster. For more information, see ``CreateDBCluster`` . DB instances in a DB cluster can be deleted even when deletion protection is enabled for the DB cluster.
@@ -8885,6 +8947,7 @@ class CfnDBInstance(
8885
8947
  db_security_groups=db_security_groups,
8886
8948
  db_snapshot_identifier=db_snapshot_identifier,
8887
8949
  db_subnet_group_name=db_subnet_group_name,
8950
+ db_system_id=db_system_id,
8888
8951
  dedicated_log_volume=dedicated_log_volume,
8889
8952
  delete_automated_backups=delete_automated_backups,
8890
8953
  deletion_protection=deletion_protection,
@@ -8992,6 +9055,20 @@ class CfnDBInstance(
8992
9055
  '''
8993
9056
  return typing.cast(builtins.str, jsii.get(self, "attrCertificateDetailsValidTill"))
8994
9057
 
9058
+ @builtins.property
9059
+ @jsii.member(jsii_name="attrDatabaseInsightsMode")
9060
+ def attr_database_insights_mode(self) -> builtins.str:
9061
+ '''The mode of Database Insights to enable for the DB instance.
9062
+
9063
+ This setting only applies to Amazon Aurora DB instances.
9064
+ .. epigraph::
9065
+
9066
+ Currently, this value is inherited from the DB cluster and can't be changed.
9067
+
9068
+ :cloudformationAttribute: DatabaseInsightsMode
9069
+ '''
9070
+ return typing.cast(builtins.str, jsii.get(self, "attrDatabaseInsightsMode"))
9071
+
8995
9072
  @builtins.property
8996
9073
  @jsii.member(jsii_name="attrDbInstanceArn")
8997
9074
  def attr_db_instance_arn(self) -> builtins.str:
@@ -9419,6 +9496,19 @@ class CfnDBInstance(
9419
9496
  check_type(argname="argument value", value=value, expected_type=type_hints["value"])
9420
9497
  jsii.set(self, "dbSubnetGroupName", value) # pyright: ignore[reportArgumentType]
9421
9498
 
9499
+ @builtins.property
9500
+ @jsii.member(jsii_name="dbSystemId")
9501
+ def db_system_id(self) -> typing.Optional[builtins.str]:
9502
+ '''The Oracle system identifier (SID), which is the name of the Oracle database instance that manages your database files.'''
9503
+ return typing.cast(typing.Optional[builtins.str], jsii.get(self, "dbSystemId"))
9504
+
9505
+ @db_system_id.setter
9506
+ def db_system_id(self, value: typing.Optional[builtins.str]) -> None:
9507
+ if __debug__:
9508
+ type_hints = typing.get_type_hints(_typecheckingstub__c2bcedc9b98a22e01ebba3d247528b50c6ecfcdf1d1d6193070deed3f0a91242)
9509
+ check_type(argname="argument value", value=value, expected_type=type_hints["value"])
9510
+ jsii.set(self, "dbSystemId", value) # pyright: ignore[reportArgumentType]
9511
+
9422
9512
  @builtins.property
9423
9513
  @jsii.member(jsii_name="dedicatedLogVolume")
9424
9514
  def dedicated_log_volume(
@@ -10663,6 +10753,7 @@ class CfnDBInstance(
10663
10753
  "db_security_groups": "dbSecurityGroups",
10664
10754
  "db_snapshot_identifier": "dbSnapshotIdentifier",
10665
10755
  "db_subnet_group_name": "dbSubnetGroupName",
10756
+ "db_system_id": "dbSystemId",
10666
10757
  "dedicated_log_volume": "dedicatedLogVolume",
10667
10758
  "delete_automated_backups": "deleteAutomatedBackups",
10668
10759
  "deletion_protection": "deletionProtection",
@@ -10747,6 +10838,7 @@ class CfnDBInstanceProps:
10747
10838
  db_security_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
10748
10839
  db_snapshot_identifier: typing.Optional[builtins.str] = None,
10749
10840
  db_subnet_group_name: typing.Optional[builtins.str] = None,
10841
+ db_system_id: typing.Optional[builtins.str] = None,
10750
10842
  dedicated_log_volume: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
10751
10843
  delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
10752
10844
  deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
@@ -10828,6 +10920,7 @@ class CfnDBInstanceProps:
10828
10920
  :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.
10829
10921
  :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. For information about the properties that you can specify, see the ``RestoreDBInstanceFromDBSnapshot`` 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.
10830
10922
  :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.
10923
+ :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.
10831
10924
  :param dedicated_log_volume: Indicates whether the DB instance has a dedicated log volume (DLV) enabled.
10832
10925
  :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.
10833
10926
  :param deletion_protection: Specifies whether the DB instance has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection isn't enabled. For more information, see `Deleting a DB Instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html>`_ . This setting doesn't apply to Amazon Aurora DB instances. You can enable or disable deletion protection for the DB cluster. For more information, see ``CreateDBCluster`` . DB instances in a DB cluster can be deleted even when deletion protection is enabled for the DB cluster.
@@ -10923,6 +11016,7 @@ class CfnDBInstanceProps:
10923
11016
  db_security_groups=["dbSecurityGroups"],
10924
11017
  db_snapshot_identifier="dbSnapshotIdentifier",
10925
11018
  db_subnet_group_name="dbSubnetGroupName",
11019
+ db_system_id="dbSystemId",
10926
11020
  dedicated_log_volume=False,
10927
11021
  delete_automated_backups=False,
10928
11022
  deletion_protection=False,
@@ -11018,6 +11112,7 @@ class CfnDBInstanceProps:
11018
11112
  check_type(argname="argument db_security_groups", value=db_security_groups, expected_type=type_hints["db_security_groups"])
11019
11113
  check_type(argname="argument db_snapshot_identifier", value=db_snapshot_identifier, expected_type=type_hints["db_snapshot_identifier"])
11020
11114
  check_type(argname="argument db_subnet_group_name", value=db_subnet_group_name, expected_type=type_hints["db_subnet_group_name"])
11115
+ check_type(argname="argument db_system_id", value=db_system_id, expected_type=type_hints["db_system_id"])
11021
11116
  check_type(argname="argument dedicated_log_volume", value=dedicated_log_volume, expected_type=type_hints["dedicated_log_volume"])
11022
11117
  check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
11023
11118
  check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
@@ -11120,6 +11215,8 @@ class CfnDBInstanceProps:
11120
11215
  self._values["db_snapshot_identifier"] = db_snapshot_identifier
11121
11216
  if db_subnet_group_name is not None:
11122
11217
  self._values["db_subnet_group_name"] = db_subnet_group_name
11218
+ if db_system_id is not None:
11219
+ self._values["db_system_id"] = db_system_id
11123
11220
  if dedicated_log_volume is not None:
11124
11221
  self._values["dedicated_log_volume"] = dedicated_log_volume
11125
11222
  if delete_automated_backups is not None:
@@ -11733,6 +11830,17 @@ class CfnDBInstanceProps:
11733
11830
  result = self._values.get("db_subnet_group_name")
11734
11831
  return typing.cast(typing.Optional[builtins.str], result)
11735
11832
 
11833
+ @builtins.property
11834
+ def db_system_id(self) -> typing.Optional[builtins.str]:
11835
+ '''The Oracle system identifier (SID), which is the name of the Oracle database instance that manages your database files.
11836
+
11837
+ 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.
11838
+
11839
+ :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-dbsystemid
11840
+ '''
11841
+ result = self._values.get("db_system_id")
11842
+ return typing.cast(typing.Optional[builtins.str], result)
11843
+
11736
11844
  @builtins.property
11737
11845
  def dedicated_log_volume(
11738
11846
  self,
@@ -30488,6 +30596,12 @@ class MariaDbEngineVersion(
30488
30596
  '''Version "10.11" (only a major version, without a specific minor version).'''
30489
30597
  return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_11"))
30490
30598
 
30599
+ @jsii.python.classproperty
30600
+ @jsii.member(jsii_name="VER_10_11_10")
30601
+ def VER_10_11_10(cls) -> "MariaDbEngineVersion":
30602
+ '''Version "10.11.10".'''
30603
+ return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_11_10"))
30604
+
30491
30605
  @jsii.python.classproperty
30492
30606
  @jsii.member(jsii_name="VER_10_11_4")
30493
30607
  def VER_10_11_4(cls) -> "MariaDbEngineVersion":
@@ -31087,6 +31201,12 @@ class MariaDbEngineVersion(
31087
31201
  '''Version "10.5.26".'''
31088
31202
  return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_5_26"))
31089
31203
 
31204
+ @jsii.python.classproperty
31205
+ @jsii.member(jsii_name="VER_10_5_27")
31206
+ def VER_10_5_27(cls) -> "MariaDbEngineVersion":
31207
+ '''Version "10.5.27".'''
31208
+ return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_5_27"))
31209
+
31090
31210
  @jsii.python.classproperty
31091
31211
  @jsii.member(jsii_name="VER_10_5_8")
31092
31212
  def VER_10_5_8(cls) -> "MariaDbEngineVersion":
@@ -31190,6 +31310,12 @@ class MariaDbEngineVersion(
31190
31310
  '''Version "10.6.19".'''
31191
31311
  return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_6_19"))
31192
31312
 
31313
+ @jsii.python.classproperty
31314
+ @jsii.member(jsii_name="VER_10_6_20")
31315
+ def VER_10_6_20(cls) -> "MariaDbEngineVersion":
31316
+ '''Version "10.6.20".'''
31317
+ return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_6_20"))
31318
+
31193
31319
  @jsii.python.classproperty
31194
31320
  @jsii.member(jsii_name="VER_10_6_5")
31195
31321
  def VER_10_6_5(cls) -> "MariaDbEngineVersion":
@@ -31229,6 +31355,12 @@ class MariaDbEngineVersion(
31229
31355
  '''Version "11.4.3".'''
31230
31356
  return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_11_4_3"))
31231
31357
 
31358
+ @jsii.python.classproperty
31359
+ @jsii.member(jsii_name="VER_11_4_4")
31360
+ def VER_11_4_4(cls) -> "MariaDbEngineVersion":
31361
+ '''Version "11.4.4".'''
31362
+ return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_11_4_4"))
31363
+
31232
31364
  @builtins.property
31233
31365
  @jsii.member(jsii_name="mariaDbFullVersion")
31234
31366
  def maria_db_full_version(self) -> builtins.str:
@@ -34643,6 +34775,12 @@ class PostgresEngineVersion(
34643
34775
  '''Version "11.22-rds.20240808".'''
34644
34776
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_11_22_RDS_20240808"))
34645
34777
 
34778
+ @jsii.python.classproperty
34779
+ @jsii.member(jsii_name="VER_11_22_RDS_20241121")
34780
+ def VER_11_22_RDS_20241121(cls) -> "PostgresEngineVersion":
34781
+ '''Version "11.22-RDS.20241121".'''
34782
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_11_22_RDS_20241121"))
34783
+
34646
34784
  @jsii.python.classproperty
34647
34785
  @jsii.member(jsii_name="VER_11_4")
34648
34786
  def VER_11_4(cls) -> "PostgresEngineVersion":
@@ -46272,6 +46410,7 @@ def _typecheckingstub__1eb14b9dcc306eabcc2963c7b6ef9b87bf8d616bb5691dbc6656242be
46272
46410
  backup_retention_period: typing.Optional[jsii.Number] = None,
46273
46411
  cluster_scalability_type: typing.Optional[builtins.str] = None,
46274
46412
  copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
46413
+ database_insights_mode: typing.Optional[builtins.str] = None,
46275
46414
  database_name: typing.Optional[builtins.str] = None,
46276
46415
  db_cluster_identifier: typing.Optional[builtins.str] = None,
46277
46416
  db_cluster_instance_class: typing.Optional[builtins.str] = None,
@@ -46385,6 +46524,12 @@ def _typecheckingstub__7aaebe942bef486fa4f2def6b116a47a3513d6909fa29d9fdd20eb31f
46385
46524
  """Type checking stubs"""
46386
46525
  pass
46387
46526
 
46527
+ def _typecheckingstub__95529055a06b2a5642399d211890b3949094262771feb4c9ba4efe7d394d8efa(
46528
+ value: typing.Optional[builtins.str],
46529
+ ) -> None:
46530
+ """Type checking stubs"""
46531
+ pass
46532
+
46388
46533
  def _typecheckingstub__133622b74470290a34fd20f1677f713d047e14ddfc8138b0693817c347f0904f(
46389
46534
  value: typing.Optional[builtins.str],
46390
46535
  ) -> None:
@@ -46726,6 +46871,7 @@ def _typecheckingstub__5a6717af18f7b2b042b74ca423a540eb39f5ae817292b338733c6a3ce
46726
46871
  *,
46727
46872
  max_capacity: typing.Optional[jsii.Number] = None,
46728
46873
  min_capacity: typing.Optional[jsii.Number] = None,
46874
+ seconds_until_auto_pause: typing.Optional[jsii.Number] = None,
46729
46875
  ) -> None:
46730
46876
  """Type checking stubs"""
46731
46877
  pass
@@ -46806,6 +46952,7 @@ def _typecheckingstub__aaf089104646bb0ea95e48cd2107d642585c3eb3785a21112fc029b15
46806
46952
  backup_retention_period: typing.Optional[jsii.Number] = None,
46807
46953
  cluster_scalability_type: typing.Optional[builtins.str] = None,
46808
46954
  copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
46955
+ database_insights_mode: typing.Optional[builtins.str] = None,
46809
46956
  database_name: typing.Optional[builtins.str] = None,
46810
46957
  db_cluster_identifier: typing.Optional[builtins.str] = None,
46811
46958
  db_cluster_instance_class: typing.Optional[builtins.str] = None,
@@ -46886,6 +47033,7 @@ def _typecheckingstub__255b0779ca741853674876540bf77279f6293bea05de2cd18724d2b92
46886
47033
  db_security_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
46887
47034
  db_snapshot_identifier: typing.Optional[builtins.str] = None,
46888
47035
  db_subnet_group_name: typing.Optional[builtins.str] = None,
47036
+ db_system_id: typing.Optional[builtins.str] = None,
46889
47037
  dedicated_log_volume: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
46890
47038
  delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
46891
47039
  deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
@@ -47095,6 +47243,12 @@ def _typecheckingstub__ee9b5bb70dbab22ab4481a77c04dc86a6cae16b4c7d30ccb17a77b55d
47095
47243
  """Type checking stubs"""
47096
47244
  pass
47097
47245
 
47246
+ def _typecheckingstub__c2bcedc9b98a22e01ebba3d247528b50c6ecfcdf1d1d6193070deed3f0a91242(
47247
+ value: typing.Optional[builtins.str],
47248
+ ) -> None:
47249
+ """Type checking stubs"""
47250
+ pass
47251
+
47098
47252
  def _typecheckingstub__7cd09d7a96adc908e67e26f47cc2b3781666622d7377834d51fb7cb5e0371bcf(
47099
47253
  value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
47100
47254
  ) -> None:
@@ -47491,6 +47645,7 @@ def _typecheckingstub__3bddb1be0bd1f1699e3a084c5859d94d8879ff15011f2f2eaac29ec16
47491
47645
  db_security_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
47492
47646
  db_snapshot_identifier: typing.Optional[builtins.str] = None,
47493
47647
  db_subnet_group_name: typing.Optional[builtins.str] = None,
47648
+ db_system_id: typing.Optional[builtins.str] = None,
47494
47649
  dedicated_log_volume: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
47495
47650
  delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
47496
47651
  deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,