aws-cdk-lib 2.140.0__py3-none-any.whl → 2.142.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of aws-cdk-lib might be problematic. Click here for more details.

Files changed (49) hide show
  1. aws_cdk/__init__.py +9 -1
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.140.0.jsii.tgz → aws-cdk-lib@2.142.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_appsync/__init__.py +224 -94
  5. aws_cdk/aws_autoscaling/__init__.py +109 -25
  6. aws_cdk/aws_bedrock/__init__.py +51 -41
  7. aws_cdk/aws_cloudfront/__init__.py +34 -78
  8. aws_cdk/aws_cloudtrail/__init__.py +13 -4
  9. aws_cdk/aws_codepipeline/__init__.py +364 -27
  10. aws_cdk/aws_connectcampaigns/__init__.py +2 -2
  11. aws_cdk/aws_datasync/__init__.py +51 -56
  12. aws_cdk/aws_docdb/__init__.py +181 -4
  13. aws_cdk/aws_dynamodb/__init__.py +410 -0
  14. aws_cdk/aws_ec2/__init__.py +91 -42
  15. aws_cdk/aws_ecr/__init__.py +32 -7
  16. aws_cdk/aws_ecs/__init__.py +65 -18
  17. aws_cdk/aws_eks/__init__.py +36 -3
  18. aws_cdk/aws_entityresolution/__init__.py +6 -2
  19. aws_cdk/aws_events/__init__.py +46 -25
  20. aws_cdk/aws_events_targets/__init__.py +341 -0
  21. aws_cdk/aws_fms/__init__.py +7 -7
  22. aws_cdk/aws_gamelift/__init__.py +261 -160
  23. aws_cdk/aws_iam/__init__.py +13 -8
  24. aws_cdk/aws_ivs/__init__.py +1 -3
  25. aws_cdk/aws_kms/__init__.py +11 -5
  26. aws_cdk/aws_lambda_nodejs/__init__.py +3 -0
  27. aws_cdk/aws_location/__init__.py +8 -4
  28. aws_cdk/aws_logs/__init__.py +6 -6
  29. aws_cdk/aws_oam/__init__.py +45 -11
  30. aws_cdk/aws_omics/__init__.py +4 -4
  31. aws_cdk/aws_paymentcryptography/__init__.py +128 -48
  32. aws_cdk/aws_pinpoint/__init__.py +7 -5
  33. aws_cdk/aws_qbusiness/__init__.py +620 -294
  34. aws_cdk/aws_quicksight/__init__.py +103 -40
  35. aws_cdk/aws_rds/__init__.py +80 -16
  36. aws_cdk/aws_route53profiles/__init__.py +49 -49
  37. aws_cdk/aws_s3/__init__.py +9 -2
  38. aws_cdk/aws_sagemaker/__init__.py +30 -30
  39. aws_cdk/aws_servicecatalog/__init__.py +27 -4
  40. aws_cdk/aws_ses/__init__.py +9 -9
  41. aws_cdk/aws_stepfunctions_tasks/__init__.py +7 -6
  42. aws_cdk/aws_transfer/__init__.py +4 -4
  43. aws_cdk/aws_voiceid/__init__.py +2 -2
  44. {aws_cdk_lib-2.140.0.dist-info → aws_cdk_lib-2.142.0.dist-info}/METADATA +10 -2
  45. {aws_cdk_lib-2.140.0.dist-info → aws_cdk_lib-2.142.0.dist-info}/RECORD +49 -49
  46. {aws_cdk_lib-2.140.0.dist-info → aws_cdk_lib-2.142.0.dist-info}/LICENSE +0 -0
  47. {aws_cdk_lib-2.140.0.dist-info → aws_cdk_lib-2.142.0.dist-info}/NOTICE +0 -0
  48. {aws_cdk_lib-2.140.0.dist-info → aws_cdk_lib-2.142.0.dist-info}/WHEEL +0 -0
  49. {aws_cdk_lib-2.140.0.dist-info → aws_cdk_lib-2.142.0.dist-info}/top_level.txt +0 -0
@@ -323,7 +323,7 @@ to use for a cluster instances:
323
323
  cluster = rds.DatabaseCluster(self, "Database",
324
324
  engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_01_0),
325
325
  writer=rds.ClusterInstance.provisioned("writer",
326
- ca_certificate=rds.CaCertificate.RDS_CA_RDS2048_G1
326
+ ca_certificate=rds.CaCertificate.RDS_CA_RSA2048_G1
327
327
  ),
