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

@@ -355,7 +355,7 @@ DB instance to a status of `incompatible-parameters`. While the DB instance has
355
355
  the incompatible-parameters status, some operations are blocked. For example,
356
356
  you can't upgrade the engine version.
357
357
 
358
- #### CA certificate
358
+ ### CA certificate
359
359
 
360
360
  Use the `caCertificate` property to specify the [CA certificates](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html)
361
361
  to use for a cluster instances:
@@ -377,6 +377,35 @@ cluster = rds.DatabaseCluster(self, "Database",
377
377
  )
378
378
  ```
379
379
 
380
+ ### Scheduling modifications
381
+
382
+ To schedule modifications to database instances in the next scheduled maintenance window, specify `applyImmediately` to `false` in the instance props:
383
+
384
+ ```python
385
+ # vpc: ec2.Vpc
386
+
387
+ rds.DatabaseCluster(self, "Database",
388
+ engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_01_0),
389
+ writer=rds.ClusterInstance.provisioned("writer",
390
+ apply_immediately=False
391
+ ),
392
+ readers=[
393
+ rds.ClusterInstance.serverless_v2("reader",
394
+ apply_immediately=False
395
+ )
396
+ ],
397
+ vpc=vpc
398
+ )
399
+ ```
400
+
401
+ Until RDS applies the changes, the DB instance remains in a drift state.
402
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
403
+
404
+ Currently, CloudFormation does not support to schedule modifications of the cluster configurations.
405
+ To apply changes of the cluster, such as engine version, in the next scheduled maintenance window, you should use `modify-db-cluster` CLI command or management console.
406
+
407
+ For details, see [Modifying an Amazon Aurora DB cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Modifying.html).
408
+
380
409
  ### Migrating from instanceProps
381
410
 
382
411
  Creating instances in a `DatabaseCluster` using `instanceProps` & `instances` is
@@ -756,6 +785,25 @@ rds.DatabaseInstance(self, "Instance",
756
785
  )
757
786
  ```
758
787
 
788
+ ### Scheduling modifications
789
+
790
+ To schedule modifications in the next scheduled maintenance window, specify `applyImmediately` to `false`:
791
+
792
+ ```python
793
+ # vpc: ec2.Vpc
794
+
795
+ rds.DatabaseInstance(self, "Instance",
796
+ engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_39),
797
+ vpc=vpc,
798
+ apply_immediately=False
799
+ )
800
+ ```
801
+
802
+ Until RDS applies the changes, the DB instance remains in a drift state.
803
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
804
+
805
+ For details, see [Using the schedule modifications setting](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ModifyInstance.ApplyImmediately.html).
806
+
759
807
  ## Setting Public Accessibility
760
808
 
761
809
  You can set public accessibility for the `DatabaseInstance` or the `ClusterInstance` using the `publiclyAccessible` property.
@@ -2246,11 +2294,14 @@ class AuroraMysqlEngineVersion(
2246
2294
 
2247
2295
  cluster = rds.DatabaseCluster(self, "Database",
2248
2296
  engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_01_0),
2249
- writer=rds.ClusterInstance.provisioned("Instance",
2250
- instance_type=ec2.InstanceType.of(ec2.InstanceClass.BURSTABLE3, ec2.InstanceSize.SMALL)
2297
+ writer=rds.ClusterInstance.provisioned("writer",
2298
+ ca_certificate=rds.CaCertificate.RDS_CA_RSA2048_G1
2251
2299
  ),
2252
- readers=[rds.ClusterInstance.provisioned("reader")],
2253
- instance_update_behaviour=rds.InstanceUpdateBehaviour.ROLLING, # Optional - defaults to rds.InstanceUpdateBehaviour.BULK
2300
+ readers=[
2301
+ rds.ClusterInstance.serverless_v2("reader",
2302
+ ca_certificate=rds.CaCertificate.of("custom-ca")
2303
+ )
2304
+ ],
2254
2305
  vpc=vpc
2255
2306
  )
2256
2307
  '''
@@ -8953,7 +9004,7 @@ class CfnDBInstance(
8953
9004
  :param source_region: The ID of the region that contains the source DB instance for the read replica.
8954
9005
  :param storage_encrypted: A value that indicates whether the DB instance is encrypted. By default, it isn't encrypted. If you specify the ``KmsKeyId`` property, then you must enable encryption. If you specify the ``SourceDBInstanceIdentifier`` or ``SourceDbiResourceId`` property, don't specify this property. The value is inherited from the source DB instance, and if the DB instance is encrypted, the specified ``KmsKeyId`` property is used. If you specify the ``SourceDBInstanceAutomatedBackupsArn`` property, don't specify this property. The value is inherited from the source DB instance automated backup. If you specify ``DBSnapshotIdentifier`` property, don't specify this property. The value is inherited from the snapshot. *Amazon Aurora* Not applicable. The encryption for DB instances is managed by the DB cluster.
8955
9006
  :param storage_throughput: Specifies the storage throughput value, in mebibyte per second (MiBps), for the DB instance. This setting applies only to the ``gp3`` storage type. This setting doesn't apply to RDS Custom or Amazon Aurora.
8956
- :param storage_type: The storage type to associate with the DB instance. If you specify ``io1`` , ``io2`` , or ``gp3`` , you must also include a value for the ``Iops`` parameter. This setting doesn't apply to Amazon Aurora DB instances. Storage is managed by the DB cluster. Valid Values: ``gp2 | gp3 | io1 | io2 | standard`` Default: ``io1`` , if the ``Iops`` parameter is specified. Otherwise, ``gp2`` .
9007
+ :param storage_type: The storage type to associate with the DB instance. If you specify ``io1`` , ``io2`` , or ``gp3`` , you must also include a value for the ``Iops`` parameter. This setting doesn't apply to Amazon Aurora DB instances. Storage is managed by the DB cluster. Valid Values: ``gp2 | gp3 | io1 | io2 | standard`` Default: ``io1`` , if the ``Iops`` parameter is specified. Otherwise, ``gp3`` .
8957
9008
  :param tags: Tags to assign to the DB instance.
8958
9009
  :param tde_credential_arn:
8959
9010
  :param tde_credential_password:
@@ -11025,7 +11076,7 @@ class CfnDBInstanceProps:
11025
11076
  :param source_region: The ID of the region that contains the source DB instance for the read replica.
11026
11077
  :param storage_encrypted: A value that indicates whether the DB instance is encrypted. By default, it isn't encrypted. If you specify the ``KmsKeyId`` property, then you must enable encryption. If you specify the ``SourceDBInstanceIdentifier`` or ``SourceDbiResourceId`` property, don't specify this property. The value is inherited from the source DB instance, and if the DB instance is encrypted, the specified ``KmsKeyId`` property is used. If you specify the ``SourceDBInstanceAutomatedBackupsArn`` property, don't specify this property. The value is inherited from the source DB instance automated backup. If you specify ``DBSnapshotIdentifier`` property, don't specify this property. The value is inherited from the snapshot. *Amazon Aurora* Not applicable. The encryption for DB instances is managed by the DB cluster.
11027
11078
  :param storage_throughput: Specifies the storage throughput value, in mebibyte per second (MiBps), for the DB instance. This setting applies only to the ``gp3`` storage type. This setting doesn't apply to RDS Custom or Amazon Aurora.
11028
- :param storage_type: The storage type to associate with the DB instance. If you specify ``io1`` , ``io2`` , or ``gp3`` , you must also include a value for the ``Iops`` parameter. This setting doesn't apply to Amazon Aurora DB instances. Storage is managed by the DB cluster. Valid Values: ``gp2 | gp3 | io1 | io2 | standard`` Default: ``io1`` , if the ``Iops`` parameter is specified. Otherwise, ``gp2`` .
11079
+ :param storage_type: The storage type to associate with the DB instance. If you specify ``io1`` , ``io2`` , or ``gp3`` , you must also include a value for the ``Iops`` parameter. This setting doesn't apply to Amazon Aurora DB instances. Storage is managed by the DB cluster. Valid Values: ``gp2 | gp3 | io1 | io2 | standard`` Default: ``io1`` , if the ``Iops`` parameter is specified. Otherwise, ``gp3`` .
11029
11080
  :param tags: Tags to assign to the DB instance.
11030
11081
  :param tde_credential_arn:
11031
11082
  :param tde_credential_password:
@@ -12849,7 +12900,7 @@ class CfnDBInstanceProps:
12849
12900
 
12850
12901
  Valid Values: ``gp2 | gp3 | io1 | io2 | standard``
12851
12902
 
12852
- Default: ``io1`` , if the ``Iops`` parameter is specified. Otherwise, ``gp2`` .
12903
+ Default: ``io1`` , if the ``Iops`` parameter is specified. Otherwise, ``gp3`` .
12853
12904
 
12854
12905
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-storagetype
12855
12906
  '''
@@ -18920,6 +18971,7 @@ class ClusterInstanceBindOptions:
18920
18971
  jsii_struct_bases=[],
18921
18972
  name_mapping={
18922
18973
  "allow_major_version_upgrade": "allowMajorVersionUpgrade",
18974
+ "apply_immediately": "applyImmediately",
18923
18975
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
18924
18976
  "ca_certificate": "caCertificate",
18925
18977
  "enable_performance_insights": "enablePerformanceInsights",
@@ -18938,6 +18990,7 @@ class ClusterInstanceOptions:
18938
18990
  self,
18939
18991
  *,
18940
18992
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
18993
+ apply_immediately: typing.Optional[builtins.bool] = None,
18941
18994
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
18942
18995
  ca_certificate: typing.Optional[CaCertificate] = None,
18943
18996
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -18953,6 +19006,7 @@ class ClusterInstanceOptions:
18953
19006
  '''Common options for creating a cluster instance.
18954
19007
 
18955
19008
  :param allow_major_version_upgrade: Whether to allow upgrade of major version for the DB instance. Default: - false
19009
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
18956
19010
  :param auto_minor_version_upgrade: Whether to enable automatic upgrade of minor version for the DB instance. Default: - true
18957
19011
  :param ca_certificate: The identifier of the CA certificate for this DB cluster's instances. Specifying or updating this property triggers a reboot. For RDS DB engines: Default: - RDS will choose a certificate authority
18958
19012
  :param enable_performance_insights: Whether to enable Performance Insights for the DB instance. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set.
@@ -18980,6 +19034,7 @@ class ClusterInstanceOptions:
18980
19034
 
18981
19035
  cluster_instance_options = rds.ClusterInstanceOptions(
18982
19036
  allow_major_version_upgrade=False,
19037
+ apply_immediately=False,
18983
19038
  auto_minor_version_upgrade=False,
18984
19039
  ca_certificate=ca_certificate,
18985
19040
  enable_performance_insights=False,
@@ -18998,6 +19053,7 @@ class ClusterInstanceOptions:
18998
19053
  if __debug__:
18999
19054
  type_hints = typing.get_type_hints(_typecheckingstub__8cdde1ea7f85160803079277e8fcc0af34768579c1b17b771033b3c6374858ac)
19000
19055
  check_type(argname="argument allow_major_version_upgrade", value=allow_major_version_upgrade, expected_type=type_hints["allow_major_version_upgrade"])
19056
+ check_type(argname="argument apply_immediately", value=apply_immediately, expected_type=type_hints["apply_immediately"])
19001
19057
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
19002
19058
  check_type(argname="argument ca_certificate", value=ca_certificate, expected_type=type_hints["ca_certificate"])
19003
19059
  check_type(argname="argument enable_performance_insights", value=enable_performance_insights, expected_type=type_hints["enable_performance_insights"])
@@ -19012,6 +19068,8 @@ class ClusterInstanceOptions:
19012
19068
  self._values: typing.Dict[builtins.str, typing.Any] = {}
19013
19069
  if allow_major_version_upgrade is not None:
19014
19070
  self._values["allow_major_version_upgrade"] = allow_major_version_upgrade
19071
+ if apply_immediately is not None:
19072
+ self._values["apply_immediately"] = apply_immediately
19015
19073
  if auto_minor_version_upgrade is not None:
19016
19074
  self._values["auto_minor_version_upgrade"] = auto_minor_version_upgrade
19017
19075
  if ca_certificate is not None:
@@ -19044,6 +19102,24 @@ class ClusterInstanceOptions:
19044
19102
  result = self._values.get("allow_major_version_upgrade")
19045
19103
  return typing.cast(typing.Optional[builtins.bool], result)
19046
19104
 
19105
+ @builtins.property
19106
+ def apply_immediately(self) -> typing.Optional[builtins.bool]:
19107
+ '''Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting.
19108
+
19109
+ If set to ``false``, changes are applied during the next maintenance window.
19110
+
19111
+ Until RDS applies the changes, the DB instance remains in a drift state.
19112
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
19113
+
19114
+ This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.
19115
+
19116
+ :default: - Changes will be applied immediately
19117
+
19118
+ :see: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Modifying.html
19119
+ '''
19120
+ result = self._values.get("apply_immediately")
19121
+ return typing.cast(typing.Optional[builtins.bool], result)
19122
+
19047
19123
  @builtins.property
19048
19124
  def auto_minor_version_upgrade(self) -> typing.Optional[builtins.bool]:
19049
19125
  '''Whether to enable automatic upgrade of minor version for the DB instance.
@@ -19228,6 +19304,7 @@ class ClusterInstanceOptions:
19228
19304
  jsii_struct_bases=[ClusterInstanceOptions],
19229
19305
  name_mapping={
19230
19306
  "allow_major_version_upgrade": "allowMajorVersionUpgrade",
19307
+ "apply_immediately": "applyImmediately",
19231
19308
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
19232
19309
  "ca_certificate": "caCertificate",
19233
19310
  "enable_performance_insights": "enablePerformanceInsights",
@@ -19248,6 +19325,7 @@ class ClusterInstanceProps(ClusterInstanceOptions):
19248
19325
  self,
19249
19326
  *,
19250
19327
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
19328
+ apply_immediately: typing.Optional[builtins.bool] = None,
19251
19329
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
19252
19330
  ca_certificate: typing.Optional[CaCertificate] = None,
19253
19331
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -19265,6 +19343,7 @@ class ClusterInstanceProps(ClusterInstanceOptions):
19265
19343
  '''Common options for creating cluster instances (both serverless and provisioned).
19266
19344
 
19267
19345
  :param allow_major_version_upgrade: Whether to allow upgrade of major version for the DB instance. Default: - false
19346
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
19268
19347
  :param auto_minor_version_upgrade: Whether to enable automatic upgrade of minor version for the DB instance. Default: - true
19269
19348
  :param ca_certificate: The identifier of the CA certificate for this DB cluster's instances. Specifying or updating this property triggers a reboot. For RDS DB engines: Default: - RDS will choose a certificate authority
19270
19349
  :param enable_performance_insights: Whether to enable Performance Insights for the DB instance. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set.
@@ -19298,6 +19377,7 @@ class ClusterInstanceProps(ClusterInstanceOptions):
19298
19377
 
19299
19378
  # the properties below are optional
19300
19379
  allow_major_version_upgrade=False,
19380
+ apply_immediately=False,
19301
19381
  auto_minor_version_upgrade=False,
19302
19382
  ca_certificate=ca_certificate,
19303
19383
  enable_performance_insights=False,
@@ -19317,6 +19397,7 @@ class ClusterInstanceProps(ClusterInstanceOptions):
19317
19397
  if __debug__:
19318
19398
  type_hints = typing.get_type_hints(_typecheckingstub__431d59239caf38b9912bfae3130d40eeb8bdb18e013240bac43c980158561c00)
19319
19399
  check_type(argname="argument allow_major_version_upgrade", value=allow_major_version_upgrade, expected_type=type_hints["allow_major_version_upgrade"])
19400
+ check_type(argname="argument apply_immediately", value=apply_immediately, expected_type=type_hints["apply_immediately"])
19320
19401
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
19321
19402
  check_type(argname="argument ca_certificate", value=ca_certificate, expected_type=type_hints["ca_certificate"])
19322
19403
  check_type(argname="argument enable_performance_insights", value=enable_performance_insights, expected_type=type_hints["enable_performance_insights"])
@@ -19335,6 +19416,8 @@ class ClusterInstanceProps(ClusterInstanceOptions):
19335
19416
  }
19336
19417
  if allow_major_version_upgrade is not None:
19337
19418
  self._values["allow_major_version_upgrade"] = allow_major_version_upgrade
19419
+ if apply_immediately is not None:
19420
+ self._values["apply_immediately"] = apply_immediately
19338
19421
  if auto_minor_version_upgrade is not None:
19339
19422
  self._values["auto_minor_version_upgrade"] = auto_minor_version_upgrade
19340
19423
  if ca_certificate is not None:
@@ -19369,6 +19452,24 @@ class ClusterInstanceProps(ClusterInstanceOptions):
19369
19452
  result = self._values.get("allow_major_version_upgrade")
19370
19453
  return typing.cast(typing.Optional[builtins.bool], result)
19371
19454
 
19455
+ @builtins.property
19456
+ def apply_immediately(self) -> typing.Optional[builtins.bool]:
19457
+ '''Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting.
19458
+
19459
+ If set to ``false``, changes are applied during the next maintenance window.
19460
+
19461
+ Until RDS applies the changes, the DB instance remains in a drift state.
19462
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
19463
+
19464
+ This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.
19465
+
19466
+ :default: - Changes will be applied immediately
19467
+
19468
+ :see: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Modifying.html
19469
+ '''
19470
+ result = self._values.get("apply_immediately")
19471
+ return typing.cast(typing.Optional[builtins.bool], result)
19472
+
19372
19473
  @builtins.property
19373
19474
  def auto_minor_version_upgrade(self) -> typing.Optional[builtins.bool]:
19374
19475
  '''Whether to enable automatic upgrade of minor version for the DB instance.
@@ -23187,6 +23288,7 @@ class DatabaseInstanceEngine(
23187
23288
  jsii_struct_bases=[],
23188
23289
  name_mapping={
23189
23290
  "vpc": "vpc",
23291
+ "apply_immediately": "applyImmediately",
23190
23292
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
23191
23293
  "availability_zone": "availabilityZone",
23192
23294
  "backup_retention": "backupRetention",
@@ -23234,6 +23336,7 @@ class DatabaseInstanceNewProps:
23234
23336
  self,
23235
23337
  *,
23236
23338
  vpc: _IVpc_f30d5663,
23339
+ apply_immediately: typing.Optional[builtins.bool] = None,
23237
23340
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
23238
23341
  availability_zone: typing.Optional[builtins.str] = None,
23239
23342
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -23278,6 +23381,7 @@ class DatabaseInstanceNewProps:
23278
23381
  '''Construction properties for a DatabaseInstanceNew.
23279
23382
 
23280
23383
  :param vpc: The VPC network where the DB subnet group should be created.
23384
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
23281
23385
  :param auto_minor_version_upgrade: Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. Default: true
23282
23386
  :param availability_zone: The name of the Availability Zone where the DB instance will be located. Default: - no preference
23283
23387
  :param backup_retention: The number of days during which automatic DB snapshots are retained. Set to zero to disable backups. When creating a read replica, you must enable automatic backups on the source database instance by setting the backup retention to a value other than zero. Default: - Duration.days(1) for source instances, disabled for read replicas
@@ -23349,6 +23453,7 @@ class DatabaseInstanceNewProps:
23349
23453
  vpc=vpc,
23350
23454
 
23351
23455
  # the properties below are optional
23456
+ apply_immediately=False,
23352
23457
  auto_minor_version_upgrade=False,
23353
23458
  availability_zone="availabilityZone",
23354
23459
  backup_retention=cdk.Duration.minutes(30),
@@ -23408,6 +23513,7 @@ class DatabaseInstanceNewProps:
23408
23513
  if __debug__:
23409
23514
  type_hints = typing.get_type_hints(_typecheckingstub__d110b1cb0043ae6adf59fc0d1bcb136b4655ac973cfbff361a0a3e2fe97c39f8)
23410
23515
  check_type(argname="argument vpc", value=vpc, expected_type=type_hints["vpc"])
23516
+ check_type(argname="argument apply_immediately", value=apply_immediately, expected_type=type_hints["apply_immediately"])
23411
23517
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
23412
23518
  check_type(argname="argument availability_zone", value=availability_zone, expected_type=type_hints["availability_zone"])
23413
23519
  check_type(argname="argument backup_retention", value=backup_retention, expected_type=type_hints["backup_retention"])
@@ -23451,6 +23557,8 @@ class DatabaseInstanceNewProps:
23451
23557
  self._values: typing.Dict[builtins.str, typing.Any] = {
23452
23558
  "vpc": vpc,
23453
23559
  }
23560
+ if apply_immediately is not None:
23561
+ self._values["apply_immediately"] = apply_immediately
23454
23562
  if auto_minor_version_upgrade is not None:
23455
23563
  self._values["auto_minor_version_upgrade"] = auto_minor_version_upgrade
23456
23564
  if availability_zone is not None:
@@ -23539,6 +23647,24 @@ class DatabaseInstanceNewProps:
23539
23647
  assert result is not None, "Required property 'vpc' is missing"
23540
23648
  return typing.cast(_IVpc_f30d5663, result)
23541
23649
 
23650
+ @builtins.property
23651
+ def apply_immediately(self) -> typing.Optional[builtins.bool]:
23652
+ '''Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting.
23653
+
23654
+ If set to ``false``, changes are applied during the next maintenance window.
23655
+
23656
+ Until RDS applies the changes, the DB instance remains in a drift state.
23657
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
23658
+
23659
+ This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.
23660
+
23661
+ :default: - Changes will be applied immediately
23662
+
23663
+ :see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html
23664
+ '''
23665
+ result = self._values.get("apply_immediately")
23666
+ return typing.cast(typing.Optional[builtins.bool], result)
23667
+
23542
23668
  @builtins.property
23543
23669
  def auto_minor_version_upgrade(self) -> typing.Optional[builtins.bool]:
23544
23670
  '''Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.
@@ -24014,6 +24140,7 @@ class DatabaseInstanceNewProps:
24014
24140
  jsii_struct_bases=[DatabaseInstanceNewProps],
24015
24141
  name_mapping={
24016
24142
  "vpc": "vpc",
24143
+ "apply_immediately": "applyImmediately",
24017
24144
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
24018
24145
  "availability_zone": "availabilityZone",
24019
24146
  "backup_retention": "backupRetention",
@@ -24066,6 +24193,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24066
24193
  self,
24067
24194
  *,
24068
24195
  vpc: _IVpc_f30d5663,
24196
+ apply_immediately: typing.Optional[builtins.bool] = None,
24069
24197
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
24070
24198
  availability_zone: typing.Optional[builtins.str] = None,
24071
24199
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -24115,6 +24243,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24115
24243
  '''Construction properties for a DatabaseInstanceReadReplica.
24116
24244
 
24117
24245
  :param vpc: The VPC network where the DB subnet group should be created.
24246
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
24118
24247
  :param auto_minor_version_upgrade: Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. Default: true
24119
24248
  :param availability_zone: The name of the Availability Zone where the DB instance will be located. Default: - no preference
24120
24249
  :param backup_retention: The number of days during which automatic DB snapshots are retained. Set to zero to disable backups. When creating a read replica, you must enable automatic backups on the source database instance by setting the backup retention to a value other than zero. Default: - Duration.days(1) for source instances, disabled for read replicas
@@ -24189,6 +24318,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24189
24318
  if __debug__:
24190
24319
  type_hints = typing.get_type_hints(_typecheckingstub__5508238388ee4afc86f97d5f22fa50578f8a1bdeed9ade8d0210c955bf30718e)
24191
24320
  check_type(argname="argument vpc", value=vpc, expected_type=type_hints["vpc"])
24321
+ check_type(argname="argument apply_immediately", value=apply_immediately, expected_type=type_hints["apply_immediately"])
24192
24322
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
24193
24323
  check_type(argname="argument availability_zone", value=availability_zone, expected_type=type_hints["availability_zone"])
24194
24324
  check_type(argname="argument backup_retention", value=backup_retention, expected_type=type_hints["backup_retention"])
@@ -24239,6 +24369,8 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24239
24369
  "instance_type": instance_type,
24240
24370
  "source_database_instance": source_database_instance,
24241
24371
  }
24372
+ if apply_immediately is not None:
24373
+ self._values["apply_immediately"] = apply_immediately
24242
24374
  if auto_minor_version_upgrade is not None:
24243
24375
  self._values["auto_minor_version_upgrade"] = auto_minor_version_upgrade
24244
24376
  if availability_zone is not None:
@@ -24333,6 +24465,24 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24333
24465
  assert result is not None, "Required property 'vpc' is missing"
24334
24466
  return typing.cast(_IVpc_f30d5663, result)
24335
24467
 
24468
+ @builtins.property
24469
+ def apply_immediately(self) -> typing.Optional[builtins.bool]:
24470
+ '''Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting.
24471
+
24472
+ If set to ``false``, changes are applied during the next maintenance window.
24473
+
24474
+ Until RDS applies the changes, the DB instance remains in a drift state.
24475
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
24476
+
24477
+ This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.
24478
+
24479
+ :default: - Changes will be applied immediately
24480
+
24481
+ :see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html
24482
+ '''
24483
+ result = self._values.get("apply_immediately")
24484
+ return typing.cast(typing.Optional[builtins.bool], result)
24485
+
24336
24486
  @builtins.property
24337
24487
  def auto_minor_version_upgrade(self) -> typing.Optional[builtins.bool]:
24338
24488
  '''Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.
@@ -24853,6 +25003,7 @@ class DatabaseInstanceReadReplicaProps(DatabaseInstanceNewProps):
24853
25003
  jsii_struct_bases=[DatabaseInstanceNewProps],
24854
25004
  name_mapping={
24855
25005
  "vpc": "vpc",
25006
+ "apply_immediately": "applyImmediately",
24856
25007
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
24857
25008
  "availability_zone": "availabilityZone",
24858
25009
  "backup_retention": "backupRetention",
@@ -24908,6 +25059,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
24908
25059
  self,
24909
25060
  *,
24910
25061
  vpc: _IVpc_f30d5663,
25062
+ apply_immediately: typing.Optional[builtins.bool] = None,
24911
25063
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
24912
25064
  availability_zone: typing.Optional[builtins.str] = None,
24913
25065
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -24960,6 +25112,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
24960
25112
  '''Construction properties for a DatabaseInstanceSource.
24961
25113
 
24962
25114
  :param vpc: The VPC network where the DB subnet group should be created.
25115
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
24963
25116
  :param auto_minor_version_upgrade: Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. Default: true
24964
25117
  :param availability_zone: The name of the Availability Zone where the DB instance will be located. Default: - no preference
24965
25118
  :param backup_retention: The number of days during which automatic DB snapshots are retained. Set to zero to disable backups. When creating a read replica, you must enable automatic backups on the source database instance by setting the backup retention to a value other than zero. Default: - Duration.days(1) for source instances, disabled for read replicas
@@ -25044,6 +25197,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25044
25197
  # the properties below are optional
25045
25198
  allocated_storage=123,
25046
25199
  allow_major_version_upgrade=False,
25200
+ apply_immediately=False,
25047
25201
  auto_minor_version_upgrade=False,
25048
25202
  availability_zone="availabilityZone",
25049
25203
  backup_retention=cdk.Duration.minutes(30),
@@ -25110,6 +25264,7 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25110
25264
  if __debug__:
25111
25265
  type_hints = typing.get_type_hints(_typecheckingstub__77d3b41152c4c7a3436d76bad0d83368717917e66a0f0cd849998fcd400f483c)
25112
25266
  check_type(argname="argument vpc", value=vpc, expected_type=type_hints["vpc"])
25267
+ check_type(argname="argument apply_immediately", value=apply_immediately, expected_type=type_hints["apply_immediately"])
25113
25268
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
25114
25269
  check_type(argname="argument availability_zone", value=availability_zone, expected_type=type_hints["availability_zone"])
25115
25270
  check_type(argname="argument backup_retention", value=backup_retention, expected_type=type_hints["backup_retention"])
@@ -25162,6 +25317,8 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25162
25317
  "vpc": vpc,
25163
25318
  "engine": engine,
25164
25319
  }
25320
+ if apply_immediately is not None:
25321
+ self._values["apply_immediately"] = apply_immediately
25165
25322
  if auto_minor_version_upgrade is not None:
25166
25323
  self._values["auto_minor_version_upgrade"] = auto_minor_version_upgrade
25167
25324
  if availability_zone is not None:
@@ -25264,6 +25421,24 @@ class DatabaseInstanceSourceProps(DatabaseInstanceNewProps):
25264
25421
  assert result is not None, "Required property 'vpc' is missing"
25265
25422
  return typing.cast(_IVpc_f30d5663, result)
25266
25423
 
25424
+ @builtins.property
25425
+ def apply_immediately(self) -> typing.Optional[builtins.bool]:
25426
+ '''Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting.
25427
+
25428
+ If set to ``false``, changes are applied during the next maintenance window.
25429
+
25430
+ Until RDS applies the changes, the DB instance remains in a drift state.
25431
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
25432
+
25433
+ This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.
25434
+
25435
+ :default: - Changes will be applied immediately
25436
+
25437
+ :see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html
25438
+ '''
25439
+ result = self._values.get("apply_immediately")
25440
+ return typing.cast(typing.Optional[builtins.bool], result)
25441
+
25267
25442
  @builtins.property
25268
25443
  def auto_minor_version_upgrade(self) -> typing.Optional[builtins.bool]:
25269
25444
  '''Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.
@@ -31840,21 +32015,15 @@ class MySqlInstanceEngineProps:
31840
32015
  Example::
31841
32016
 
31842
32017
  # vpc: ec2.Vpc
32018
+ # kms_key: kms.Key
31843
32019
 
31844
-
31845
- iops_instance = rds.DatabaseInstance(self, "IopsInstance",
31846
- engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_39),
31847
- vpc=vpc,
31848
- storage_type=rds.StorageType.IO1,
31849
- iops=5000
31850
- )
31851
-
31852
- gp3_instance = rds.DatabaseInstance(self, "Gp3Instance",
32020
+ instance = rds.DatabaseInstance(self, "Instance",
31853
32021
  engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_39),
32022
+ instance_type=ec2.InstanceType.of(ec2.InstanceClass.R7G, ec2.InstanceSize.LARGE),
31854
32023
  vpc=vpc,
31855
- allocated_storage=500,
31856
- storage_type=rds.StorageType.GP3,
31857
- storage_throughput=500
32024
+ enable_performance_insights=True,
32025
+ performance_insight_retention=rds.PerformanceInsightRetention.LONG_TERM,
32026
+ performance_insight_encryption_key=kms_key
31858
32027
  )
31859
32028
  '''
31860
32029
  if __debug__:
@@ -31894,21 +32063,15 @@ class MysqlEngineVersion(
31894
32063
  Example::
31895
32064
 
31896
32065
  # vpc: ec2.Vpc
32066
+ # kms_key: kms.Key
31897
32067
 
31898
-
31899
- iops_instance = rds.DatabaseInstance(self, "IopsInstance",
31900
- engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_39),
31901
- vpc=vpc,
31902
- storage_type=rds.StorageType.IO1,
31903
- iops=5000
31904
- )
31905
-
31906
- gp3_instance = rds.DatabaseInstance(self, "Gp3Instance",
32068
+ instance = rds.DatabaseInstance(self, "Instance",
31907
32069
  engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_39),
32070
+ instance_type=ec2.InstanceType.of(ec2.InstanceClass.R7G, ec2.InstanceSize.LARGE),
31908
32071
  vpc=vpc,
31909
- allocated_storage=500,
31910
- storage_type=rds.StorageType.GP3,
31911
- storage_throughput=500
32072
+ enable_performance_insights=True,
32073
+ performance_insight_retention=rds.PerformanceInsightRetention.LONG_TERM,
32074
+ performance_insight_encryption_key=kms_key
31912
32075
  )
31913
32076
  '''
31914
32077
 
@@ -35527,6 +35690,12 @@ class PostgresEngineVersion(
35527
35690
  '''Version "13.18".'''
35528
35691
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_13_18"))
35529
35692
 
35693
+ @jsii.python.classproperty
35694
+ @jsii.member(jsii_name="VER_13_19")
35695
+ def VER_13_19(cls) -> "PostgresEngineVersion":
35696
+ '''Version "13.19".'''
35697
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_13_19"))
35698
+
35530
35699
  @jsii.python.classproperty
35531
35700
  @jsii.member(jsii_name="VER_13_2")
35532
35701
  def VER_13_2(cls) -> "PostgresEngineVersion":
@@ -35538,6 +35707,12 @@ class PostgresEngineVersion(
35538
35707
  '''
35539
35708
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_13_2"))
35540
35709
 
35710
+ @jsii.python.classproperty
35711
+ @jsii.member(jsii_name="VER_13_20")
35712
+ def VER_13_20(cls) -> "PostgresEngineVersion":
35713
+ '''Version "13.20".'''
35714
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_13_20"))
35715
+
35541
35716
  @jsii.python.classproperty
35542
35717
  @jsii.member(jsii_name="VER_13_3")
35543
35718
  def VER_13_3(cls) -> "PostgresEngineVersion":
@@ -35668,6 +35843,18 @@ class PostgresEngineVersion(
35668
35843
  '''Version "14.15".'''
35669
35844
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_14_15"))
35670
35845
 
35846
+ @jsii.python.classproperty
35847
+ @jsii.member(jsii_name="VER_14_16")
35848
+ def VER_14_16(cls) -> "PostgresEngineVersion":
35849
+ '''Version "14.16".'''
35850
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_14_16"))
35851
+
35852
+ @jsii.python.classproperty
35853
+ @jsii.member(jsii_name="VER_14_17")
35854
+ def VER_14_17(cls) -> "PostgresEngineVersion":
35855
+ '''Version "14.17".'''
35856
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_14_17"))
35857
+
35671
35858
  @jsii.python.classproperty
35672
35859
  @jsii.member(jsii_name="VER_14_2")
35673
35860
  def VER_14_2(cls) -> "PostgresEngineVersion":
@@ -35763,6 +35950,18 @@ class PostgresEngineVersion(
35763
35950
  '''Version "15.10".'''
35764
35951
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_15_10"))
35765
35952
 
35953
+ @jsii.python.classproperty
35954
+ @jsii.member(jsii_name="VER_15_11")
35955
+ def VER_15_11(cls) -> "PostgresEngineVersion":
35956
+ '''Version "15.11".'''
35957
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_15_11"))
35958
+
35959
+ @jsii.python.classproperty
35960
+ @jsii.member(jsii_name="VER_15_12")
35961
+ def VER_15_12(cls) -> "PostgresEngineVersion":
35962
+ '''Version "15.12".'''
35963
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_15_12"))
35964
+
35766
35965
  @jsii.python.classproperty
35767
35966
  @jsii.member(jsii_name="VER_15_2")
35768
35967
  def VER_15_2(cls) -> "PostgresEngineVersion":
@@ -35869,6 +36068,12 @@ class PostgresEngineVersion(
35869
36068
  '''Version "16.7".'''
35870
36069
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_16_7"))
35871
36070
 
36071
+ @jsii.python.classproperty
36072
+ @jsii.member(jsii_name="VER_16_8")
36073
+ def VER_16_8(cls) -> "PostgresEngineVersion":
36074
+ '''Version "16.8".'''
36075
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_16_8"))
36076
+
35872
36077
  @jsii.python.classproperty
35873
36078
  @jsii.member(jsii_name="VER_17")
35874
36079
  def VER_17(cls) -> "PostgresEngineVersion":
@@ -35887,6 +36092,18 @@ class PostgresEngineVersion(
35887
36092
  '''Version "17.2".'''
35888
36093
  return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_17_2"))
35889
36094
 
36095
+ @jsii.python.classproperty
36096
+ @jsii.member(jsii_name="VER_17_3")
36097
+ def VER_17_3(cls) -> "PostgresEngineVersion":
36098
+ '''Version "17.3".'''
36099
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_17_3"))
36100
+
36101
+ @jsii.python.classproperty
36102
+ @jsii.member(jsii_name="VER_17_4")
36103
+ def VER_17_4(cls) -> "PostgresEngineVersion":
36104
+ '''Version "17.4".'''
36105
+ return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_17_4"))
36106
+
35890
36107
  @jsii.python.classproperty
35891
36108
  @jsii.member(jsii_name="VER_9_6_24")
35892
36109
  def VER_9_6_24(cls) -> "PostgresEngineVersion":
@@ -36045,6 +36262,7 @@ class ProcessorFeatures:
36045
36262
  jsii_struct_bases=[ClusterInstanceOptions],
36046
36263
  name_mapping={
36047
36264
  "allow_major_version_upgrade": "allowMajorVersionUpgrade",
36265
+ "apply_immediately": "applyImmediately",
36048
36266
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
36049
36267
  "ca_certificate": "caCertificate",
36050
36268
  "enable_performance_insights": "enablePerformanceInsights",
@@ -36065,6 +36283,7 @@ class ProvisionedClusterInstanceProps(ClusterInstanceOptions):
36065
36283
  self,
36066
36284
  *,
36067
36285
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
36286
+ apply_immediately: typing.Optional[builtins.bool] = None,
36068
36287
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
36069
36288
  ca_certificate: typing.Optional[CaCertificate] = None,
36070
36289
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -36082,6 +36301,7 @@ class ProvisionedClusterInstanceProps(ClusterInstanceOptions):
36082
36301
  '''Options for creating a provisioned instance.
36083
36302
 
36084
36303
  :param allow_major_version_upgrade: Whether to allow upgrade of major version for the DB instance. Default: - false
36304
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
36085
36305
  :param auto_minor_version_upgrade: Whether to enable automatic upgrade of minor version for the DB instance. Default: - true
36086
36306
  :param ca_certificate: The identifier of the CA certificate for this DB cluster's instances. Specifying or updating this property triggers a reboot. For RDS DB engines: Default: - RDS will choose a certificate authority
36087
36307
  :param enable_performance_insights: Whether to enable Performance Insights for the DB instance. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set.
@@ -36104,23 +36324,18 @@ class ProvisionedClusterInstanceProps(ClusterInstanceOptions):
36104
36324
 
36105
36325
  cluster = rds.DatabaseCluster(self, "Database",
36106
36326
  engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_01_0),
36107
- writer=rds.ClusterInstance.provisioned("writer",
36108
- instance_type=ec2.InstanceType.of(ec2.InstanceClass.R6G, ec2.InstanceSize.XLARGE4)
36327
+ writer=rds.ClusterInstance.provisioned("Instance",
36328
+ instance_type=ec2.InstanceType.of(ec2.InstanceClass.BURSTABLE3, ec2.InstanceSize.SMALL)
36109
36329
  ),
36110
- serverless_v2_min_capacity=6.5,
36111
- serverless_v2_max_capacity=64,
36112
- readers=[
36113
- # will be put in promotion tier 1 and will scale with the writer
36114
- rds.ClusterInstance.serverless_v2("reader1", scale_with_writer=True),
36115
- # will be put in promotion tier 2 and will not scale with the writer
36116
- rds.ClusterInstance.serverless_v2("reader2")
36117
- ],
36330
+ readers=[rds.ClusterInstance.provisioned("reader")],
36331
+ instance_update_behaviour=rds.InstanceUpdateBehaviour.ROLLING, # Optional - defaults to rds.InstanceUpdateBehaviour.BULK
36118
36332
  vpc=vpc
36119
36333
  )
36120
36334
  '''
36121
36335
  if __debug__:
36122
36336
  type_hints = typing.get_type_hints(_typecheckingstub__0d5c78a39da629a585066921d3ee78da795285acdbebe6935198fc9293af7e90)
36123
36337
  check_type(argname="argument allow_major_version_upgrade", value=allow_major_version_upgrade, expected_type=type_hints["allow_major_version_upgrade"])
36338
+ check_type(argname="argument apply_immediately", value=apply_immediately, expected_type=type_hints["apply_immediately"])
36124
36339
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
36125
36340
  check_type(argname="argument ca_certificate", value=ca_certificate, expected_type=type_hints["ca_certificate"])
36126
36341
  check_type(argname="argument enable_performance_insights", value=enable_performance_insights, expected_type=type_hints["enable_performance_insights"])
@@ -36137,6 +36352,8 @@ class ProvisionedClusterInstanceProps(ClusterInstanceOptions):
36137
36352
  self._values: typing.Dict[builtins.str, typing.Any] = {}
36138
36353
  if allow_major_version_upgrade is not None:
36139
36354
  self._values["allow_major_version_upgrade"] = allow_major_version_upgrade
36355
+ if apply_immediately is not None:
36356
+ self._values["apply_immediately"] = apply_immediately
36140
36357
  if auto_minor_version_upgrade is not None:
36141
36358
  self._values["auto_minor_version_upgrade"] = auto_minor_version_upgrade
36142
36359
  if ca_certificate is not None:
@@ -36173,6 +36390,24 @@ class ProvisionedClusterInstanceProps(ClusterInstanceOptions):
36173
36390
  result = self._values.get("allow_major_version_upgrade")
36174
36391
  return typing.cast(typing.Optional[builtins.bool], result)
36175
36392
 
36393
+ @builtins.property
36394
+ def apply_immediately(self) -> typing.Optional[builtins.bool]:
36395
+ '''Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting.
36396
+
36397
+ If set to ``false``, changes are applied during the next maintenance window.
36398
+
36399
+ Until RDS applies the changes, the DB instance remains in a drift state.
36400
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
36401
+
36402
+ This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.
36403
+
36404
+ :default: - Changes will be applied immediately
36405
+
36406
+ :see: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Modifying.html
36407
+ '''
36408
+ result = self._values.get("apply_immediately")
36409
+ return typing.cast(typing.Optional[builtins.bool], result)
36410
+
36176
36411
  @builtins.property
36177
36412
  def auto_minor_version_upgrade(self) -> typing.Optional[builtins.bool]:
36178
36413
  '''Whether to enable automatic upgrade of minor version for the DB instance.
@@ -38274,6 +38509,7 @@ class ServerlessScalingOptions:
38274
38509
  jsii_struct_bases=[ClusterInstanceOptions],
38275
38510
  name_mapping={
38276
38511
  "allow_major_version_upgrade": "allowMajorVersionUpgrade",
38512
+ "apply_immediately": "applyImmediately",
38277
38513
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
38278
38514
  "ca_certificate": "caCertificate",
38279
38515
  "enable_performance_insights": "enablePerformanceInsights",
@@ -38293,6 +38529,7 @@ class ServerlessV2ClusterInstanceProps(ClusterInstanceOptions):
38293
38529
  self,
38294
38530
  *,
38295
38531
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
38532
+ apply_immediately: typing.Optional[builtins.bool] = None,
38296
38533
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
38297
38534
  ca_certificate: typing.Optional[CaCertificate] = None,
38298
38535
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -38309,6 +38546,7 @@ class ServerlessV2ClusterInstanceProps(ClusterInstanceOptions):
38309
38546
  '''Options for creating a serverless v2 instance.
38310
38547
 
38311
38548
  :param allow_major_version_upgrade: Whether to allow upgrade of major version for the DB instance. Default: - false
38549
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
38312
38550
  :param auto_minor_version_upgrade: Whether to enable automatic upgrade of minor version for the DB instance. Default: - true
38313
38551
  :param ca_certificate: The identifier of the CA certificate for this DB cluster's instances. Specifying or updating this property triggers a reboot. For RDS DB engines: Default: - RDS will choose a certificate authority
38314
38552
  :param enable_performance_insights: Whether to enable Performance Insights for the DB instance. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set.
@@ -38344,6 +38582,7 @@ class ServerlessV2ClusterInstanceProps(ClusterInstanceOptions):
38344
38582
  if __debug__:
38345
38583
  type_hints = typing.get_type_hints(_typecheckingstub__c8fd71a155386e8ce12e74b8c5684dfdd43d26e347ef8bbb979e8a2c34f7b38e)
38346
38584
  check_type(argname="argument allow_major_version_upgrade", value=allow_major_version_upgrade, expected_type=type_hints["allow_major_version_upgrade"])
38585
+ check_type(argname="argument apply_immediately", value=apply_immediately, expected_type=type_hints["apply_immediately"])
38347
38586
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
38348
38587
  check_type(argname="argument ca_certificate", value=ca_certificate, expected_type=type_hints["ca_certificate"])
38349
38588
  check_type(argname="argument enable_performance_insights", value=enable_performance_insights, expected_type=type_hints["enable_performance_insights"])
@@ -38359,6 +38598,8 @@ class ServerlessV2ClusterInstanceProps(ClusterInstanceOptions):
38359
38598
  self._values: typing.Dict[builtins.str, typing.Any] = {}
38360
38599
  if allow_major_version_upgrade is not None:
38361
38600
  self._values["allow_major_version_upgrade"] = allow_major_version_upgrade
38601
+ if apply_immediately is not None:
38602
+ self._values["apply_immediately"] = apply_immediately
38362
38603
  if auto_minor_version_upgrade is not None:
38363
38604
  self._values["auto_minor_version_upgrade"] = auto_minor_version_upgrade
38364
38605
  if ca_certificate is not None:
@@ -38393,6 +38634,24 @@ class ServerlessV2ClusterInstanceProps(ClusterInstanceOptions):
38393
38634
  result = self._values.get("allow_major_version_upgrade")
38394
38635
  return typing.cast(typing.Optional[builtins.bool], result)
38395
38636
 
38637
+ @builtins.property
38638
+ def apply_immediately(self) -> typing.Optional[builtins.bool]:
38639
+ '''Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting.
38640
+
38641
+ If set to ``false``, changes are applied during the next maintenance window.
38642
+
38643
+ Until RDS applies the changes, the DB instance remains in a drift state.
38644
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
38645
+
38646
+ This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.
38647
+
38648
+ :default: - Changes will be applied immediately
38649
+
38650
+ :see: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Modifying.html
38651
+ '''
38652
+ result = self._values.get("apply_immediately")
38653
+ return typing.cast(typing.Optional[builtins.bool], result)
38654
+
38396
38655
  @builtins.property
38397
38656
  def auto_minor_version_upgrade(self) -> typing.Optional[builtins.bool]:
38398
38657
  '''Whether to enable automatic upgrade of minor version for the DB instance.
@@ -40415,6 +40674,7 @@ class ClusterInstance(
40415
40674
  instance_type: typing.Optional[_InstanceType_f64915b9] = None,
40416
40675
  promotion_tier: typing.Optional[jsii.Number] = None,
40417
40676
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
40677
+ apply_immediately: typing.Optional[builtins.bool] = None,
40418
40678
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
40419
40679
  ca_certificate: typing.Optional[CaCertificate] = None,
40420
40680
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -40433,6 +40693,7 @@ class ClusterInstance(
40433
40693
  :param instance_type: The cluster instance type. Default: db.t3.medium
40434
40694
  :param promotion_tier: The promotion tier of the cluster instance. Can be between 0-15 For provisioned instances this just determines the failover priority. If multiple instances have the same priority then one will be picked at random Default: 2
40435
40695
  :param allow_major_version_upgrade: Whether to allow upgrade of major version for the DB instance. Default: - false
40696
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
40436
40697
  :param auto_minor_version_upgrade: Whether to enable automatic upgrade of minor version for the DB instance. Default: - true
40437
40698
  :param ca_certificate: The identifier of the CA certificate for this DB cluster's instances. Specifying or updating this property triggers a reboot. For RDS DB engines: Default: - RDS will choose a certificate authority
40438
40699
  :param enable_performance_insights: Whether to enable Performance Insights for the DB instance. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set.
@@ -40458,6 +40719,7 @@ class ClusterInstance(
40458
40719
  instance_type=instance_type,
40459
40720
  promotion_tier=promotion_tier,
40460
40721
  allow_major_version_upgrade=allow_major_version_upgrade,
40722
+ apply_immediately=apply_immediately,
40461
40723
  auto_minor_version_upgrade=auto_minor_version_upgrade,
40462
40724
  ca_certificate=ca_certificate,
40463
40725
  enable_performance_insights=enable_performance_insights,
@@ -40481,6 +40743,7 @@ class ClusterInstance(
40481
40743
  *,
40482
40744
  scale_with_writer: typing.Optional[builtins.bool] = None,
40483
40745
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
40746
+ apply_immediately: typing.Optional[builtins.bool] = None,
40484
40747
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
40485
40748
  ca_certificate: typing.Optional[CaCertificate] = None,
40486
40749
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -40498,6 +40761,7 @@ class ClusterInstance(
40498
40761
  :param id: -
40499
40762
  :param scale_with_writer: Only applicable to reader instances. If this is true then the instance will be placed in promotion tier 1, otherwise it will be placed in promotion tier 2. For serverless v2 instances this means: - true: The serverless v2 reader will scale to match the writer instance (provisioned or serverless) - false: The serverless v2 reader will scale with the read workload on the instance Default: false
40500
40763
  :param allow_major_version_upgrade: Whether to allow upgrade of major version for the DB instance. Default: - false
40764
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
40501
40765
  :param auto_minor_version_upgrade: Whether to enable automatic upgrade of minor version for the DB instance. Default: - true
40502
40766
  :param ca_certificate: The identifier of the CA certificate for this DB cluster's instances. Specifying or updating this property triggers a reboot. For RDS DB engines: Default: - RDS will choose a certificate authority
40503
40767
  :param enable_performance_insights: Whether to enable Performance Insights for the DB instance. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set.
@@ -40522,6 +40786,7 @@ class ClusterInstance(
40522
40786
  props = ServerlessV2ClusterInstanceProps(
40523
40787
  scale_with_writer=scale_with_writer,
40524
40788
  allow_major_version_upgrade=allow_major_version_upgrade,
40789
+ apply_immediately=apply_immediately,
40525
40790
  auto_minor_version_upgrade=auto_minor_version_upgrade,
40526
40791
  ca_certificate=ca_certificate,
40527
40792
  enable_performance_insights=enable_performance_insights,
@@ -42835,6 +43100,7 @@ class DatabaseInstanceFromSnapshot(
42835
43100
  parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
42836
43101
  timezone: typing.Optional[builtins.str] = None,
42837
43102
  vpc: _IVpc_f30d5663,
43103
+ apply_immediately: typing.Optional[builtins.bool] = None,
42838
43104
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
42839
43105
  availability_zone: typing.Optional[builtins.str] = None,
42840
43106
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -42890,6 +43156,7 @@ class DatabaseInstanceFromSnapshot(
42890
43156
  :param parameters: The parameters in the DBParameterGroup to create automatically. You can only specify parameterGroup or parameters but not both. You need to use a versioned engine to auto-generate a DBParameterGroup. Default: - None
42891
43157
  :param timezone: The time zone of the instance. This is currently supported only by Microsoft Sql Server. Default: - RDS default timezone
42892
43158
  :param vpc: The VPC network where the DB subnet group should be created.
43159
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
42893
43160
  :param auto_minor_version_upgrade: Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. Default: true
42894
43161
  :param availability_zone: The name of the Availability Zone where the DB instance will be located. Default: - no preference
42895
43162
  :param backup_retention: The number of days during which automatic DB snapshots are retained. Set to zero to disable backups. When creating a read replica, you must enable automatic backups on the source database instance by setting the backup retention to a value other than zero. Default: - Duration.days(1) for source instances, disabled for read replicas
@@ -42947,6 +43214,7 @@ class DatabaseInstanceFromSnapshot(
42947
43214
  parameters=parameters,
42948
43215
  timezone=timezone,
42949
43216
  vpc=vpc,
43217
+ apply_immediately=apply_immediately,
42950
43218
  auto_minor_version_upgrade=auto_minor_version_upgrade,
42951
43219
  availability_zone=availability_zone,
42952
43220
  backup_retention=backup_retention,
@@ -43192,6 +43460,7 @@ class DatabaseInstanceFromSnapshot(
43192
43460
  jsii_struct_bases=[DatabaseInstanceSourceProps],
43193
43461
  name_mapping={
43194
43462
  "vpc": "vpc",
43463
+ "apply_immediately": "applyImmediately",
43195
43464
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
43196
43465
  "availability_zone": "availabilityZone",
43197
43466
  "backup_retention": "backupRetention",
@@ -43249,6 +43518,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
43249
43518
  self,
43250
43519
  *,
43251
43520
  vpc: _IVpc_f30d5663,
43521
+ apply_immediately: typing.Optional[builtins.bool] = None,
43252
43522
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
43253
43523
  availability_zone: typing.Optional[builtins.str] = None,
43254
43524
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -43303,6 +43573,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
43303
43573
  '''Construction properties for a DatabaseInstanceFromSnapshot.
43304
43574
 
43305
43575
  :param vpc: The VPC network where the DB subnet group should be created.
43576
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
43306
43577
  :param auto_minor_version_upgrade: Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. Default: true
43307
43578
  :param availability_zone: The name of the Availability Zone where the DB instance will be located. Default: - no preference
43308
43579
  :param backup_retention: The number of days during which automatic DB snapshots are retained. Set to zero to disable backups. When creating a read replica, you must enable automatic backups on the source database instance by setting the backup retention to a value other than zero. Default: - Duration.days(1) for source instances, disabled for read replicas
@@ -43382,6 +43653,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
43382
43653
  if __debug__:
43383
43654
  type_hints = typing.get_type_hints(_typecheckingstub__f06d86058a0a7538eb7dbf55de032c8cf05f7fa7b4ab5d5c1d47f761783eaed2)
43384
43655
  check_type(argname="argument vpc", value=vpc, expected_type=type_hints["vpc"])
43656
+ check_type(argname="argument apply_immediately", value=apply_immediately, expected_type=type_hints["apply_immediately"])
43385
43657
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
43386
43658
  check_type(argname="argument availability_zone", value=availability_zone, expected_type=type_hints["availability_zone"])
43387
43659
  check_type(argname="argument backup_retention", value=backup_retention, expected_type=type_hints["backup_retention"])
@@ -43437,6 +43709,8 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
43437
43709
  "engine": engine,
43438
43710
  "snapshot_identifier": snapshot_identifier,
43439
43711
  }
43712
+ if apply_immediately is not None:
43713
+ self._values["apply_immediately"] = apply_immediately
43440
43714
  if auto_minor_version_upgrade is not None:
43441
43715
  self._values["auto_minor_version_upgrade"] = auto_minor_version_upgrade
43442
43716
  if availability_zone is not None:
@@ -43541,6 +43815,24 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
43541
43815
  assert result is not None, "Required property 'vpc' is missing"
43542
43816
  return typing.cast(_IVpc_f30d5663, result)
43543
43817
 
43818
+ @builtins.property
43819
+ def apply_immediately(self) -> typing.Optional[builtins.bool]:
43820
+ '''Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting.
43821
+
43822
+ If set to ``false``, changes are applied during the next maintenance window.
43823
+
43824
+ Until RDS applies the changes, the DB instance remains in a drift state.
43825
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
43826
+
43827
+ This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.
43828
+
43829
+ :default: - Changes will be applied immediately
43830
+
43831
+ :see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html
43832
+ '''
43833
+ result = self._values.get("apply_immediately")
43834
+ return typing.cast(typing.Optional[builtins.bool], result)
43835
+
43544
43836
  @builtins.property
43545
43837
  def auto_minor_version_upgrade(self) -> typing.Optional[builtins.bool]:
43546
43838
  '''Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.
@@ -44114,6 +44406,7 @@ class DatabaseInstanceFromSnapshotProps(DatabaseInstanceSourceProps):
44114
44406
  jsii_struct_bases=[DatabaseInstanceSourceProps],
44115
44407
  name_mapping={
44116
44408
  "vpc": "vpc",
44409
+ "apply_immediately": "applyImmediately",
44117
44410
  "auto_minor_version_upgrade": "autoMinorVersionUpgrade",
44118
44411
  "availability_zone": "availabilityZone",
44119
44412
  "backup_retention": "backupRetention",
@@ -44173,6 +44466,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
44173
44466
  self,
44174
44467
  *,
44175
44468
  vpc: _IVpc_f30d5663,
44469
+ apply_immediately: typing.Optional[builtins.bool] = None,
44176
44470
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
44177
44471
  availability_zone: typing.Optional[builtins.str] = None,
44178
44472
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -44229,6 +44523,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
44229
44523
  '''Construction properties for a DatabaseInstance.
44230
44524
 
44231
44525
  :param vpc: The VPC network where the DB subnet group should be created.
44526
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
44232
44527
  :param auto_minor_version_upgrade: Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. Default: true
44233
44528
  :param availability_zone: The name of the Availability Zone where the DB instance will be located. Default: - no preference
44234
44529
  :param backup_retention: The number of days during which automatic DB snapshots are retained. Set to zero to disable backups. When creating a read replica, you must enable automatic backups on the source database instance by setting the backup retention to a value other than zero. Default: - Duration.days(1) for source instances, disabled for read replicas
@@ -44311,6 +44606,7 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
44311
44606
  if __debug__:
44312
44607
  type_hints = typing.get_type_hints(_typecheckingstub__23675ebe667ec40ba6afd82bf8b65d901cc9a4bfc79be222b108037d5e22396d)
44313
44608
  check_type(argname="argument vpc", value=vpc, expected_type=type_hints["vpc"])
44609
+ check_type(argname="argument apply_immediately", value=apply_immediately, expected_type=type_hints["apply_immediately"])
44314
44610
  check_type(argname="argument auto_minor_version_upgrade", value=auto_minor_version_upgrade, expected_type=type_hints["auto_minor_version_upgrade"])
44315
44611
  check_type(argname="argument availability_zone", value=availability_zone, expected_type=type_hints["availability_zone"])
44316
44612
  check_type(argname="argument backup_retention", value=backup_retention, expected_type=type_hints["backup_retention"])
@@ -44367,6 +44663,8 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
44367
44663
  "vpc": vpc,
44368
44664
  "engine": engine,
44369
44665
  }
44666
+ if apply_immediately is not None:
44667
+ self._values["apply_immediately"] = apply_immediately
44370
44668
  if auto_minor_version_upgrade is not None:
44371
44669
  self._values["auto_minor_version_upgrade"] = auto_minor_version_upgrade
44372
44670
  if availability_zone is not None:
@@ -44477,6 +44775,24 @@ class DatabaseInstanceProps(DatabaseInstanceSourceProps):
44477
44775
  assert result is not None, "Required property 'vpc' is missing"
44478
44776
  return typing.cast(_IVpc_f30d5663, result)
44479
44777
 
44778
+ @builtins.property
44779
+ def apply_immediately(self) -> typing.Optional[builtins.bool]:
44780
+ '''Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting.
44781
+
44782
+ If set to ``false``, changes are applied during the next maintenance window.
44783
+
44784
+ Until RDS applies the changes, the DB instance remains in a drift state.
44785
+ As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state.
44786
+
44787
+ This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group.
44788
+
44789
+ :default: - Changes will be applied immediately
44790
+
44791
+ :see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html
44792
+ '''
44793
+ result = self._values.get("apply_immediately")
44794
+ return typing.cast(typing.Optional[builtins.bool], result)
44795
+
44480
44796
  @builtins.property
44481
44797
  def auto_minor_version_upgrade(self) -> typing.Optional[builtins.bool]:
44482
44798
  '''Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.
@@ -45100,6 +45416,7 @@ class DatabaseInstanceReadReplica(
45100
45416
  storage_encrypted: typing.Optional[builtins.bool] = None,
45101
45417
  storage_encryption_key: typing.Optional[_IKey_5f11635f] = None,
45102
45418
  vpc: _IVpc_f30d5663,
45419
+ apply_immediately: typing.Optional[builtins.bool] = None,
45103
45420
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
45104
45421
  availability_zone: typing.Optional[builtins.str] = None,
45105
45422
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -45150,6 +45467,7 @@ class DatabaseInstanceReadReplica(
45150
45467
  :param storage_encrypted: Indicates whether the DB instance is encrypted. Default: - true if storageEncryptionKey has been provided, false otherwise
45151
45468
  :param storage_encryption_key: The KMS key that's used to encrypt the DB instance. Default: - default master key if storageEncrypted is true, no key otherwise
45152
45469
  :param vpc: The VPC network where the DB subnet group should be created.
45470
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
45153
45471
  :param auto_minor_version_upgrade: Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. Default: true
45154
45472
  :param availability_zone: The name of the Availability Zone where the DB instance will be located. Default: - no preference
45155
45473
  :param backup_retention: The number of days during which automatic DB snapshots are retained. Set to zero to disable backups. When creating a read replica, you must enable automatic backups on the source database instance by setting the backup retention to a value other than zero. Default: - Duration.days(1) for source instances, disabled for read replicas
@@ -45202,6 +45520,7 @@ class DatabaseInstanceReadReplica(
45202
45520
  storage_encrypted=storage_encrypted,
45203
45521
  storage_encryption_key=storage_encryption_key,
45204
45522
  vpc=vpc,
45523
+ apply_immediately=apply_immediately,
45205
45524
  auto_minor_version_upgrade=auto_minor_version_upgrade,
45206
45525
  availability_zone=availability_zone,
45207
45526
  backup_retention=backup_retention,
@@ -46303,6 +46622,7 @@ class DatabaseInstance(
46303
46622
  parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
46304
46623
  timezone: typing.Optional[builtins.str] = None,
46305
46624
  vpc: _IVpc_f30d5663,
46625
+ apply_immediately: typing.Optional[builtins.bool] = None,
46306
46626
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
46307
46627
  availability_zone: typing.Optional[builtins.str] = None,
46308
46628
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -46360,6 +46680,7 @@ class DatabaseInstance(
46360
46680
  :param parameters: The parameters in the DBParameterGroup to create automatically. You can only specify parameterGroup or parameters but not both. You need to use a versioned engine to auto-generate a DBParameterGroup. Default: - None
46361
46681
  :param timezone: The time zone of the instance. This is currently supported only by Microsoft Sql Server. Default: - RDS default timezone
46362
46682
  :param vpc: The VPC network where the DB subnet group should be created.
46683
+ :param apply_immediately: Specifies whether changes to the DB instance and any pending modifications are applied immediately, regardless of the ``preferredMaintenanceWindow`` setting. If set to ``false``, changes are applied during the next maintenance window. Until RDS applies the changes, the DB instance remains in a drift state. As a result, the configuration doesn't fully reflect the requested modifications and temporarily diverges from the intended state. This property also determines whether the DB instance reboots when a static parameter is modified in the associated DB parameter group. Default: - Changes will be applied immediately
46363
46684
  :param auto_minor_version_upgrade: Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. Default: true
46364
46685
  :param availability_zone: The name of the Availability Zone where the DB instance will be located. Default: - no preference
46365
46686
  :param backup_retention: The number of days during which automatic DB snapshots are retained. Set to zero to disable backups. When creating a read replica, you must enable automatic backups on the source database instance by setting the backup retention to a value other than zero. Default: - Duration.days(1) for source instances, disabled for read replicas
@@ -46419,6 +46740,7 @@ class DatabaseInstance(
46419
46740
  parameters=parameters,
46420
46741
  timezone=timezone,
46421
46742
  vpc=vpc,
46743
+ apply_immediately=apply_immediately,
46422
46744
  auto_minor_version_upgrade=auto_minor_version_upgrade,
46423
46745
  availability_zone=availability_zone,
46424
46746
  backup_retention=backup_retention,
@@ -49347,6 +49669,7 @@ def _typecheckingstub__d8ef509fa2a856a5e04875e06fad6792daf0a14797f5d93ddc4c65225
49347
49669
  def _typecheckingstub__8cdde1ea7f85160803079277e8fcc0af34768579c1b17b771033b3c6374858ac(
49348
49670
  *,
49349
49671
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
49672
+ apply_immediately: typing.Optional[builtins.bool] = None,
49350
49673
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
49351
49674
  ca_certificate: typing.Optional[CaCertificate] = None,
49352
49675
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -49365,6 +49688,7 @@ def _typecheckingstub__8cdde1ea7f85160803079277e8fcc0af34768579c1b17b771033b3c63
49365
49688
  def _typecheckingstub__431d59239caf38b9912bfae3130d40eeb8bdb18e013240bac43c980158561c00(
49366
49689
  *,
49367
49690
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
49691
+ apply_immediately: typing.Optional[builtins.bool] = None,
49368
49692
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
49369
49693
  ca_certificate: typing.Optional[CaCertificate] = None,
49370
49694
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -49613,6 +49937,7 @@ def _typecheckingstub__c46002009ab88821e56f6612b8b65e2f4599174816135533fa2342791
49613
49937
  def _typecheckingstub__d110b1cb0043ae6adf59fc0d1bcb136b4655ac973cfbff361a0a3e2fe97c39f8(
49614
49938
  *,
49615
49939
  vpc: _IVpc_f30d5663,
49940
+ apply_immediately: typing.Optional[builtins.bool] = None,
49616
49941
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
49617
49942
  availability_zone: typing.Optional[builtins.str] = None,
49618
49943
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -49660,6 +49985,7 @@ def _typecheckingstub__d110b1cb0043ae6adf59fc0d1bcb136b4655ac973cfbff361a0a3e2fe
49660
49985
  def _typecheckingstub__5508238388ee4afc86f97d5f22fa50578f8a1bdeed9ade8d0210c955bf30718e(
49661
49986
  *,
49662
49987
  vpc: _IVpc_f30d5663,
49988
+ apply_immediately: typing.Optional[builtins.bool] = None,
49663
49989
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
49664
49990
  availability_zone: typing.Optional[builtins.str] = None,
49665
49991
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -49712,6 +50038,7 @@ def _typecheckingstub__5508238388ee4afc86f97d5f22fa50578f8a1bdeed9ade8d0210c955b
49712
50038
  def _typecheckingstub__77d3b41152c4c7a3436d76bad0d83368717917e66a0f0cd849998fcd400f483c(
49713
50039
  *,
49714
50040
  vpc: _IVpc_f30d5663,
50041
+ apply_immediately: typing.Optional[builtins.bool] = None,
49715
50042
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
49716
50043
  availability_zone: typing.Optional[builtins.str] = None,
49717
50044
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -50260,6 +50587,7 @@ def _typecheckingstub__cccb3b43a679627ad9a15217e0512c0119a6907edb0b630119fef187d
50260
50587
  def _typecheckingstub__0d5c78a39da629a585066921d3ee78da795285acdbebe6935198fc9293af7e90(
50261
50588
  *,
50262
50589
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
50590
+ apply_immediately: typing.Optional[builtins.bool] = None,
50263
50591
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
50264
50592
  ca_certificate: typing.Optional[CaCertificate] = None,
50265
50593
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -50499,6 +50827,7 @@ def _typecheckingstub__9a1f89c0c65d19c59a39815eed12ef2c6e9e165d64a4cae0e66976870
50499
50827
  def _typecheckingstub__c8fd71a155386e8ce12e74b8c5684dfdd43d26e347ef8bbb979e8a2c34f7b38e(
50500
50828
  *,
50501
50829
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
50830
+ apply_immediately: typing.Optional[builtins.bool] = None,
50502
50831
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
50503
50832
  ca_certificate: typing.Optional[CaCertificate] = None,
50504
50833
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -50635,6 +50964,7 @@ def _typecheckingstub__d0d2cd14a2c7ed00bfb6fd9860c31cd0b1af1bff8343258b1b4a8d847
50635
50964
  instance_type: typing.Optional[_InstanceType_f64915b9] = None,
50636
50965
  promotion_tier: typing.Optional[jsii.Number] = None,
50637
50966
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
50967
+ apply_immediately: typing.Optional[builtins.bool] = None,
50638
50968
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
50639
50969
  ca_certificate: typing.Optional[CaCertificate] = None,
50640
50970
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -50655,6 +50985,7 @@ def _typecheckingstub__95714f22d2724c29931e2710712a92b10932588d2061fa1ceed93097e
50655
50985
  *,
50656
50986
  scale_with_writer: typing.Optional[builtins.bool] = None,
50657
50987
  allow_major_version_upgrade: typing.Optional[builtins.bool] = None,
50988
+ apply_immediately: typing.Optional[builtins.bool] = None,
50658
50989
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
50659
50990
  ca_certificate: typing.Optional[CaCertificate] = None,
50660
50991
  enable_performance_insights: typing.Optional[builtins.bool] = None,
@@ -50947,6 +51278,7 @@ def _typecheckingstub__dbf7e60a650d0a1bea1826814200716f46cd1f59eea36a42193653d7f
50947
51278
  parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
50948
51279
  timezone: typing.Optional[builtins.str] = None,
50949
51280
  vpc: _IVpc_f30d5663,
51281
+ apply_immediately: typing.Optional[builtins.bool] = None,
50950
51282
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
50951
51283
  availability_zone: typing.Optional[builtins.str] = None,
50952
51284
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -51021,6 +51353,7 @@ def _typecheckingstub__461242b933d96c2475c414109a3d51cfd19b6d911ac2c0e37cb8b34f3
51021
51353
  def _typecheckingstub__f06d86058a0a7538eb7dbf55de032c8cf05f7fa7b4ab5d5c1d47f761783eaed2(
51022
51354
  *,
51023
51355
  vpc: _IVpc_f30d5663,
51356
+ apply_immediately: typing.Optional[builtins.bool] = None,
51024
51357
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
51025
51358
  availability_zone: typing.Optional[builtins.str] = None,
51026
51359
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -51078,6 +51411,7 @@ def _typecheckingstub__f06d86058a0a7538eb7dbf55de032c8cf05f7fa7b4ab5d5c1d47f7617
51078
51411
  def _typecheckingstub__23675ebe667ec40ba6afd82bf8b65d901cc9a4bfc79be222b108037d5e22396d(
51079
51412
  *,
51080
51413
  vpc: _IVpc_f30d5663,
51414
+ apply_immediately: typing.Optional[builtins.bool] = None,
51081
51415
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
51082
51416
  availability_zone: typing.Optional[builtins.str] = None,
51083
51417
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -51144,6 +51478,7 @@ def _typecheckingstub__b2082895d1c502ba05a38a32c44782a7480089cd804d396ed1b41ca4a
51144
51478
  storage_encrypted: typing.Optional[builtins.bool] = None,
51145
51479
  storage_encryption_key: typing.Optional[_IKey_5f11635f] = None,
51146
51480
  vpc: _IVpc_f30d5663,
51481
+ apply_immediately: typing.Optional[builtins.bool] = None,
51147
51482
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
51148
51483
  availability_zone: typing.Optional[builtins.str] = None,
51149
51484
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,
@@ -51369,6 +51704,7 @@ def _typecheckingstub__cb12c4cf0f41b623c75db1c295b846314e730919538b3374019067232
51369
51704
  parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
51370
51705
  timezone: typing.Optional[builtins.str] = None,
51371
51706
  vpc: _IVpc_f30d5663,
51707
+ apply_immediately: typing.Optional[builtins.bool] = None,
51372
51708
  auto_minor_version_upgrade: typing.Optional[builtins.bool] = None,
51373
51709
  availability_zone: typing.Optional[builtins.str] = None,
51374
51710
  backup_retention: typing.Optional[_Duration_4839e8c3] = None,