328
328
  readers=[
329
329
  rds.ClusterInstance.serverless_v2("reader",
@@ -696,7 +696,7 @@ to use for the instance:
696
696
  rds.DatabaseInstance(self, "Instance",
697
697
  engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_30),
698
698
  vpc=vpc,
699
- ca_certificate=rds.CaCertificate.RDS_CA_RDS2048_G1
699
+ ca_certificate=rds.CaCertificate.RDS_CA_RSA2048_G1
700
700
  )
701
701
  ```
702
702
 
@@ -1292,6 +1292,7 @@ parameter_group = rds.ParameterGroup(self, "ParameterGroup",
1292
1292
  engine=rds.DatabaseInstanceEngine.sql_server_ee(
1293
1293
  version=rds.SqlServerEngineVersion.VER_11
1294
1294
  ),
1295
+ name="my-parameter-group",
1295
1296
  parameters={
1296
1297
  "locks": "100"
1297
1298
  }
@@ -3439,6 +3440,12 @@ class AuroraPostgresEngineVersion(
3439
3440
  '''Version "16.1".'''
3440
3441
  return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_16_1"))
3441
3442
 
3443
+ @jsii.python.classproperty
3444
+ @jsii.member(jsii_name="VER_16_2")
3445
+ def VER_16_2(cls) -> "AuroraPostgresEngineVersion":
3446
+ '''Version "16.2".'''
3447
+ return typing.cast("AuroraPostgresEngineVersion", jsii.sget(cls, "VER_16_2"))
3448
+
3442
3449
  @jsii.python.classproperty
3443
3450
  @jsii.member(jsii_name="VER_9_6_11")
3444
3451
  def VER_9_6_11(cls) -> "AuroraPostgresEngineVersion":
@@ -3651,10 +3658,16 @@ class CaCertificate(
3651
3658
  # vpc: ec2.Vpc
3652
3659
 
3653
3660
 
3654
- rds.DatabaseInstance(self, "Instance",
3655
- engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_30),
3661
+ cluster = docdb.DatabaseCluster(self, "Database",
3662
+ master_user=docdb.Login(
3663
+ username="myuser"
3664
+ ),
3665
+ instance_type=ec2.InstanceType.of(ec2.InstanceClass.MEMORY5, ec2.InstanceSize.LARGE),
3666
+ vpc_subnets=ec2.SubnetSelection(
3667
+ subnet_type=ec2.SubnetType.PUBLIC
3668
+ ),
3656
3669
  vpc=vpc,
3657
- ca_certificate=rds.CaCertificate.of("future-rds-ca")
3670
+ ca_certificate=docdb.CaCertificate.RDS_CA_RSA4096_G1
3658
3671
  )
3659
3672
  '''
3660
3673
 
@@ -3690,15 +3703,37 @@ class CaCertificate(
3690
3703
  @jsii.python.classproperty
3691
3704
  @jsii.member(jsii_name="RDS_CA_RDS2048_G1")
3692
3705
  def RDS_CA_RDS2048_G1(cls) -> "CaCertificate":
3693
- '''rds-ca-rsa2048-g1 certificate authority.'''
3706
+ '''(deprecated) rds-ca-rsa2048-g1 certificate authority.
3707
+
3708
+ :deprecated: use RDS_CA_RSA2048_G1 (slight misspelling)
3709
+
3710
+ :stability: deprecated
3711
+ '''
3694
3712
  return typing.cast("CaCertificate", jsii.sget(cls, "RDS_CA_RDS2048_G1"))
3695
3713
 
3696
3714
  @jsii.python.classproperty
3697
3715
  @jsii.member(jsii_name="RDS_CA_RDS4096_G1")
3698
3716
  def RDS_CA_RDS4096_G1(cls) -> "CaCertificate":
3699
- '''rds-ca-rsa4096-g1 certificate authority.'''
3717
+ '''(deprecated) rds-ca-rsa4096-g1 certificate authority.
3718
+
3719
+ :deprecated: use RDS_CA_RSA4096_G1 (slight misspelling)
3720
+
3721
+ :stability: deprecated
3722
+ '''
3700
3723
  return typing.cast("CaCertificate", jsii.sget(cls, "RDS_CA_RDS4096_G1"))
3701
3724
 
3725
+ @jsii.python.classproperty
3726
+ @jsii.member(jsii_name="RDS_CA_RSA2048_G1")
3727
+ def RDS_CA_RSA2048_G1(cls) -> "CaCertificate":
3728
+ '''rds-ca-rsa2048-g1 certificate authority.'''
3729
+ return typing.cast("CaCertificate", jsii.sget(cls, "RDS_CA_RSA2048_G1"))
3730
+
3731
+ @jsii.python.classproperty
3732
+ @jsii.member(jsii_name="RDS_CA_RSA4096_G1")
3733
+ def RDS_CA_RSA4096_G1(cls) -> "CaCertificate":
3734
+ '''rds-ca-rsa4096-g1 certificate authority.'''
3735
+ return typing.cast("CaCertificate", jsii.sget(cls, "RDS_CA_RSA4096_G1"))
3736
+
3702
3737
 
3703
3738
  @jsii.implements(_IInspectable_c2943556, _ITaggableV2_4e6798f8)
3704
3739
  class CfnCustomDBEngineVersion(
@@ -4543,7 +4578,7 @@ class CfnDBCluster(
4543
4578
  :param snapshot_identifier: The identifier for the DB snapshot or DB cluster snapshot to restore from. You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB snapshot. After you restore a DB cluster with a ``SnapshotIdentifier`` property, you must specify the same ``SnapshotIdentifier`` property for any future updates to the DB cluster. When you specify this property for an update, the DB cluster is not restored from the snapshot again, and the data in the database is not changed. However, if you don't specify the ``SnapshotIdentifier`` property, an empty DB cluster is created, and the original DB cluster is deleted. If you specify a property that is different from the previous snapshot restore property, a new DB cluster is restored from the specified ``SnapshotIdentifier`` property, and the original DB cluster is deleted. If you specify the ``SnapshotIdentifier`` property to restore a DB cluster (as opposed to specifying it for DB cluster updates), then don't specify the following properties: - ``GlobalClusterIdentifier`` - ``MasterUsername`` - ``MasterUserPassword`` - ``ReplicationSourceIdentifier`` - ``RestoreType`` - ``SourceDBClusterIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an encrypted snapshot) - ``UseLatestRestorableTime`` Constraints: - Must match the identifier of an existing Snapshot. Valid for: Aurora DB clusters and Multi-AZ DB clusters
4544
4579
  :param source_db_cluster_identifier: When restoring a DB cluster to a point in time, the identifier of the source DB cluster from which to restore. Constraints: - Must match the identifier of an existing DBCluster. Valid for: Aurora DB clusters and Multi-AZ DB clusters
4545
4580
  :param source_region: The AWS Region which contains the source DB cluster when replicating a DB cluster. For example, ``us-east-1`` . Valid for: Aurora DB clusters only
4546
- :param storage_encrypted: Indicates whether the DB cluster is encrypted. If you specify the ``KmsKeyId`` property, then you must enable encryption. If you specify the ``SourceDBClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, and if the DB cluster is encrypted, the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot is encrypted, don't specify this property. The value is inherited from the snapshot, and the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot isn't encrypted, you can use this property to specify that the restored DB cluster is encrypted. Specify the ``KmsKeyId`` property for the KMS key to use for encryption. If you don't want the restored DB cluster to be encrypted, then don't set this property or set it to ``false`` . Valid for: Aurora DB clusters and Multi-AZ DB clusters
4581
+ :param storage_encrypted: Indicates whether the DB cluster is encrypted. If you specify the ``KmsKeyId`` property, then you must enable encryption. If you specify the ``SourceDBClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, and if the DB cluster is encrypted, the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot is encrypted, don't specify this property. The value is inherited from the snapshot, and the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot isn't encrypted, you can use this property to specify that the restored DB cluster is encrypted. Specify the ``KmsKeyId`` property for the KMS key to use for encryption. If you don't want the restored DB cluster to be encrypted, then don't set this property or set it to ``false`` . .. epigraph:: If you specify both the ``StorageEncrypted`` and ``SnapshotIdentifier`` properties without specifying the ``KmsKeyId`` property, then the restored DB cluster inherits the encryption settings from the DB snapshot that provide. Valid for: Aurora DB clusters and Multi-AZ DB clusters
4547
4582
  :param storage_type: The storage type to associate with the DB cluster. For information on storage types for Aurora DB clusters, see `Storage configurations for Amazon Aurora DB clusters <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.StorageReliability.html#aurora-storage-type>`_ . For information on storage types for Multi-AZ DB clusters, see `Settings for creating Multi-AZ DB clusters <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/create-multi-az-db-cluster.html#create-multi-az-db-cluster-settings>`_ . This setting is required to create a Multi-AZ DB cluster. When specified for a Multi-AZ DB cluster, a value for the ``Iops`` parameter is required. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - Aurora DB clusters - ``aurora | aurora-iopt1`` - Multi-AZ DB clusters - ``io1 | io2 | gp3`` Default: - Aurora DB clusters - ``aurora`` - Multi-AZ DB clusters - ``io1`` .. epigraph:: When you create an Aurora DB cluster with the storage type set to ``aurora-iopt1`` , the storage type is returned in the response. The storage type isn't returned when you set it to ``aurora`` .
4548
4583
  :param tags: An optional array of key-value pairs to apply to this DB cluster. Valid for: Aurora DB clusters and Multi-AZ DB clusters
4549
4584
  :param use_latest_restorable_time: A value that indicates whether to restore the DB cluster to the latest restorable backup time. By default, the DB cluster is not restored to the latest restorable backup time. Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -6611,7 +6646,7 @@ class CfnDBClusterProps:
6611
6646
  :param snapshot_identifier: The identifier for the DB snapshot or DB cluster snapshot to restore from. You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB snapshot. After you restore a DB cluster with a ``SnapshotIdentifier`` property, you must specify the same ``SnapshotIdentifier`` property for any future updates to the DB cluster. When you specify this property for an update, the DB cluster is not restored from the snapshot again, and the data in the database is not changed. However, if you don't specify the ``SnapshotIdentifier`` property, an empty DB cluster is created, and the original DB cluster is deleted. If you specify a property that is different from the previous snapshot restore property, a new DB cluster is restored from the specified ``SnapshotIdentifier`` property, and the original DB cluster is deleted. If you specify the ``SnapshotIdentifier`` property to restore a DB cluster (as opposed to specifying it for DB cluster updates), then don't specify the following properties: - ``GlobalClusterIdentifier`` - ``MasterUsername`` - ``MasterUserPassword`` - ``ReplicationSourceIdentifier`` - ``RestoreType`` - ``SourceDBClusterIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an encrypted snapshot) - ``UseLatestRestorableTime`` Constraints: - Must match the identifier of an existing Snapshot. Valid for: Aurora DB clusters and Multi-AZ DB clusters
6612
6647
  :param source_db_cluster_identifier: When restoring a DB cluster to a point in time, the identifier of the source DB cluster from which to restore. Constraints: - Must match the identifier of an existing DBCluster. Valid for: Aurora DB clusters and Multi-AZ DB clusters
6613
6648
  :param source_region: The AWS Region which contains the source DB cluster when replicating a DB cluster. For example, ``us-east-1`` . Valid for: Aurora DB clusters only
6614
- :param storage_encrypted: Indicates whether the DB cluster is encrypted. If you specify the ``KmsKeyId`` property, then you must enable encryption. If you specify the ``SourceDBClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, and if the DB cluster is encrypted, the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot is encrypted, don't specify this property. The value is inherited from the snapshot, and the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot isn't encrypted, you can use this property to specify that the restored DB cluster is encrypted. Specify the ``KmsKeyId`` property for the KMS key to use for encryption. If you don't want the restored DB cluster to be encrypted, then don't set this property or set it to ``false`` . Valid for: Aurora DB clusters and Multi-AZ DB clusters
6649
+ :param storage_encrypted: Indicates whether the DB cluster is encrypted. If you specify the ``KmsKeyId`` property, then you must enable encryption. If you specify the ``SourceDBClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, and if the DB cluster is encrypted, the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot is encrypted, don't specify this property. The value is inherited from the snapshot, and the specified ``KmsKeyId`` property is used. If you specify the ``SnapshotIdentifier`` and the specified snapshot isn't encrypted, you can use this property to specify that the restored DB cluster is encrypted. Specify the ``KmsKeyId`` property for the KMS key to use for encryption. If you don't want the restored DB cluster to be encrypted, then don't set this property or set it to ``false`` . .. epigraph:: If you specify both the ``StorageEncrypted`` and ``SnapshotIdentifier`` properties without specifying the ``KmsKeyId`` property, then the restored DB cluster inherits the encryption settings from the DB snapshot that provide. Valid for: Aurora DB clusters and Multi-AZ DB clusters
6615
6650
  :param storage_type: The storage type to associate with the DB cluster. For information on storage types for Aurora DB clusters, see `Storage configurations for Amazon Aurora DB clusters <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.StorageReliability.html#aurora-storage-type>`_ . For information on storage types for Multi-AZ DB clusters, see `Settings for creating Multi-AZ DB clusters <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/create-multi-az-db-cluster.html#create-multi-az-db-cluster-settings>`_ . This setting is required to create a Multi-AZ DB cluster. When specified for a Multi-AZ DB cluster, a value for the ``Iops`` parameter is required. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - Aurora DB clusters - ``aurora | aurora-iopt1`` - Multi-AZ DB clusters - ``io1 | io2 | gp3`` Default: - Aurora DB clusters - ``aurora`` - Multi-AZ DB clusters - ``io1`` .. epigraph:: When you create an Aurora DB cluster with the storage type set to ``aurora-iopt1`` , the storage type is returned in the response. The storage type isn't returned when you set it to ``aurora`` .
6616
6651
  :param tags: An optional array of key-value pairs to apply to this DB cluster. Valid for: Aurora DB clusters and Multi-AZ DB clusters
6617
6652
  :param use_latest_restorable_time: A value that indicates whether to restore the DB cluster to the latest restorable backup time. By default, the DB cluster is not restored to the latest restorable backup time. Valid for: Aurora DB clusters and Multi-AZ DB clusters
@@ -7766,6 +7801,9 @@ class CfnDBClusterProps:
7766
7801
  If you specify the ``SnapshotIdentifier`` and the specified snapshot is encrypted, don't specify this property. The value is inherited from the snapshot, and the specified ``KmsKeyId`` property is used.
7767
7802
 
7768
7803
  If you specify the ``SnapshotIdentifier`` and the specified snapshot isn't encrypted, you can use this property to specify that the restored DB cluster is encrypted. Specify the ``KmsKeyId`` property for the KMS key to use for encryption. If you don't want the restored DB cluster to be encrypted, then don't set this property or set it to ``false`` .
7804
+ .. epigraph::
7805
+
7806
+ If you specify both the ``StorageEncrypted`` and ``SnapshotIdentifier`` properties without specifying the ``KmsKeyId`` property, then the restored DB cluster inherits the encryption settings from the DB snapshot that provide.
7769
7807
 
7770
7808
  Valid for: Aurora DB clusters and Multi-AZ DB clusters
7771
7809
 
@@ -8100,7 +8138,7 @@ class CfnDBInstance(
8100
8138
  :param allocated_storage: The amount of storage in gibibytes (GiB) to be initially allocated for the database instance. .. epigraph:: If any value is set in the ``Iops`` parameter, ``AllocatedStorage`` must be at least 100 GiB, which corresponds to the minimum Iops value of 1,000. If you increase the ``Iops`` value (in 1,000 IOPS increments), then you must also increase the ``AllocatedStorage`` value (in 100-GiB increments). *Amazon Aurora* Not applicable. Aurora cluster volumes automatically grow as the amount of data in your database increases, though you are only charged for the space that you use in an Aurora cluster volume. *Db2* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp3): Must be an integer from 20 to 64000. - Provisioned IOPS storage (io1): Must be an integer from 100 to 64000. *MySQL* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): Must be an integer from 20 to 65536. - Provisioned IOPS storage (io1): Must be an integer from 100 to 65536. - Magnetic storage (standard): Must be an integer from 5 to 3072. *MariaDB* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): Must be an integer from 20 to 65536. - Provisioned IOPS storage (io1): Must be an integer from 100 to 65536. - Magnetic storage (standard): Must be an integer from 5 to 3072. *PostgreSQL* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): Must be an integer from 20 to 65536. - Provisioned IOPS storage (io1): Must be an integer from 100 to 65536. - Magnetic storage (standard): Must be an integer from 5 to 3072. *Oracle* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): Must be an integer from 20 to 65536. - Provisioned IOPS storage (io1): Must be an integer from 100 to 65536. - Magnetic storage (standard): Must be an integer from 10 to 3072. *SQL Server* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): - Enterprise and Standard editions: Must be an integer from 20 to 16384. - Web and Express editions: Must be an integer from 20 to 16384. - Provisioned IOPS storage (io1): - Enterprise and Standard editions: Must be an integer from 20 to 16384. - Web and Express editions: Must be an integer from 20 to 16384. - Magnetic storage (standard): - Enterprise and Standard editions: Must be an integer from 20 to 1024. - Web and Express editions: Must be an integer from 20 to 1024.
8101
8139
  :param allow_major_version_upgrade: A value that indicates whether major version upgrades are allowed. Changing this parameter doesn't result in an outage and the change is asynchronously applied as soon as possible. Constraints: Major version upgrades must be allowed when specifying a value for the ``EngineVersion`` parameter that is a different major version than the DB instance's current version.
8102
8140
  :param associated_roles: The AWS Identity and Access Management (IAM) roles associated with the DB instance. *Amazon Aurora* Not applicable. The associated roles are managed by the DB cluster.
8103
- :param automatic_backup_replication_kms_key_id:
8141
+ :param automatic_backup_replication_kms_key_id: The AWS KMS key identifier for encryption of the replicated automated backups. The KMS key ID is the Amazon Resource Name (ARN) for the KMS encryption key in the destination AWS Region , for example, ``arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE`` .
8104
8142
  :param automatic_backup_replication_region: The destination region for the backup replication of the DB instance. For more info, see `Replicating automated backups to another AWS Region <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html>`_ in the *Amazon RDS User Guide* .
8105
8143
  :param auto_minor_version_upgrade: A value that indicates whether minor engine upgrades are applied automatically to the DB instance during the maintenance window. By default, minor engine upgrades are applied automatically.
8106
8144
  :param availability_zone: The Availability Zone (AZ) where the database will be created. For information on AWS Regions and Availability Zones, see `Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ . For Amazon Aurora, each Aurora DB cluster hosts copies of its storage in three separate Availability Zones. Specify one of these Availability Zones. Aurora automatically chooses an appropriate Availability Zone if you don't specify one. Default: A random, system-chosen Availability Zone in the endpoint's AWS Region . Constraints: - The ``AvailabilityZone`` parameter can't be specified if the DB instance is a Multi-AZ deployment. - The specified Availability Zone must be in the same AWS Region as the current endpoint. Example: ``us-east-1d``
@@ -8170,7 +8208,7 @@ class CfnDBInstance(
8170
8208
  :param tags: An optional array of key-value pairs to apply to this DB instance.
8171
8209
  :param tde_credential_arn:
8172
8210
  :param tde_credential_password:
8173
- :param timezone: The time zone of the DB instance. The time zone parameter is currently supported only by `Microsoft SQL Server <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.TimeZone>`_ .
8211
+ :param timezone: The time zone of the DB instance. The time zone parameter is currently supported only by `RDS for Db2 <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-time-zone>`_ and `RDS for SQL Server <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.TimeZone>`_ .
8174
8212
  :param use_default_processor_features: Specifies whether the DB instance class of the DB instance uses its default processor features. This setting doesn't apply to RDS Custom DB instances.
8175
8213
  :param use_latest_restorable_time: Specifies whether the DB instance is restored from the latest backup time. By default, the DB instance isn't restored from the latest backup time. Constraints: - Can't be specified if the ``RestoreTime`` parameter is provided.
8176
8214
  :param vpc_security_groups: A list of the VPC security group IDs to assign to the DB instance. The list can include both the physical IDs of existing VPC security groups and references to `AWS::EC2::SecurityGroup <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html>`_ resources created in the template. If you plan to update the resource, don't specify VPC security groups in a shared VPC. If you set ``VPCSecurityGroups`` , you must not set ```DBSecurityGroups`` <https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-dbsecuritygroups>`_ , and vice versa. .. epigraph:: You can migrate a DB instance in your stack from an RDS DB security group to a VPC security group, but keep the following in mind: - You can't revert to using an RDS security group after you establish a VPC security group membership. - When you migrate your DB instance to VPC security groups, if your stack update rolls back because the DB instance update fails or because an update fails in another AWS CloudFormation resource, the rollback fails because it can't revert to an RDS security group. - To use the properties that are available when you use a VPC security group, you must recreate the DB instance. If you don't, AWS CloudFormation submits only the property values that are listed in the ```DBSecurityGroups`` <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-dbsecuritygroups>`_ property. To avoid this situation, migrate your DB instance to using VPC security groups only when that is the only change in your stack template. *Amazon Aurora* Not applicable. The associated list of EC2 VPC security groups is managed by the DB cluster. If specified, the setting must match the DB cluster setting.
@@ -8445,6 +8483,7 @@ class CfnDBInstance(
8445
8483
  @builtins.property
8446
8484
  @jsii.member(jsii_name="automaticBackupReplicationKmsKeyId")
8447
8485
  def automatic_backup_replication_kms_key_id(self) -> typing.Optional[builtins.str]:
8486
+ '''The AWS KMS key identifier for encryption of the replicated automated backups.'''
8448
8487
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "automaticBackupReplicationKmsKeyId"))
8449
8488
 
8450
8489
  @automatic_backup_replication_kms_key_id.setter
@@ -10105,7 +10144,7 @@ class CfnDBInstanceProps:
10105
10144
  :param allocated_storage: The amount of storage in gibibytes (GiB) to be initially allocated for the database instance. .. epigraph:: If any value is set in the ``Iops`` parameter, ``AllocatedStorage`` must be at least 100 GiB, which corresponds to the minimum Iops value of 1,000. If you increase the ``Iops`` value (in 1,000 IOPS increments), then you must also increase the ``AllocatedStorage`` value (in 100-GiB increments). *Amazon Aurora* Not applicable. Aurora cluster volumes automatically grow as the amount of data in your database increases, though you are only charged for the space that you use in an Aurora cluster volume. *Db2* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp3): Must be an integer from 20 to 64000. - Provisioned IOPS storage (io1): Must be an integer from 100 to 64000. *MySQL* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): Must be an integer from 20 to 65536. - Provisioned IOPS storage (io1): Must be an integer from 100 to 65536. - Magnetic storage (standard): Must be an integer from 5 to 3072. *MariaDB* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): Must be an integer from 20 to 65536. - Provisioned IOPS storage (io1): Must be an integer from 100 to 65536. - Magnetic storage (standard): Must be an integer from 5 to 3072. *PostgreSQL* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): Must be an integer from 20 to 65536. - Provisioned IOPS storage (io1): Must be an integer from 100 to 65536. - Magnetic storage (standard): Must be an integer from 5 to 3072. *Oracle* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): Must be an integer from 20 to 65536. - Provisioned IOPS storage (io1): Must be an integer from 100 to 65536. - Magnetic storage (standard): Must be an integer from 10 to 3072. *SQL Server* Constraints to the amount of storage for each storage type are the following: - General Purpose (SSD) storage (gp2): - Enterprise and Standard editions: Must be an integer from 20 to 16384. - Web and Express editions: Must be an integer from 20 to 16384. - Provisioned IOPS storage (io1): - Enterprise and Standard editions: Must be an integer from 20 to 16384. - Web and Express editions: Must be an integer from 20 to 16384. - Magnetic storage (standard): - Enterprise and Standard editions: Must be an integer from 20 to 1024. - Web and Express editions: Must be an integer from 20 to 1024.
10106
10145
  :param allow_major_version_upgrade: A value that indicates whether major version upgrades are allowed. Changing this parameter doesn't result in an outage and the change is asynchronously applied as soon as possible. Constraints: Major version upgrades must be allowed when specifying a value for the ``EngineVersion`` parameter that is a different major version than the DB instance's current version.
10107
10146
  :param associated_roles: The AWS Identity and Access Management (IAM) roles associated with the DB instance. *Amazon Aurora* Not applicable. The associated roles are managed by the DB cluster.
10108
- :param automatic_backup_replication_kms_key_id:
10147
+ :param automatic_backup_replication_kms_key_id: The AWS KMS key identifier for encryption of the replicated automated backups. The KMS key ID is the Amazon Resource Name (ARN) for the KMS encryption key in the destination AWS Region , for example, ``arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE`` .
10109
10148
  :param automatic_backup_replication_region: The destination region for the backup replication of the DB instance. For more info, see `Replicating automated backups to another AWS Region <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html>`_ in the *Amazon RDS User Guide* .
10110
10149
  :param auto_minor_version_upgrade: A value that indicates whether minor engine upgrades are applied automatically to the DB instance during the maintenance window. By default, minor engine upgrades are applied automatically.
10111
10150
  :param availability_zone: The Availability Zone (AZ) where the database will be created. For information on AWS Regions and Availability Zones, see `Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ . For Amazon Aurora, each Aurora DB cluster hosts copies of its storage in three separate Availability Zones. Specify one of these Availability Zones. Aurora automatically chooses an appropriate Availability Zone if you don't specify one. Default: A random, system-chosen Availability Zone in the endpoint's AWS Region . Constraints: - The ``AvailabilityZone`` parameter can't be specified if the DB instance is a Multi-AZ deployment. - The specified Availability Zone must be in the same AWS Region as the current endpoint. Example: ``us-east-1d``
@@ -10175,7 +10214,7 @@ class CfnDBInstanceProps:
10175
10214
  :param tags: An optional array of key-value pairs to apply to this DB instance.
10176
10215
  :param tde_credential_arn:
10177
10216
  :param tde_credential_password:
10178
- :param timezone: The time zone of the DB instance. The time zone parameter is currently supported only by `Microsoft SQL Server <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.TimeZone>`_ .
10217
+ :param timezone: The time zone of the DB instance. The time zone parameter is currently supported only by `RDS for Db2 <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-time-zone>`_ and `RDS for SQL Server <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.TimeZone>`_ .
10179
10218
  :param use_default_processor_features: Specifies whether the DB instance class of the DB instance uses its default processor features. This setting doesn't apply to RDS Custom DB instances.
10180
10219
  :param use_latest_restorable_time: Specifies whether the DB instance is restored from the latest backup time. By default, the DB instance isn't restored from the latest backup time. Constraints: - Can't be specified if the ``RestoreTime`` parameter is provided.
10181
10220
  :param vpc_security_groups: A list of the VPC security group IDs to assign to the DB instance. The list can include both the physical IDs of existing VPC security groups and references to `AWS::EC2::SecurityGroup <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html>`_ resources created in the template. If you plan to update the resource, don't specify VPC security groups in a shared VPC. If you set ``VPCSecurityGroups`` , you must not set ```DBSecurityGroups`` <https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-dbsecuritygroups>`_ , and vice versa. .. epigraph:: You can migrate a DB instance in your stack from an RDS DB security group to a VPC security group, but keep the following in mind: - You can't revert to using an RDS security group after you establish a VPC security group membership. - When you migrate your DB instance to VPC security groups, if your stack update rolls back because the DB instance update fails or because an update fails in another AWS CloudFormation resource, the rollback fails because it can't revert to an RDS security group. - To use the properties that are available when you use a VPC security group, you must recreate the DB instance. If you don't, AWS CloudFormation submits only the property values that are listed in the ```DBSecurityGroups`` <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-dbsecuritygroups>`_ property. To avoid this situation, migrate your DB instance to using VPC security groups only when that is the only change in your stack template. *Amazon Aurora* Not applicable. The associated list of EC2 VPC security groups is managed by the DB cluster. If specified, the setting must match the DB cluster setting.
@@ -10625,7 +10664,10 @@ class CfnDBInstanceProps:
10625
10664
 
10626
10665
  @builtins.property
10627
10666
  def automatic_backup_replication_kms_key_id(self) -> typing.Optional[builtins.str]:
10628
- '''
10667
+ '''The AWS KMS key identifier for encryption of the replicated automated backups.
10668
+
10669
+ The KMS key ID is the Amazon Resource Name (ARN) for the KMS encryption key in the destination AWS Region , for example, ``arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE`` .
10670
+
10629
10671
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-automaticbackupreplicationkmskeyid
10630
10672
  '''
10631
10673
  result = self._values.get("automatic_backup_replication_kms_key_id")
@@ -11967,7 +12009,7 @@ class CfnDBInstanceProps:
11967
12009
  def timezone(self) -> typing.Optional[builtins.str]:
11968
12010
  '''The time zone of the DB instance.
11969
12011
 
11970
- The time zone parameter is currently supported only by `Microsoft SQL Server <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.TimeZone>`_ .
12012
+ The time zone parameter is currently supported only by `RDS for Db2 <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-time-zone>`_ and `RDS for SQL Server <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.TimeZone>`_ .
11971
12013
 
11972
12014
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-timezone
11973
12015
  '''
@@ -31675,6 +31717,7 @@ class ParameterGroup(
31675
31717
  *,
31676
31718
  engine: IEngine,
31677
31719
  description: typing.Optional[builtins.str] = None,
31720
+ name: typing.Optional[builtins.str] = None,
31678
31721
  parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
31679
31722
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
31680
31723
  ) -> None:
@@ -31683,6 +31726,7 @@ class ParameterGroup(
31683
31726
  :param id: -
31684
31727
  :param engine: The database engine for this parameter group.
31685
31728
  :param description: Description for this parameter group. Default: a CDK generated description
31729
+ :param name: The name of this parameter group. Default: - CloudFormation-generated name
31686
31730
  :param parameters: The parameters in this parameter group. Default: - None
31687
31731
  :param removal_policy: The CloudFormation policy to apply when the instance is removed from the stack or replaced during an update. Default: - RemovalPolicy.DESTROY
31688
31732
  '''
@@ -31693,6 +31737,7 @@ class ParameterGroup(
31693
31737
  props = ParameterGroupProps(
31694
31738
  engine=engine,
31695
31739
  description=description,
31740
+ name=name,
31696
31741
  parameters=parameters,
31697
31742
  removal_policy=removal_policy,
31698
31743
  )
@@ -31918,6 +31963,7 @@ class ParameterGroupInstanceConfig:
31918
31963
  name_mapping={
31919
31964
  "engine": "engine",
31920
31965
  "description": "description",
31966
+ "name": "name",
31921
31967
  "parameters": "parameters",
31922
31968
  "removal_policy": "removalPolicy",
31923
31969
  },
@@ -31928,6 +31974,7 @@ class ParameterGroupProps:
31928
31974
  *,
31929
31975
  engine: IEngine,
31930
31976
  description: typing.Optional[builtins.str] = None,
31977
+ name: typing.Optional[builtins.str] = None,
31931
31978
  parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
31932
31979
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
31933
31980
  ) -> None:
@@ -31935,6 +31982,7 @@ class ParameterGroupProps:
31935
31982
 
31936
31983
  :param engine: The database engine for this parameter group.
31937
31984
  :param description: Description for this parameter group. Default: a CDK generated description
31985
+ :param name: The name of this parameter group. Default: - CloudFormation-generated name
31938
31986
  :param parameters: The parameters in this parameter group. Default: - None
31939
31987
  :param removal_policy: The CloudFormation policy to apply when the instance is removed from the stack or replaced during an update. Default: - RemovalPolicy.DESTROY
31940
31988
 
@@ -32020,6 +32068,7 @@ class ParameterGroupProps:
32020
32068
  type_hints = typing.get_type_hints(_typecheckingstub__7e65259e690ac4d6bb43c0be2f64c905b8bd37fdfc8b2aee040374a69c6919c4)
32021
32069
  check_type(argname="argument engine", value=engine, expected_type=type_hints["engine"])
32022
32070
  check_type(argname="argument description", value=description, expected_type=type_hints["description"])
32071
+ check_type(argname="argument name", value=name, expected_type=type_hints["name"])
32023
32072
  check_type(argname="argument parameters", value=parameters, expected_type=type_hints["parameters"])
32024
32073
  check_type(argname="argument removal_policy", value=removal_policy, expected_type=type_hints["removal_policy"])
32025
32074
  self._values: typing.Dict[builtins.str, typing.Any] = {
@@ -32027,6 +32076,8 @@ class ParameterGroupProps:
32027
32076
  }
32028
32077
  if description is not None:
32029
32078
  self._values["description"] = description
32079
+ if name is not None:
32080
+ self._values["name"] = name
32030
32081
  if parameters is not None:
32031
32082
  self._values["parameters"] = parameters
32032
32083
  if removal_policy is not None:
@@ -32048,6 +32099,15 @@ class ParameterGroupProps:
32048
32099
  result = self._values.get("description")
32049
32100
  return typing.cast(typing.Optional[builtins.str], result)
32050
32101
 
32102
+ @builtins.property
32103
+ def name(self) -> typing.Optional[builtins.str]:
32104
+ '''The name of this parameter group.
32105
+
32106
+ :default: - CloudFormation-generated name
32107
+ '''
32108
+ result = self._values.get("name")
32109
+ return typing.cast(typing.Optional[builtins.str], result)
32110
+
32051
32111
  @builtins.property
32052
32112
  def parameters(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
32053
32113
  '''The parameters in this parameter group.
@@ -35565,7 +35625,7 @@ class ServerlessV2ClusterInstanceProps(ClusterInstanceOptions):
35565
35625
  cluster = rds.DatabaseCluster(self, "Database",
35566
35626
  engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_01_0),
35567
35627
  writer=rds.ClusterInstance.provisioned("writer",
35568
- ca_certificate=rds.CaCertificate.RDS_CA_RDS2048_G1
35628
+ ca_certificate=rds.CaCertificate.RDS_CA_RSA2048_G1
35569
35629
  ),
35570
35630
  readers=[
35571
35631
  rds.ClusterInstance.serverless_v2("reader",
@@ -36281,6 +36341,7 @@ class SqlServerEeInstanceEngineProps:
36281
36341
  engine=rds.DatabaseInstanceEngine.sql_server_ee(
36282
36342
  version=rds.SqlServerEngineVersion.VER_11
36283
36343
  ),
36344
+ name="my-parameter-group",
36284
36345
  parameters={
36285
36346
  "locks": "100"
36286
36347
  }
@@ -36335,6 +36396,7 @@ class SqlServerEngineVersion(
36335
36396
  engine=rds.DatabaseInstanceEngine.sql_server_ee(
36336
36397
  version=rds.SqlServerEngineVersion.VER_11
36337
36398
  ),
36399
+ name="my-parameter-group",
36338
36400
  parameters={
36339
36401
  "locks": "100"
36340
36402
  }
@@ -46808,6 +46870,7 @@ def _typecheckingstub__dca000a45931b5c98666d6840c64a03368a633b520e82623c6e257298
46808
46870
  *,
46809
46871
  engine: IEngine,
46810
46872
  description: typing.Optional[builtins.str] = None,
46873
+ name: typing.Optional[builtins.str] = None,
46811
46874
  parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
46812
46875
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
46813
46876
  ) -> None:
@@ -46847,6 +46910,7 @@ def _typecheckingstub__7e65259e690ac4d6bb43c0be2f64c905b8bd37fdfc8b2aee040374a69
46847
46910
  *,
46848
46911
  engine: IEngine,
46849
46912
  description: typing.Optional[builtins.str] = None,
46913
+ name: typing.Optional[builtins.str] = None,
46850
46914
  parameters: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
46851
46915
  removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
46852
46916
  ) -> None: