aws-cdk-lib 2.173.3__py3-none-any.whl → 2.174.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.
- aws_cdk/__init__.py +210 -181
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.173.3.jsii.tgz → aws-cdk-lib@2.174.0.jsii.tgz} +0 -0
- aws_cdk/aws_apigateway/__init__.py +127 -168
- aws_cdk/aws_appconfig/__init__.py +498 -1
- aws_cdk/aws_applicationautoscaling/__init__.py +4 -1
- aws_cdk/aws_appsync/__init__.py +4 -0
- aws_cdk/aws_autoscaling/__init__.py +96 -0
- aws_cdk/aws_batch/__init__.py +1084 -233
- aws_cdk/aws_bedrock/__init__.py +2119 -181
- aws_cdk/aws_cassandra/__init__.py +476 -4
- aws_cdk/aws_cleanrooms/__init__.py +543 -17
- aws_cdk/aws_cloudformation/__init__.py +172 -169
- aws_cdk/aws_cloudfront/__init__.py +773 -26
- aws_cdk/aws_cloudtrail/__init__.py +8 -2
- aws_cdk/aws_codebuild/__init__.py +83 -0
- aws_cdk/aws_codepipeline/__init__.py +2 -1
- aws_cdk/aws_cognito/__init__.py +232 -200
- aws_cdk/aws_connect/__init__.py +187 -36
- aws_cdk/aws_connectcampaignsv2/__init__.py +106 -12
- aws_cdk/aws_databrew/__init__.py +69 -1
- aws_cdk/aws_datasync/__init__.py +33 -28
- aws_cdk/aws_datazone/__init__.py +141 -41
- aws_cdk/aws_dlm/__init__.py +20 -10
- aws_cdk/aws_dms/__init__.py +722 -30
- aws_cdk/aws_dynamodb/__init__.py +76 -4
- aws_cdk/aws_ec2/__init__.py +1233 -65
- aws_cdk/aws_ecr/__init__.py +31 -0
- aws_cdk/aws_ecr_assets/__init__.py +5 -0
- aws_cdk/aws_ecs/__init__.py +88 -11
- aws_cdk/aws_efs/__init__.py +15 -8
- aws_cdk/aws_eks/__init__.py +114 -45
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +2 -2
- aws_cdk/aws_emrserverless/__init__.py +143 -0
- aws_cdk/aws_events/__init__.py +50 -30
- aws_cdk/aws_fis/__init__.py +33 -33
- aws_cdk/aws_fsx/__init__.py +20 -10
- aws_cdk/aws_glue/__init__.py +34 -11
- aws_cdk/aws_greengrass/__init__.py +8 -8
- aws_cdk/aws_guardduty/__init__.py +1 -1
- aws_cdk/aws_imagebuilder/__init__.py +45 -47
- aws_cdk/aws_internetmonitor/__init__.py +3 -3
- aws_cdk/aws_invoicing/__init__.py +55 -30
- aws_cdk/aws_iot/__init__.py +1117 -4
- aws_cdk/aws_iot1click/__init__.py +17 -7
- aws_cdk/aws_kendra/__init__.py +4 -6
- aws_cdk/aws_lambda/__init__.py +15 -1
- aws_cdk/aws_logs/__init__.py +4011 -86
- aws_cdk/aws_m2/__init__.py +41 -0
- aws_cdk/aws_mediaconnect/__init__.py +202 -7
- aws_cdk/aws_memorydb/__init__.py +22 -22
- aws_cdk/aws_networkmanager/__init__.py +758 -0
- aws_cdk/aws_opensearchservice/__init__.py +222 -0
- aws_cdk/aws_organizations/__init__.py +5 -3
- aws_cdk/aws_pcs/__init__.py +3038 -0
- aws_cdk/aws_pipes/__init__.py +10 -10
- aws_cdk/aws_qbusiness/__init__.py +415 -140
- aws_cdk/aws_quicksight/__init__.py +15932 -6448
- aws_cdk/aws_ram/__init__.py +5 -11
- aws_cdk/aws_rbin/__init__.py +28 -16
- aws_cdk/aws_rds/__init__.py +184 -24
- aws_cdk/aws_redshiftserverless/__init__.py +156 -0
- aws_cdk/aws_resiliencehub/__init__.py +2 -1
- aws_cdk/aws_route53_targets/__init__.py +5 -5
- aws_cdk/aws_s3/__init__.py +25 -15
- aws_cdk/aws_s3express/__init__.py +7 -7
- aws_cdk/aws_s3tables/__init__.py +683 -0
- aws_cdk/aws_sagemaker/__init__.py +574 -189
- aws_cdk/aws_secretsmanager/__init__.py +2 -0
- aws_cdk/aws_securityhub/__init__.py +41 -165
- aws_cdk/aws_servicediscovery/__init__.py +10 -3
- aws_cdk/aws_ses/__init__.py +190 -5
- aws_cdk/aws_sns/__init__.py +7 -3
- aws_cdk/aws_synthetics/__init__.py +29 -4
- aws_cdk/aws_transfer/__init__.py +8 -0
- aws_cdk/aws_vpclattice/__init__.py +147 -77
- aws_cdk/aws_wafv2/__init__.py +20 -8
- aws_cdk/aws_wisdom/__init__.py +162 -111
- aws_cdk/aws_workspaces/__init__.py +10 -4
- aws_cdk/cloud_assembly_schema/__init__.py +22 -0
- aws_cdk/custom_resources/__init__.py +31 -0
- aws_cdk/cx_api/__init__.py +19 -0
- {aws_cdk_lib-2.173.3.dist-info → aws_cdk_lib-2.174.0.dist-info}/LICENSE +1 -1
- {aws_cdk_lib-2.173.3.dist-info → aws_cdk_lib-2.174.0.dist-info}/METADATA +2 -2
- {aws_cdk_lib-2.173.3.dist-info → aws_cdk_lib-2.174.0.dist-info}/NOTICE +1 -1
- {aws_cdk_lib-2.173.3.dist-info → aws_cdk_lib-2.174.0.dist-info}/RECORD +88 -86
- {aws_cdk_lib-2.173.3.dist-info → aws_cdk_lib-2.174.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.173.3.dist-info → aws_cdk_lib-2.174.0.dist-info}/top_level.txt +0 -0
aws_cdk/aws_rds/__init__.py
CHANGED
|
@@ -4895,6 +4895,7 @@ class CfnDBCluster(
|
|
|
4895
4895
|
backup_retention_period=123,
|
|
4896
4896
|
cluster_scalability_type="clusterScalabilityType",
|
|
4897
4897
|
copy_tags_to_snapshot=False,
|
|
4898
|
+
database_insights_mode="databaseInsightsMode",
|
|
4898
4899
|
database_name="databaseName",
|
|
4899
4900
|
db_cluster_identifier="dbClusterIdentifier",
|
|
4900
4901
|
db_cluster_instance_class="dbClusterInstanceClass",
|
|
@@ -4947,7 +4948,8 @@ class CfnDBCluster(
|
|
|
4947
4948
|
),
|
|
4948
4949
|
serverless_v2_scaling_configuration=rds.CfnDBCluster.ServerlessV2ScalingConfigurationProperty(
|
|
4949
4950
|
max_capacity=123,
|
|
4950
|
-
min_capacity=123
|
|
4951
|
+
min_capacity=123,
|
|
4952
|
+
seconds_until_auto_pause=123
|
|
4951
4953
|
),
|
|
4952
4954
|
snapshot_identifier="snapshotIdentifier",
|
|
4953
4955
|
source_db_cluster_identifier="sourceDbClusterIdentifier",
|
|
@@ -4976,6 +4978,7 @@ class CfnDBCluster(
|
|
|
4976
4978
|
backup_retention_period: typing.Optional[jsii.Number] = None,
|
|
4977
4979
|
cluster_scalability_type: typing.Optional[builtins.str] = None,
|
|
4978
4980
|
copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
4981
|
+
database_insights_mode: typing.Optional[builtins.str] = None,
|
|
4979
4982
|
database_name: typing.Optional[builtins.str] = None,
|
|
4980
4983
|
db_cluster_identifier: typing.Optional[builtins.str] = None,
|
|
4981
4984
|
db_cluster_instance_class: typing.Optional[builtins.str] = None,
|
|
@@ -5031,12 +5034,13 @@ class CfnDBCluster(
|
|
|
5031
5034
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
5032
5035
|
:param allocated_storage: The amount of storage in gibibytes (GiB) to allocate to each DB instance in the Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only This setting is required to create a Multi-AZ DB cluster.
|
|
5033
5036
|
:param associated_roles: Provides a list of the AWS Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other Amazon Web Services on your behalf. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
5034
|
-
:param auto_minor_version_upgrade: Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. By default, minor engine upgrades are applied automatically. Valid for Cluster Type: Multi-AZ DB
|
|
5037
|
+
:param auto_minor_version_upgrade: Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. By default, minor engine upgrades are applied automatically. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
|
|
5035
5038
|
:param availability_zones: A list of Availability Zones (AZs) where instances in the DB cluster can be created. For information on AWS Regions and Availability Zones, see `Choosing the Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters only
|
|
5036
5039
|
:param backtrack_window: The target backtrack window, in seconds. To disable backtracking, set this value to ``0`` . Valid for Cluster Type: Aurora MySQL DB clusters only Default: ``0`` Constraints: - If specified, this value must be set to a number from 0 to 259,200 (72 hours).
|
|
5037
5040
|
:param backup_retention_period: The number of days for which automated backups are retained. Default: 1 Constraints: - Must be a value from 1 to 35 Valid for: Aurora DB clusters and Multi-AZ DB clusters Default: - 1
|
|
5038
5041
|
:param cluster_scalability_type: Specifies the scalability mode of the Aurora DB cluster. When set to ``limitless`` , the cluster operates as an Aurora Limitless Database, allowing you to create a DB shard group for horizontal scaling (sharding) capabilities. When set to ``standard`` (the default), the cluster uses normal DB instance creation.
|
|
5039
5042
|
:param copy_tags_to_snapshot: A value that indicates whether to copy all tags from the DB cluster to snapshots of the DB cluster. The default is not to copy them. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
5043
|
+
:param database_insights_mode: The mode of Database Insights to enable for the DB cluster. If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465. Valid for Cluster Type: Aurora DB clusters only
|
|
5040
5044
|
:param database_name: The name of your database. If you don't provide a name, then Amazon RDS won't create a database in this DB cluster. For naming constraints, see `Naming Constraints <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_Limits.html#RDS_Limits.Constraints>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
5041
5045
|
:param db_cluster_identifier: The DB cluster identifier. This parameter is stored as a lowercase string. Constraints: - Must contain from 1 to 63 letters, numbers, or hyphens. - First character must be a letter. - Can't end with a hyphen or contain two consecutive hyphens. Example: ``my-cluster1`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
5042
5046
|
:param db_cluster_instance_class: The compute and memory capacity of each DB instance in the Multi-AZ DB cluster, for example ``db.m6gd.xlarge`` . Not all DB instance classes are available in all AWS Regions , or for all database engines. For the full list of DB instance classes and availability for your engine, see `DB instance class <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html>`_ in the *Amazon RDS User Guide* . This setting is required to create a Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only
|
|
@@ -5062,13 +5066,13 @@ class CfnDBCluster(
|
|
|
5062
5066
|
:param manage_master_user_password: Specifies whether to manage the master user password with AWS Secrets Manager. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.* Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Constraints: - Can't manage the master user password with AWS Secrets Manager if ``MasterUserPassword`` is specified.
|
|
5063
5067
|
:param master_username: The name of the master user for the DB cluster. .. epigraph:: If you specify the ``SourceDBClusterIdentifier`` , ``SnapshotIdentifier`` , or ``GlobalClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, the snapshot, or the primary DB cluster for the global database cluster, respectively. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
5064
5068
|
:param master_user_password: The master password for the DB instance. .. epigraph:: If you specify the ``SourceDBClusterIdentifier`` , ``SnapshotIdentifier`` , or ``GlobalClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, the snapshot, or the primary DB cluster for the global database cluster, respectively. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
5065
|
-
:param master_user_secret: The secret managed by RDS in AWS Secrets Manager for the master user password. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
|
|
5066
|
-
:param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off collecting Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` . Valid for Cluster Type: Multi-AZ DB clusters
|
|
5067
|
-
:param monitoring_role_arn: The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example is ``arn:aws:iam:123456789012:role/emaccess`` . For information on creating a monitoring role, see `Setting up and enabling Enhanced Monitoring <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling>`_ in the *Amazon RDS User Guide* . If ``MonitoringInterval`` is set to a value other than ``0`` , supply a ``MonitoringRoleArn`` value. Valid for Cluster Type: Multi-AZ DB clusters
|
|
5069
|
+
:param master_user_secret: The secret managed by RDS in AWS Secrets Manager for the master user password. .. epigraph:: When you restore a DB cluster from a snapshot, Amazon RDS generates a new secret instead of reusing the secret specified in the ``SecretArn`` property. This ensures that the restored DB cluster is securely managed with a dedicated secret. To maintain consistent integration with your application, you might need to update resource configurations to reference the newly created secret. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
|
|
5070
|
+
:param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off collecting Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60`` Default: ``0``
|
|
5071
|
+
:param monitoring_role_arn: The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example is ``arn:aws:iam:123456789012:role/emaccess`` . For information on creating a monitoring role, see `Setting up and enabling Enhanced Monitoring <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling>`_ in the *Amazon RDS User Guide* . If ``MonitoringInterval`` is set to a value other than ``0`` , supply a ``MonitoringRoleArn`` value. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
5068
5072
|
:param network_type: The network type of the DB cluster. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB cluster. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon Aurora User Guide.* Valid for: Aurora DB clusters only
|
|
5069
|
-
:param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Multi-AZ DB clusters
|
|
5070
|
-
:param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Multi-AZ DB clusters
|
|
5071
|
-
:param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Multi-AZ DB clusters
|
|
5073
|
+
:param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
5074
|
+
:param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
5075
|
+
:param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
|
|
5072
5076
|
:param port: The port number on which the DB instances in the DB cluster accept connections. Default: - When ``EngineMode`` is ``provisioned`` , ``3306`` (for both Aurora MySQL and Aurora PostgreSQL) - When ``EngineMode`` is ``serverless`` : - ``3306`` when ``Engine`` is ``aurora`` or ``aurora-mysql`` - ``5432`` when ``Engine`` is ``aurora-postgresql`` .. epigraph:: The ``No interruption`` on update behavior only applies to DB clusters. If you are updating a DB instance, see `Port <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-port>`_ for the AWS::RDS::DBInstance resource. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
5073
5077
|
:param preferred_backup_window: The daily time range during which automated backups are created. For more information, see `Backup Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow>`_ in the *Amazon Aurora User Guide.* Constraints: - Must be in the format ``hh24:mi-hh24:mi`` . - Must be in Universal Coordinated Time (UTC). - Must not conflict with the preferred maintenance window. - Must be at least 30 minutes. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
5074
5078
|
:param preferred_maintenance_window: The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC). Format: ``ddd:hh24:mi-ddd:hh24:mi`` The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week. To see the time blocks available, see `Adjusting the Preferred DB Cluster Maintenance Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora>`_ in the *Amazon Aurora User Guide.* Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun. Constraints: Minimum 30-minute window. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
@@ -5100,6 +5104,7 @@ class CfnDBCluster(
|
|
|
5100
5104
|
backup_retention_period=backup_retention_period,
|
|
5101
5105
|
cluster_scalability_type=cluster_scalability_type,
|
|
5102
5106
|
copy_tags_to_snapshot=copy_tags_to_snapshot,
|
|
5107
|
+
database_insights_mode=database_insights_mode,
|
|
5103
5108
|
database_name=database_name,
|
|
5104
5109
|
db_cluster_identifier=db_cluster_identifier,
|
|
5105
5110
|
db_cluster_instance_class=db_cluster_instance_class,
|
|
@@ -5416,6 +5421,19 @@ class CfnDBCluster(
|
|
|
5416
5421
|
check_type(argname="argument value", value=value, expected_type=type_hints["value"])
|
|
5417
5422
|
jsii.set(self, "copyTagsToSnapshot", value) # pyright: ignore[reportArgumentType]
|
|
5418
5423
|
|
|
5424
|
+
@builtins.property
|
|
5425
|
+
@jsii.member(jsii_name="databaseInsightsMode")
|
|
5426
|
+
def database_insights_mode(self) -> typing.Optional[builtins.str]:
|
|
5427
|
+
'''The mode of Database Insights to enable for the DB cluster.'''
|
|
5428
|
+
return typing.cast(typing.Optional[builtins.str], jsii.get(self, "databaseInsightsMode"))
|
|
5429
|
+
|
|
5430
|
+
@database_insights_mode.setter
|
|
5431
|
+
def database_insights_mode(self, value: typing.Optional[builtins.str]) -> None:
|
|
5432
|
+
if __debug__:
|
|
5433
|
+
type_hints = typing.get_type_hints(_typecheckingstub__95529055a06b2a5642399d211890b3949094262771feb4c9ba4efe7d394d8efa)
|
|
5434
|
+
check_type(argname="argument value", value=value, expected_type=type_hints["value"])
|
|
5435
|
+
jsii.set(self, "databaseInsightsMode", value) # pyright: ignore[reportArgumentType]
|
|
5436
|
+
|
|
5419
5437
|
@builtins.property
|
|
5420
5438
|
@jsii.member(jsii_name="databaseName")
|
|
5421
5439
|
def database_name(self) -> typing.Optional[builtins.str]:
|
|
@@ -6615,7 +6633,11 @@ class CfnDBCluster(
|
|
|
6615
6633
|
@jsii.data_type(
|
|
6616
6634
|
jsii_type="aws-cdk-lib.aws_rds.CfnDBCluster.ServerlessV2ScalingConfigurationProperty",
|
|
6617
6635
|
jsii_struct_bases=[],
|
|
6618
|
-
name_mapping={
|
|
6636
|
+
name_mapping={
|
|
6637
|
+
"max_capacity": "maxCapacity",
|
|
6638
|
+
"min_capacity": "minCapacity",
|
|
6639
|
+
"seconds_until_auto_pause": "secondsUntilAutoPause",
|
|
6640
|
+
},
|
|
6619
6641
|
)
|
|
6620
6642
|
class ServerlessV2ScalingConfigurationProperty:
|
|
6621
6643
|
def __init__(
|
|
@@ -6623,6 +6645,7 @@ class CfnDBCluster(
|
|
|
6623
6645
|
*,
|
|
6624
6646
|
max_capacity: typing.Optional[jsii.Number] = None,
|
|
6625
6647
|
min_capacity: typing.Optional[jsii.Number] = None,
|
|
6648
|
+
seconds_until_auto_pause: typing.Optional[jsii.Number] = None,
|
|
6626
6649
|
) -> None:
|
|
6627
6650
|
'''The ``ServerlessV2ScalingConfiguration`` property type specifies the scaling configuration of an Aurora Serverless V2 DB cluster.
|
|
6628
6651
|
|
|
@@ -6636,6 +6659,7 @@ class CfnDBCluster(
|
|
|
6636
6659
|
|
|
6637
6660
|
:param max_capacity: The maximum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 40, 40.5, 41, and so on. The largest value that you can use is 128. The maximum capacity must be higher than 0.5 ACUs. For more information, see `Choosing the maximum Aurora Serverless v2 capacity setting for a cluster <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.setting-capacity.html#aurora-serverless-v2.max_capacity_considerations>`_ in the *Amazon Aurora User Guide* . Aurora automatically sets certain parameters for Aurora Serverless V2 DB instances to values that depend on the maximum ACU value in the capacity range. When you update the maximum capacity value, the ``ParameterApplyStatus`` value for the DB instance changes to ``pending-reboot`` . You can update the parameter values by rebooting the DB instance after changing the capacity range.
|
|
6638
6661
|
:param min_capacity: The minimum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 8, 8.5, 9, and so on. For Aurora versions that support the Aurora Serverless v2 auto-pause feature, the smallest value that you can use is 0. For versions that don't support Aurora Serverless v2 auto-pause, the smallest value that you can use is 0.5.
|
|
6662
|
+
:param seconds_until_auto_pause: Specifies the number of seconds an Aurora Serverless v2 DB instance must be idle before Aurora attempts to automatically pause it. Specify a value between 300 seconds (five minutes) and 86,400 seconds (one day). The default is 300 seconds.
|
|
6639
6663
|
|
|
6640
6664
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-dbcluster-serverlessv2scalingconfiguration.html
|
|
6641
6665
|
:exampleMetadata: fixture=_generated
|
|
@@ -6648,18 +6672,22 @@ class CfnDBCluster(
|
|
|
6648
6672
|
|
|
6649
6673
|
serverless_v2_scaling_configuration_property = rds.CfnDBCluster.ServerlessV2ScalingConfigurationProperty(
|
|
6650
6674
|
max_capacity=123,
|
|
6651
|
-
min_capacity=123
|
|
6675
|
+
min_capacity=123,
|
|
6676
|
+
seconds_until_auto_pause=123
|
|
6652
6677
|
)
|
|
6653
6678
|
'''
|
|
6654
6679
|
if __debug__:
|
|
6655
6680
|
type_hints = typing.get_type_hints(_typecheckingstub__5a6717af18f7b2b042b74ca423a540eb39f5ae817292b338733c6a3cee2b4284)
|
|
6656
6681
|
check_type(argname="argument max_capacity", value=max_capacity, expected_type=type_hints["max_capacity"])
|
|
6657
6682
|
check_type(argname="argument min_capacity", value=min_capacity, expected_type=type_hints["min_capacity"])
|
|
6683
|
+
check_type(argname="argument seconds_until_auto_pause", value=seconds_until_auto_pause, expected_type=type_hints["seconds_until_auto_pause"])
|
|
6658
6684
|
self._values: typing.Dict[builtins.str, typing.Any] = {}
|
|
6659
6685
|
if max_capacity is not None:
|
|
6660
6686
|
self._values["max_capacity"] = max_capacity
|
|
6661
6687
|
if min_capacity is not None:
|
|
6662
6688
|
self._values["min_capacity"] = min_capacity
|
|
6689
|
+
if seconds_until_auto_pause is not None:
|
|
6690
|
+
self._values["seconds_until_auto_pause"] = seconds_until_auto_pause
|
|
6663
6691
|
|
|
6664
6692
|
@builtins.property
|
|
6665
6693
|
def max_capacity(self) -> typing.Optional[jsii.Number]:
|
|
@@ -6687,6 +6715,17 @@ class CfnDBCluster(
|
|
|
6687
6715
|
result = self._values.get("min_capacity")
|
|
6688
6716
|
return typing.cast(typing.Optional[jsii.Number], result)
|
|
6689
6717
|
|
|
6718
|
+
@builtins.property
|
|
6719
|
+
def seconds_until_auto_pause(self) -> typing.Optional[jsii.Number]:
|
|
6720
|
+
'''Specifies the number of seconds an Aurora Serverless v2 DB instance must be idle before Aurora attempts to automatically pause it.
|
|
6721
|
+
|
|
6722
|
+
Specify a value between 300 seconds (five minutes) and 86,400 seconds (one day). The default is 300 seconds.
|
|
6723
|
+
|
|
6724
|
+
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-dbcluster-serverlessv2scalingconfiguration.html#cfn-rds-dbcluster-serverlessv2scalingconfiguration-secondsuntilautopause
|
|
6725
|
+
'''
|
|
6726
|
+
result = self._values.get("seconds_until_auto_pause")
|
|
6727
|
+
return typing.cast(typing.Optional[jsii.Number], result)
|
|
6728
|
+
|
|
6690
6729
|
def __eq__(self, rhs: typing.Any) -> builtins.bool:
|
|
6691
6730
|
return isinstance(rhs, self.__class__) and rhs._values == self._values
|
|
6692
6731
|
|
|
@@ -7070,6 +7109,7 @@ class CfnDBClusterParameterGroupProps:
|
|
|
7070
7109
|
"backup_retention_period": "backupRetentionPeriod",
|
|
7071
7110
|
"cluster_scalability_type": "clusterScalabilityType",
|
|
7072
7111
|
"copy_tags_to_snapshot": "copyTagsToSnapshot",
|
|
7112
|
+
"database_insights_mode": "databaseInsightsMode",
|
|
7073
7113
|
"database_name": "databaseName",
|
|
7074
7114
|
"db_cluster_identifier": "dbClusterIdentifier",
|
|
7075
7115
|
"db_cluster_instance_class": "dbClusterInstanceClass",
|
|
@@ -7133,6 +7173,7 @@ class CfnDBClusterProps:
|
|
|
7133
7173
|
backup_retention_period: typing.Optional[jsii.Number] = None,
|
|
7134
7174
|
cluster_scalability_type: typing.Optional[builtins.str] = None,
|
|
7135
7175
|
copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
7176
|
+
database_insights_mode: typing.Optional[builtins.str] = None,
|
|
7136
7177
|
database_name: typing.Optional[builtins.str] = None,
|
|
7137
7178
|
db_cluster_identifier: typing.Optional[builtins.str] = None,
|
|
7138
7179
|
db_cluster_instance_class: typing.Optional[builtins.str] = None,
|
|
@@ -7187,12 +7228,13 @@ class CfnDBClusterProps:
|
|
|
7187
7228
|
|
|
7188
7229
|
:param allocated_storage: The amount of storage in gibibytes (GiB) to allocate to each DB instance in the Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only This setting is required to create a Multi-AZ DB cluster.
|
|
7189
7230
|
:param associated_roles: Provides a list of the AWS Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other Amazon Web Services on your behalf. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
7190
|
-
:param auto_minor_version_upgrade: Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. By default, minor engine upgrades are applied automatically. Valid for Cluster Type: Multi-AZ DB
|
|
7231
|
+
:param auto_minor_version_upgrade: Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. By default, minor engine upgrades are applied automatically. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
|
|
7191
7232
|
:param availability_zones: A list of Availability Zones (AZs) where instances in the DB cluster can be created. For information on AWS Regions and Availability Zones, see `Choosing the Regions and Availability Zones <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.RegionsAndAvailabilityZones.html>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters only
|
|
7192
7233
|
:param backtrack_window: The target backtrack window, in seconds. To disable backtracking, set this value to ``0`` . Valid for Cluster Type: Aurora MySQL DB clusters only Default: ``0`` Constraints: - If specified, this value must be set to a number from 0 to 259,200 (72 hours).
|
|
7193
7234
|
:param backup_retention_period: The number of days for which automated backups are retained. Default: 1 Constraints: - Must be a value from 1 to 35 Valid for: Aurora DB clusters and Multi-AZ DB clusters Default: - 1
|
|
7194
7235
|
:param cluster_scalability_type: Specifies the scalability mode of the Aurora DB cluster. When set to ``limitless`` , the cluster operates as an Aurora Limitless Database, allowing you to create a DB shard group for horizontal scaling (sharding) capabilities. When set to ``standard`` (the default), the cluster uses normal DB instance creation.
|
|
7195
7236
|
:param copy_tags_to_snapshot: A value that indicates whether to copy all tags from the DB cluster to snapshots of the DB cluster. The default is not to copy them. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
7237
|
+
:param database_insights_mode: The mode of Database Insights to enable for the DB cluster. If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465. Valid for Cluster Type: Aurora DB clusters only
|
|
7196
7238
|
:param database_name: The name of your database. If you don't provide a name, then Amazon RDS won't create a database in this DB cluster. For naming constraints, see `Naming Constraints <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_Limits.html#RDS_Limits.Constraints>`_ in the *Amazon Aurora User Guide* . Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
7197
7239
|
:param db_cluster_identifier: The DB cluster identifier. This parameter is stored as a lowercase string. Constraints: - Must contain from 1 to 63 letters, numbers, or hyphens. - First character must be a letter. - Can't end with a hyphen or contain two consecutive hyphens. Example: ``my-cluster1`` Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
7198
7240
|
:param db_cluster_instance_class: The compute and memory capacity of each DB instance in the Multi-AZ DB cluster, for example ``db.m6gd.xlarge`` . Not all DB instance classes are available in all AWS Regions , or for all database engines. For the full list of DB instance classes and availability for your engine, see `DB instance class <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html>`_ in the *Amazon RDS User Guide* . This setting is required to create a Multi-AZ DB cluster. Valid for Cluster Type: Multi-AZ DB clusters only
|
|
@@ -7218,13 +7260,13 @@ class CfnDBClusterProps:
|
|
|
7218
7260
|
:param manage_master_user_password: Specifies whether to manage the master user password with AWS Secrets Manager. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.* Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Constraints: - Can't manage the master user password with AWS Secrets Manager if ``MasterUserPassword`` is specified.
|
|
7219
7261
|
:param master_username: The name of the master user for the DB cluster. .. epigraph:: If you specify the ``SourceDBClusterIdentifier`` , ``SnapshotIdentifier`` , or ``GlobalClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, the snapshot, or the primary DB cluster for the global database cluster, respectively. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
7220
7262
|
:param master_user_password: The master password for the DB instance. .. epigraph:: If you specify the ``SourceDBClusterIdentifier`` , ``SnapshotIdentifier`` , or ``GlobalClusterIdentifier`` property, don't specify this property. The value is inherited from the source DB cluster, the snapshot, or the primary DB cluster for the global database cluster, respectively. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
7221
|
-
:param master_user_secret: The secret managed by RDS in AWS Secrets Manager for the master user password. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
|
|
7222
|
-
:param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off collecting Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` . Valid for Cluster Type: Multi-AZ DB clusters
|
|
7223
|
-
:param monitoring_role_arn: The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example is ``arn:aws:iam:123456789012:role/emaccess`` . For information on creating a monitoring role, see `Setting up and enabling Enhanced Monitoring <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling>`_ in the *Amazon RDS User Guide* . If ``MonitoringInterval`` is set to a value other than ``0`` , supply a ``MonitoringRoleArn`` value. Valid for Cluster Type: Multi-AZ DB clusters
|
|
7263
|
+
:param master_user_secret: The secret managed by RDS in AWS Secrets Manager for the master user password. .. epigraph:: When you restore a DB cluster from a snapshot, Amazon RDS generates a new secret instead of reusing the secret specified in the ``SecretArn`` property. This ensures that the restored DB cluster is securely managed with a dedicated secret. To maintain consistent integration with your application, you might need to update resource configurations to reference the newly created secret. For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
|
|
7264
|
+
:param monitoring_interval: The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off collecting Enhanced Monitoring metrics, specify ``0`` . If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60`` Default: ``0``
|
|
7265
|
+
:param monitoring_role_arn: The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example is ``arn:aws:iam:123456789012:role/emaccess`` . For information on creating a monitoring role, see `Setting up and enabling Enhanced Monitoring <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling>`_ in the *Amazon RDS User Guide* . If ``MonitoringInterval`` is set to a value other than ``0`` , supply a ``MonitoringRoleArn`` value. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
7224
7266
|
:param network_type: The network type of the DB cluster. Valid values: - ``IPV4`` - ``DUAL`` The network type is determined by the ``DBSubnetGroup`` specified for the DB cluster. A ``DBSubnetGroup`` can support only the IPv4 protocol or the IPv4 and IPv6 protocols ( ``DUAL`` ). For more information, see `Working with a DB instance in a VPC <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html>`_ in the *Amazon Aurora User Guide.* Valid for: Aurora DB clusters only
|
|
7225
|
-
:param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Multi-AZ DB clusters
|
|
7226
|
-
:param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Multi-AZ DB clusters
|
|
7227
|
-
:param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Multi-AZ DB clusters
|
|
7267
|
+
:param performance_insights_enabled: Specifies whether to turn on Performance Insights for the DB cluster. For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
7268
|
+
:param performance_insights_kms_key_id: The AWS KMS key identifier for encryption of Performance Insights data. The AWS KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key. If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region . Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
7269
|
+
:param performance_insights_retention_period: The number of days to retain Performance Insights data. Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters Valid Values: - ``7`` - *month* * 31, where *month* is a number of months from 1-23. Examples: ``93`` (3 months * 31), ``341`` (11 months * 31), ``589`` (19 months * 31) - ``731`` Default: ``7`` days If you specify a retention period that isn't valid, such as ``94`` , Amazon RDS issues an error.
|
|
7228
7270
|
:param port: The port number on which the DB instances in the DB cluster accept connections. Default: - When ``EngineMode`` is ``provisioned`` , ``3306`` (for both Aurora MySQL and Aurora PostgreSQL) - When ``EngineMode`` is ``serverless`` : - ``3306`` when ``Engine`` is ``aurora`` or ``aurora-mysql`` - ``5432`` when ``Engine`` is ``aurora-postgresql`` .. epigraph:: The ``No interruption`` on update behavior only applies to DB clusters. If you are updating a DB instance, see `Port <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-port>`_ for the AWS::RDS::DBInstance resource. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
7229
7271
|
:param preferred_backup_window: The daily time range during which automated backups are created. For more information, see `Backup Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow>`_ in the *Amazon Aurora User Guide.* Constraints: - Must be in the format ``hh24:mi-hh24:mi`` . - Must be in Universal Coordinated Time (UTC). - Must not conflict with the preferred maintenance window. - Must be at least 30 minutes. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
7230
7272
|
:param preferred_maintenance_window: The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC). Format: ``ddd:hh24:mi-ddd:hh24:mi`` The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week. To see the time blocks available, see `Adjusting the Preferred DB Cluster Maintenance Window <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora>`_ in the *Amazon Aurora User Guide.* Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun. Constraints: Minimum 30-minute window. Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
|
@@ -7266,6 +7308,7 @@ class CfnDBClusterProps:
|
|
|
7266
7308
|
backup_retention_period=123,
|
|
7267
7309
|
cluster_scalability_type="clusterScalabilityType",
|
|
7268
7310
|
copy_tags_to_snapshot=False,
|
|
7311
|
+
database_insights_mode="databaseInsightsMode",
|
|
7269
7312
|
database_name="databaseName",
|
|
7270
7313
|
db_cluster_identifier="dbClusterIdentifier",
|
|
7271
7314
|
db_cluster_instance_class="dbClusterInstanceClass",
|
|
@@ -7318,7 +7361,8 @@ class CfnDBClusterProps:
|
|
|
7318
7361
|
),
|
|
7319
7362
|
serverless_v2_scaling_configuration=rds.CfnDBCluster.ServerlessV2ScalingConfigurationProperty(
|
|
7320
7363
|
max_capacity=123,
|
|
7321
|
-
min_capacity=123
|
|
7364
|
+
min_capacity=123,
|
|
7365
|
+
seconds_until_auto_pause=123
|
|
7322
7366
|
),
|
|
7323
7367
|
snapshot_identifier="snapshotIdentifier",
|
|
7324
7368
|
source_db_cluster_identifier="sourceDbClusterIdentifier",
|
|
@@ -7343,6 +7387,7 @@ class CfnDBClusterProps:
|
|
|
7343
7387
|
check_type(argname="argument backup_retention_period", value=backup_retention_period, expected_type=type_hints["backup_retention_period"])
|
|
7344
7388
|
check_type(argname="argument cluster_scalability_type", value=cluster_scalability_type, expected_type=type_hints["cluster_scalability_type"])
|
|
7345
7389
|
check_type(argname="argument copy_tags_to_snapshot", value=copy_tags_to_snapshot, expected_type=type_hints["copy_tags_to_snapshot"])
|
|
7390
|
+
check_type(argname="argument database_insights_mode", value=database_insights_mode, expected_type=type_hints["database_insights_mode"])
|
|
7346
7391
|
check_type(argname="argument database_name", value=database_name, expected_type=type_hints["database_name"])
|
|
7347
7392
|
check_type(argname="argument db_cluster_identifier", value=db_cluster_identifier, expected_type=type_hints["db_cluster_identifier"])
|
|
7348
7393
|
check_type(argname="argument db_cluster_instance_class", value=db_cluster_instance_class, expected_type=type_hints["db_cluster_instance_class"])
|
|
@@ -7409,6 +7454,8 @@ class CfnDBClusterProps:
|
|
|
7409
7454
|
self._values["cluster_scalability_type"] = cluster_scalability_type
|
|
7410
7455
|
if copy_tags_to_snapshot is not None:
|
|
7411
7456
|
self._values["copy_tags_to_snapshot"] = copy_tags_to_snapshot
|
|
7457
|
+
if database_insights_mode is not None:
|
|
7458
|
+
self._values["database_insights_mode"] = database_insights_mode
|
|
7412
7459
|
if database_name is not None:
|
|
7413
7460
|
self._values["database_name"] = database_name
|
|
7414
7461
|
if db_cluster_identifier is not None:
|
|
@@ -7544,7 +7591,7 @@ class CfnDBClusterProps:
|
|
|
7544
7591
|
|
|
7545
7592
|
By default, minor engine upgrades are applied automatically.
|
|
7546
7593
|
|
|
7547
|
-
Valid for Cluster Type: Multi-AZ DB
|
|
7594
|
+
Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster
|
|
7548
7595
|
|
|
7549
7596
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-autominorversionupgrade
|
|
7550
7597
|
'''
|
|
@@ -7626,6 +7673,19 @@ class CfnDBClusterProps:
|
|
|
7626
7673
|
result = self._values.get("copy_tags_to_snapshot")
|
|
7627
7674
|
return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
|
|
7628
7675
|
|
|
7676
|
+
@builtins.property
|
|
7677
|
+
def database_insights_mode(self) -> typing.Optional[builtins.str]:
|
|
7678
|
+
'''The mode of Database Insights to enable for the DB cluster.
|
|
7679
|
+
|
|
7680
|
+
If you set this value to ``advanced`` , you must also set the ``PerformanceInsightsEnabled`` parameter to ``true`` and the ``PerformanceInsightsRetentionPeriod`` parameter to 465.
|
|
7681
|
+
|
|
7682
|
+
Valid for Cluster Type: Aurora DB clusters only
|
|
7683
|
+
|
|
7684
|
+
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-databaseinsightsmode
|
|
7685
|
+
'''
|
|
7686
|
+
result = self._values.get("database_insights_mode")
|
|
7687
|
+
return typing.cast(typing.Optional[builtins.str], result)
|
|
7688
|
+
|
|
7629
7689
|
@builtins.property
|
|
7630
7690
|
def database_name(self) -> typing.Optional[builtins.str]:
|
|
7631
7691
|
'''The name of your database.
|
|
@@ -8089,6 +8149,10 @@ class CfnDBClusterProps:
|
|
|
8089
8149
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnDBCluster.MasterUserSecretProperty]]:
|
|
8090
8150
|
'''The secret managed by RDS in AWS Secrets Manager for the master user password.
|
|
8091
8151
|
|
|
8152
|
+
.. epigraph::
|
|
8153
|
+
|
|
8154
|
+
When you restore a DB cluster from a snapshot, Amazon RDS generates a new secret instead of reusing the secret specified in the ``SecretArn`` property. This ensures that the restored DB cluster is securely managed with a dedicated secret. To maintain consistent integration with your application, you might need to update resource configurations to reference the newly created secret.
|
|
8155
|
+
|
|
8092
8156
|
For more information, see `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html>`_ in the *Amazon RDS User Guide* and `Password management with AWS Secrets Manager <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html>`_ in the *Amazon Aurora User Guide.*
|
|
8093
8157
|
|
|
8094
8158
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-masterusersecret
|
|
@@ -8104,7 +8168,7 @@ class CfnDBClusterProps:
|
|
|
8104
8168
|
|
|
8105
8169
|
If ``MonitoringRoleArn`` is specified, also set ``MonitoringInterval`` to a value other than ``0`` .
|
|
8106
8170
|
|
|
8107
|
-
Valid for Cluster Type: Multi-AZ DB clusters
|
|
8171
|
+
Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
8108
8172
|
|
|
8109
8173
|
Valid Values: ``0 | 1 | 5 | 10 | 15 | 30 | 60``
|
|
8110
8174
|
|
|
@@ -8123,7 +8187,7 @@ class CfnDBClusterProps:
|
|
|
8123
8187
|
|
|
8124
8188
|
If ``MonitoringInterval`` is set to a value other than ``0`` , supply a ``MonitoringRoleArn`` value.
|
|
8125
8189
|
|
|
8126
|
-
Valid for Cluster Type: Multi-AZ DB clusters
|
|
8190
|
+
Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
8127
8191
|
|
|
8128
8192
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-monitoringrolearn
|
|
8129
8193
|
'''
|
|
@@ -8158,7 +8222,7 @@ class CfnDBClusterProps:
|
|
|
8158
8222
|
|
|
8159
8223
|
For more information, see `Using Amazon Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html>`_ in the *Amazon RDS User Guide* .
|
|
8160
8224
|
|
|
8161
|
-
Valid for Cluster Type: Multi-AZ DB clusters
|
|
8225
|
+
Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
8162
8226
|
|
|
8163
8227
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-performanceinsightsenabled
|
|
8164
8228
|
'''
|
|
@@ -8173,7 +8237,7 @@ class CfnDBClusterProps:
|
|
|
8173
8237
|
|
|
8174
8238
|
If you don't specify a value for ``PerformanceInsightsKMSKeyId`` , then Amazon RDS uses your default KMS key. There is a default KMS key for your AWS account . Your AWS account has a different default KMS key for each AWS Region .
|
|
8175
8239
|
|
|
8176
|
-
Valid for Cluster Type: Multi-AZ DB clusters
|
|
8240
|
+
Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
8177
8241
|
|
|
8178
8242
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbcluster.html#cfn-rds-dbcluster-performanceinsightskmskeyid
|
|
8179
8243
|
'''
|
|
@@ -8184,7 +8248,7 @@ class CfnDBClusterProps:
|
|
|
8184
8248
|
def performance_insights_retention_period(self) -> typing.Optional[jsii.Number]:
|
|
8185
8249
|
'''The number of days to retain Performance Insights data.
|
|
8186
8250
|
|
|
8187
|
-
Valid for Cluster Type: Multi-AZ DB clusters
|
|
8251
|
+
Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
8188
8252
|
|
|
8189
8253
|
Valid Values:
|
|
8190
8254
|
|
|
@@ -8620,6 +8684,7 @@ class CfnDBInstance(
|
|
|
8620
8684
|
db_security_groups=["dbSecurityGroups"],
|
|
8621
8685
|
db_snapshot_identifier="dbSnapshotIdentifier",
|
|
8622
8686
|
db_subnet_group_name="dbSubnetGroupName",
|
|
8687
|
+
db_system_id="dbSystemId",
|
|
8623
8688
|
dedicated_log_volume=False,
|
|
8624
8689
|
delete_automated_backups=False,
|
|
8625
8690
|
deletion_protection=False,
|
|
@@ -8719,6 +8784,7 @@ class CfnDBInstance(
|
|
|
8719
8784
|
db_security_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
8720
8785
|
db_snapshot_identifier: typing.Optional[builtins.str] = None,
|
|
8721
8786
|
db_subnet_group_name: typing.Optional[builtins.str] = None,
|
|
8787
|
+
db_system_id: typing.Optional[builtins.str] = None,
|
|
8722
8788
|
dedicated_log_volume: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
8723
8789
|
delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
8724
8790
|
deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
@@ -8801,6 +8867,7 @@ class CfnDBInstance(
|
|
|
8801
8867
|
:param db_security_groups: A list of the DB security groups to assign to the DB instance. The list can include both the name of existing DB security groups or references to AWS::RDS::DBSecurityGroup resources created in the template. If you set DBSecurityGroups, you must not set VPCSecurityGroups, and vice versa. Also, note that the DBSecurityGroups property exists only for backwards compatibility with older regions and is no longer recommended for providing security information to an RDS DB instance. Instead, use VPCSecurityGroups. .. epigraph:: If you specify this property, AWS CloudFormation sends only the following properties (if specified) to Amazon RDS during create operations: - ``AllocatedStorage`` - ``AutoMinorVersionUpgrade`` - ``AvailabilityZone`` - ``BackupRetentionPeriod`` - ``CharacterSetName`` - ``DBInstanceClass`` - ``DBName`` - ``DBParameterGroupName`` - ``DBSecurityGroups`` - ``DBSubnetGroupName`` - ``Engine`` - ``EngineVersion`` - ``Iops`` - ``LicenseModel`` - ``MasterUsername`` - ``MasterUserPassword`` - ``MultiAZ`` - ``OptionGroupName`` - ``PreferredBackupWindow`` - ``PreferredMaintenanceWindow`` All other properties are ignored. Specify a virtual private cloud (VPC) security group if you want to submit other properties, such as ``StorageType`` , ``StorageEncrypted`` , or ``KmsKeyId`` . If you're already using the ``DBSecurityGroups`` property, you can't use these other properties by updating your DB instance to use a VPC security group. You must recreate the DB instance.
|
|
8802
8868
|
:param db_snapshot_identifier: The name or Amazon Resource Name (ARN) of the DB snapshot that's used to restore the DB instance. If you're restoring from a shared manual DB snapshot, you must specify the ARN of the snapshot. By specifying this property, you can create a DB instance from the specified DB snapshot. If the ``DBSnapshotIdentifier`` property is an empty string or the ``AWS::RDS::DBInstance`` declaration has no ``DBSnapshotIdentifier`` property, AWS CloudFormation creates a new database. If the property contains a value (other than an empty string), AWS CloudFormation creates a database from the specified snapshot. If a snapshot with the specified name doesn't exist, AWS CloudFormation can't create the database and it rolls back the stack. Some DB instance properties aren't valid when you restore from a snapshot, such as the ``MasterUsername`` and ``MasterUserPassword`` properties. For information about the properties that you can specify, see the ``RestoreDBInstanceFromDBSnapshot`` action in the *Amazon RDS API Reference* . After you restore a DB instance with a ``DBSnapshotIdentifier`` property, you must specify the same ``DBSnapshotIdentifier`` property for any future updates to the DB instance. When you specify this property for an update, the DB instance is not restored from the DB snapshot again, and the data in the database is not changed. However, if you don't specify the ``DBSnapshotIdentifier`` property, an empty DB instance is created, and the original DB instance is deleted. If you specify a property that is different from the previous snapshot restore property, a new DB instance is restored from the specified ``DBSnapshotIdentifier`` property, and the original DB instance is deleted. If you specify the ``DBSnapshotIdentifier`` property to restore a DB instance (as opposed to specifying it for DB instance updates), then don't specify the following properties: - ``CharacterSetName`` - ``DBClusterIdentifier`` - ``DBName`` - ``KmsKeyId`` - ``MasterUsername`` - ``MasterUserPassword`` - ``PromotionTier`` - ``SourceDBInstanceIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an unencrypted snapshot) - ``Timezone`` *Amazon Aurora* Not applicable. Snapshot restore is managed by the DB cluster.
|
|
8803
8869
|
:param db_subnet_group_name: A DB subnet group to associate with the DB instance. If you update this value, the new subnet group must be a subnet group in a new VPC. If there's no DB subnet group, then the DB instance isn't a VPC DB instance. For more information about using Amazon RDS in a VPC, see `Amazon VPC and Amazon RDS <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to Amazon Aurora DB instances. The DB subnet group is managed by the DB cluster. If specified, the setting must match the DB cluster setting.
|
|
8870
|
+
:param db_system_id: The Oracle system identifier (SID), which is the name of the Oracle database instance that manages your database files. In this context, the term "Oracle database instance" refers exclusively to the system global area (SGA) and Oracle background processes. If you don't specify a SID, the value defaults to ``RDSCDB`` . The Oracle SID is also the name of your CDB.
|
|
8804
8871
|
:param dedicated_log_volume: Indicates whether the DB instance has a dedicated log volume (DLV) enabled.
|
|
8805
8872
|
:param delete_automated_backups: A value that indicates whether to remove automated backups immediately after the DB instance is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB instance is deleted. *Amazon Aurora* Not applicable. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the DB cluster are not deleted.
|
|
8806
8873
|
:param deletion_protection: Specifies whether the DB instance has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection isn't enabled. For more information, see `Deleting a DB Instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html>`_ . This setting doesn't apply to Amazon Aurora DB instances. You can enable or disable deletion protection for the DB cluster. For more information, see ``CreateDBCluster`` . DB instances in a DB cluster can be deleted even when deletion protection is enabled for the DB cluster.
|
|
@@ -8885,6 +8952,7 @@ class CfnDBInstance(
|
|
|
8885
8952
|
db_security_groups=db_security_groups,
|
|
8886
8953
|
db_snapshot_identifier=db_snapshot_identifier,
|
|
8887
8954
|
db_subnet_group_name=db_subnet_group_name,
|
|
8955
|
+
db_system_id=db_system_id,
|
|
8888
8956
|
dedicated_log_volume=dedicated_log_volume,
|
|
8889
8957
|
delete_automated_backups=delete_automated_backups,
|
|
8890
8958
|
deletion_protection=deletion_protection,
|
|
@@ -8992,6 +9060,20 @@ class CfnDBInstance(
|
|
|
8992
9060
|
'''
|
|
8993
9061
|
return typing.cast(builtins.str, jsii.get(self, "attrCertificateDetailsValidTill"))
|
|
8994
9062
|
|
|
9063
|
+
@builtins.property
|
|
9064
|
+
@jsii.member(jsii_name="attrDatabaseInsightsMode")
|
|
9065
|
+
def attr_database_insights_mode(self) -> builtins.str:
|
|
9066
|
+
'''The mode of Database Insights to enable for the DB instance.
|
|
9067
|
+
|
|
9068
|
+
This setting only applies to Amazon Aurora DB instances.
|
|
9069
|
+
.. epigraph::
|
|
9070
|
+
|
|
9071
|
+
Currently, this value is inherited from the DB cluster and can't be changed.
|
|
9072
|
+
|
|
9073
|
+
:cloudformationAttribute: DatabaseInsightsMode
|
|
9074
|
+
'''
|
|
9075
|
+
return typing.cast(builtins.str, jsii.get(self, "attrDatabaseInsightsMode"))
|
|
9076
|
+
|
|
8995
9077
|
@builtins.property
|
|
8996
9078
|
@jsii.member(jsii_name="attrDbInstanceArn")
|
|
8997
9079
|
def attr_db_instance_arn(self) -> builtins.str:
|
|
@@ -9419,6 +9501,19 @@ class CfnDBInstance(
|
|
|
9419
9501
|
check_type(argname="argument value", value=value, expected_type=type_hints["value"])
|
|
9420
9502
|
jsii.set(self, "dbSubnetGroupName", value) # pyright: ignore[reportArgumentType]
|
|
9421
9503
|
|
|
9504
|
+
@builtins.property
|
|
9505
|
+
@jsii.member(jsii_name="dbSystemId")
|
|
9506
|
+
def db_system_id(self) -> typing.Optional[builtins.str]:
|
|
9507
|
+
'''The Oracle system identifier (SID), which is the name of the Oracle database instance that manages your database files.'''
|
|
9508
|
+
return typing.cast(typing.Optional[builtins.str], jsii.get(self, "dbSystemId"))
|
|
9509
|
+
|
|
9510
|
+
@db_system_id.setter
|
|
9511
|
+
def db_system_id(self, value: typing.Optional[builtins.str]) -> None:
|
|
9512
|
+
if __debug__:
|
|
9513
|
+
type_hints = typing.get_type_hints(_typecheckingstub__c2bcedc9b98a22e01ebba3d247528b50c6ecfcdf1d1d6193070deed3f0a91242)
|
|
9514
|
+
check_type(argname="argument value", value=value, expected_type=type_hints["value"])
|
|
9515
|
+
jsii.set(self, "dbSystemId", value) # pyright: ignore[reportArgumentType]
|
|
9516
|
+
|
|
9422
9517
|
@builtins.property
|
|
9423
9518
|
@jsii.member(jsii_name="dedicatedLogVolume")
|
|
9424
9519
|
def dedicated_log_volume(
|
|
@@ -10663,6 +10758,7 @@ class CfnDBInstance(
|
|
|
10663
10758
|
"db_security_groups": "dbSecurityGroups",
|
|
10664
10759
|
"db_snapshot_identifier": "dbSnapshotIdentifier",
|
|
10665
10760
|
"db_subnet_group_name": "dbSubnetGroupName",
|
|
10761
|
+
"db_system_id": "dbSystemId",
|
|
10666
10762
|
"dedicated_log_volume": "dedicatedLogVolume",
|
|
10667
10763
|
"delete_automated_backups": "deleteAutomatedBackups",
|
|
10668
10764
|
"deletion_protection": "deletionProtection",
|
|
@@ -10747,6 +10843,7 @@ class CfnDBInstanceProps:
|
|
|
10747
10843
|
db_security_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
10748
10844
|
db_snapshot_identifier: typing.Optional[builtins.str] = None,
|
|
10749
10845
|
db_subnet_group_name: typing.Optional[builtins.str] = None,
|
|
10846
|
+
db_system_id: typing.Optional[builtins.str] = None,
|
|
10750
10847
|
dedicated_log_volume: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
10751
10848
|
delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
10752
10849
|
deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
@@ -10828,6 +10925,7 @@ class CfnDBInstanceProps:
|
|
|
10828
10925
|
:param db_security_groups: A list of the DB security groups to assign to the DB instance. The list can include both the name of existing DB security groups or references to AWS::RDS::DBSecurityGroup resources created in the template. If you set DBSecurityGroups, you must not set VPCSecurityGroups, and vice versa. Also, note that the DBSecurityGroups property exists only for backwards compatibility with older regions and is no longer recommended for providing security information to an RDS DB instance. Instead, use VPCSecurityGroups. .. epigraph:: If you specify this property, AWS CloudFormation sends only the following properties (if specified) to Amazon RDS during create operations: - ``AllocatedStorage`` - ``AutoMinorVersionUpgrade`` - ``AvailabilityZone`` - ``BackupRetentionPeriod`` - ``CharacterSetName`` - ``DBInstanceClass`` - ``DBName`` - ``DBParameterGroupName`` - ``DBSecurityGroups`` - ``DBSubnetGroupName`` - ``Engine`` - ``EngineVersion`` - ``Iops`` - ``LicenseModel`` - ``MasterUsername`` - ``MasterUserPassword`` - ``MultiAZ`` - ``OptionGroupName`` - ``PreferredBackupWindow`` - ``PreferredMaintenanceWindow`` All other properties are ignored. Specify a virtual private cloud (VPC) security group if you want to submit other properties, such as ``StorageType`` , ``StorageEncrypted`` , or ``KmsKeyId`` . If you're already using the ``DBSecurityGroups`` property, you can't use these other properties by updating your DB instance to use a VPC security group. You must recreate the DB instance.
|
|
10829
10926
|
:param db_snapshot_identifier: The name or Amazon Resource Name (ARN) of the DB snapshot that's used to restore the DB instance. If you're restoring from a shared manual DB snapshot, you must specify the ARN of the snapshot. By specifying this property, you can create a DB instance from the specified DB snapshot. If the ``DBSnapshotIdentifier`` property is an empty string or the ``AWS::RDS::DBInstance`` declaration has no ``DBSnapshotIdentifier`` property, AWS CloudFormation creates a new database. If the property contains a value (other than an empty string), AWS CloudFormation creates a database from the specified snapshot. If a snapshot with the specified name doesn't exist, AWS CloudFormation can't create the database and it rolls back the stack. Some DB instance properties aren't valid when you restore from a snapshot, such as the ``MasterUsername`` and ``MasterUserPassword`` properties. For information about the properties that you can specify, see the ``RestoreDBInstanceFromDBSnapshot`` action in the *Amazon RDS API Reference* . After you restore a DB instance with a ``DBSnapshotIdentifier`` property, you must specify the same ``DBSnapshotIdentifier`` property for any future updates to the DB instance. When you specify this property for an update, the DB instance is not restored from the DB snapshot again, and the data in the database is not changed. However, if you don't specify the ``DBSnapshotIdentifier`` property, an empty DB instance is created, and the original DB instance is deleted. If you specify a property that is different from the previous snapshot restore property, a new DB instance is restored from the specified ``DBSnapshotIdentifier`` property, and the original DB instance is deleted. If you specify the ``DBSnapshotIdentifier`` property to restore a DB instance (as opposed to specifying it for DB instance updates), then don't specify the following properties: - ``CharacterSetName`` - ``DBClusterIdentifier`` - ``DBName`` - ``KmsKeyId`` - ``MasterUsername`` - ``MasterUserPassword`` - ``PromotionTier`` - ``SourceDBInstanceIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an unencrypted snapshot) - ``Timezone`` *Amazon Aurora* Not applicable. Snapshot restore is managed by the DB cluster.
|
|
10830
10927
|
:param db_subnet_group_name: A DB subnet group to associate with the DB instance. If you update this value, the new subnet group must be a subnet group in a new VPC. If there's no DB subnet group, then the DB instance isn't a VPC DB instance. For more information about using Amazon RDS in a VPC, see `Amazon VPC and Amazon RDS <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.html>`_ in the *Amazon RDS User Guide* . This setting doesn't apply to Amazon Aurora DB instances. The DB subnet group is managed by the DB cluster. If specified, the setting must match the DB cluster setting.
|
|
10928
|
+
:param db_system_id: The Oracle system identifier (SID), which is the name of the Oracle database instance that manages your database files. In this context, the term "Oracle database instance" refers exclusively to the system global area (SGA) and Oracle background processes. If you don't specify a SID, the value defaults to ``RDSCDB`` . The Oracle SID is also the name of your CDB.
|
|
10831
10929
|
:param dedicated_log_volume: Indicates whether the DB instance has a dedicated log volume (DLV) enabled.
|
|
10832
10930
|
:param delete_automated_backups: A value that indicates whether to remove automated backups immediately after the DB instance is deleted. This parameter isn't case-sensitive. The default is to remove automated backups immediately after the DB instance is deleted. *Amazon Aurora* Not applicable. When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. Manual DB cluster snapshots of the DB cluster are not deleted.
|
|
10833
10931
|
:param deletion_protection: Specifies whether the DB instance has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection isn't enabled. For more information, see `Deleting a DB Instance <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html>`_ . This setting doesn't apply to Amazon Aurora DB instances. You can enable or disable deletion protection for the DB cluster. For more information, see ``CreateDBCluster`` . DB instances in a DB cluster can be deleted even when deletion protection is enabled for the DB cluster.
|
|
@@ -10923,6 +11021,7 @@ class CfnDBInstanceProps:
|
|
|
10923
11021
|
db_security_groups=["dbSecurityGroups"],
|
|
10924
11022
|
db_snapshot_identifier="dbSnapshotIdentifier",
|
|
10925
11023
|
db_subnet_group_name="dbSubnetGroupName",
|
|
11024
|
+
db_system_id="dbSystemId",
|
|
10926
11025
|
dedicated_log_volume=False,
|
|
10927
11026
|
delete_automated_backups=False,
|
|
10928
11027
|
deletion_protection=False,
|
|
@@ -11018,6 +11117,7 @@ class CfnDBInstanceProps:
|
|
|
11018
11117
|
check_type(argname="argument db_security_groups", value=db_security_groups, expected_type=type_hints["db_security_groups"])
|
|
11019
11118
|
check_type(argname="argument db_snapshot_identifier", value=db_snapshot_identifier, expected_type=type_hints["db_snapshot_identifier"])
|
|
11020
11119
|
check_type(argname="argument db_subnet_group_name", value=db_subnet_group_name, expected_type=type_hints["db_subnet_group_name"])
|
|
11120
|
+
check_type(argname="argument db_system_id", value=db_system_id, expected_type=type_hints["db_system_id"])
|
|
11021
11121
|
check_type(argname="argument dedicated_log_volume", value=dedicated_log_volume, expected_type=type_hints["dedicated_log_volume"])
|
|
11022
11122
|
check_type(argname="argument delete_automated_backups", value=delete_automated_backups, expected_type=type_hints["delete_automated_backups"])
|
|
11023
11123
|
check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
|
|
@@ -11120,6 +11220,8 @@ class CfnDBInstanceProps:
|
|
|
11120
11220
|
self._values["db_snapshot_identifier"] = db_snapshot_identifier
|
|
11121
11221
|
if db_subnet_group_name is not None:
|
|
11122
11222
|
self._values["db_subnet_group_name"] = db_subnet_group_name
|
|
11223
|
+
if db_system_id is not None:
|
|
11224
|
+
self._values["db_system_id"] = db_system_id
|
|
11123
11225
|
if dedicated_log_volume is not None:
|
|
11124
11226
|
self._values["dedicated_log_volume"] = dedicated_log_volume
|
|
11125
11227
|
if delete_automated_backups is not None:
|
|
@@ -11733,6 +11835,17 @@ class CfnDBInstanceProps:
|
|
|
11733
11835
|
result = self._values.get("db_subnet_group_name")
|
|
11734
11836
|
return typing.cast(typing.Optional[builtins.str], result)
|
|
11735
11837
|
|
|
11838
|
+
@builtins.property
|
|
11839
|
+
def db_system_id(self) -> typing.Optional[builtins.str]:
|
|
11840
|
+
'''The Oracle system identifier (SID), which is the name of the Oracle database instance that manages your database files.
|
|
11841
|
+
|
|
11842
|
+
In this context, the term "Oracle database instance" refers exclusively to the system global area (SGA) and Oracle background processes. If you don't specify a SID, the value defaults to ``RDSCDB`` . The Oracle SID is also the name of your CDB.
|
|
11843
|
+
|
|
11844
|
+
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html#cfn-rds-dbinstance-dbsystemid
|
|
11845
|
+
'''
|
|
11846
|
+
result = self._values.get("db_system_id")
|
|
11847
|
+
return typing.cast(typing.Optional[builtins.str], result)
|
|
11848
|
+
|
|
11736
11849
|
@builtins.property
|
|
11737
11850
|
def dedicated_log_volume(
|
|
11738
11851
|
self,
|
|
@@ -30488,6 +30601,12 @@ class MariaDbEngineVersion(
|
|
|
30488
30601
|
'''Version "10.11" (only a major version, without a specific minor version).'''
|
|
30489
30602
|
return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_11"))
|
|
30490
30603
|
|
|
30604
|
+
@jsii.python.classproperty
|
|
30605
|
+
@jsii.member(jsii_name="VER_10_11_10")
|
|
30606
|
+
def VER_10_11_10(cls) -> "MariaDbEngineVersion":
|
|
30607
|
+
'''Version "10.11.10".'''
|
|
30608
|
+
return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_11_10"))
|
|
30609
|
+
|
|
30491
30610
|
@jsii.python.classproperty
|
|
30492
30611
|
@jsii.member(jsii_name="VER_10_11_4")
|
|
30493
30612
|
def VER_10_11_4(cls) -> "MariaDbEngineVersion":
|
|
@@ -31087,6 +31206,12 @@ class MariaDbEngineVersion(
|
|
|
31087
31206
|
'''Version "10.5.26".'''
|
|
31088
31207
|
return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_5_26"))
|
|
31089
31208
|
|
|
31209
|
+
@jsii.python.classproperty
|
|
31210
|
+
@jsii.member(jsii_name="VER_10_5_27")
|
|
31211
|
+
def VER_10_5_27(cls) -> "MariaDbEngineVersion":
|
|
31212
|
+
'''Version "10.5.27".'''
|
|
31213
|
+
return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_5_27"))
|
|
31214
|
+
|
|
31090
31215
|
@jsii.python.classproperty
|
|
31091
31216
|
@jsii.member(jsii_name="VER_10_5_8")
|
|
31092
31217
|
def VER_10_5_8(cls) -> "MariaDbEngineVersion":
|
|
@@ -31190,6 +31315,12 @@ class MariaDbEngineVersion(
|
|
|
31190
31315
|
'''Version "10.6.19".'''
|
|
31191
31316
|
return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_6_19"))
|
|
31192
31317
|
|
|
31318
|
+
@jsii.python.classproperty
|
|
31319
|
+
@jsii.member(jsii_name="VER_10_6_20")
|
|
31320
|
+
def VER_10_6_20(cls) -> "MariaDbEngineVersion":
|
|
31321
|
+
'''Version "10.6.20".'''
|
|
31322
|
+
return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_10_6_20"))
|
|
31323
|
+
|
|
31193
31324
|
@jsii.python.classproperty
|
|
31194
31325
|
@jsii.member(jsii_name="VER_10_6_5")
|
|
31195
31326
|
def VER_10_6_5(cls) -> "MariaDbEngineVersion":
|
|
@@ -31229,6 +31360,12 @@ class MariaDbEngineVersion(
|
|
|
31229
31360
|
'''Version "11.4.3".'''
|
|
31230
31361
|
return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_11_4_3"))
|
|
31231
31362
|
|
|
31363
|
+
@jsii.python.classproperty
|
|
31364
|
+
@jsii.member(jsii_name="VER_11_4_4")
|
|
31365
|
+
def VER_11_4_4(cls) -> "MariaDbEngineVersion":
|
|
31366
|
+
'''Version "11.4.4".'''
|
|
31367
|
+
return typing.cast("MariaDbEngineVersion", jsii.sget(cls, "VER_11_4_4"))
|
|
31368
|
+
|
|
31232
31369
|
@builtins.property
|
|
31233
31370
|
@jsii.member(jsii_name="mariaDbFullVersion")
|
|
31234
31371
|
def maria_db_full_version(self) -> builtins.str:
|
|
@@ -34643,6 +34780,12 @@ class PostgresEngineVersion(
|
|
|
34643
34780
|
'''Version "11.22-rds.20240808".'''
|
|
34644
34781
|
return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_11_22_RDS_20240808"))
|
|
34645
34782
|
|
|
34783
|
+
@jsii.python.classproperty
|
|
34784
|
+
@jsii.member(jsii_name="VER_11_22_RDS_20241121")
|
|
34785
|
+
def VER_11_22_RDS_20241121(cls) -> "PostgresEngineVersion":
|
|
34786
|
+
'''Version "11.22-RDS.20241121".'''
|
|
34787
|
+
return typing.cast("PostgresEngineVersion", jsii.sget(cls, "VER_11_22_RDS_20241121"))
|
|
34788
|
+
|
|
34646
34789
|
@jsii.python.classproperty
|
|
34647
34790
|
@jsii.member(jsii_name="VER_11_4")
|
|
34648
34791
|
def VER_11_4(cls) -> "PostgresEngineVersion":
|
|
@@ -46272,6 +46415,7 @@ def _typecheckingstub__1eb14b9dcc306eabcc2963c7b6ef9b87bf8d616bb5691dbc6656242be
|
|
|
46272
46415
|
backup_retention_period: typing.Optional[jsii.Number] = None,
|
|
46273
46416
|
cluster_scalability_type: typing.Optional[builtins.str] = None,
|
|
46274
46417
|
copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
46418
|
+
database_insights_mode: typing.Optional[builtins.str] = None,
|
|
46275
46419
|
database_name: typing.Optional[builtins.str] = None,
|
|
46276
46420
|
db_cluster_identifier: typing.Optional[builtins.str] = None,
|
|
46277
46421
|
db_cluster_instance_class: typing.Optional[builtins.str] = None,
|
|
@@ -46385,6 +46529,12 @@ def _typecheckingstub__7aaebe942bef486fa4f2def6b116a47a3513d6909fa29d9fdd20eb31f
|
|
|
46385
46529
|
"""Type checking stubs"""
|
|
46386
46530
|
pass
|
|
46387
46531
|
|
|
46532
|
+
def _typecheckingstub__95529055a06b2a5642399d211890b3949094262771feb4c9ba4efe7d394d8efa(
|
|
46533
|
+
value: typing.Optional[builtins.str],
|
|
46534
|
+
) -> None:
|
|
46535
|
+
"""Type checking stubs"""
|
|
46536
|
+
pass
|
|
46537
|
+
|
|
46388
46538
|
def _typecheckingstub__133622b74470290a34fd20f1677f713d047e14ddfc8138b0693817c347f0904f(
|
|
46389
46539
|
value: typing.Optional[builtins.str],
|
|
46390
46540
|
) -> None:
|
|
@@ -46726,6 +46876,7 @@ def _typecheckingstub__5a6717af18f7b2b042b74ca423a540eb39f5ae817292b338733c6a3ce
|
|
|
46726
46876
|
*,
|
|
46727
46877
|
max_capacity: typing.Optional[jsii.Number] = None,
|
|
46728
46878
|
min_capacity: typing.Optional[jsii.Number] = None,
|
|
46879
|
+
seconds_until_auto_pause: typing.Optional[jsii.Number] = None,
|
|
46729
46880
|
) -> None:
|
|
46730
46881
|
"""Type checking stubs"""
|
|
46731
46882
|
pass
|
|
@@ -46806,6 +46957,7 @@ def _typecheckingstub__aaf089104646bb0ea95e48cd2107d642585c3eb3785a21112fc029b15
|
|
|
46806
46957
|
backup_retention_period: typing.Optional[jsii.Number] = None,
|
|
46807
46958
|
cluster_scalability_type: typing.Optional[builtins.str] = None,
|
|
46808
46959
|
copy_tags_to_snapshot: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
46960
|
+
database_insights_mode: typing.Optional[builtins.str] = None,
|
|
46809
46961
|
database_name: typing.Optional[builtins.str] = None,
|
|
46810
46962
|
db_cluster_identifier: typing.Optional[builtins.str] = None,
|
|
46811
46963
|
db_cluster_instance_class: typing.Optional[builtins.str] = None,
|
|
@@ -46886,6 +47038,7 @@ def _typecheckingstub__255b0779ca741853674876540bf77279f6293bea05de2cd18724d2b92
|
|
|
46886
47038
|
db_security_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
46887
47039
|
db_snapshot_identifier: typing.Optional[builtins.str] = None,
|
|
46888
47040
|
db_subnet_group_name: typing.Optional[builtins.str] = None,
|
|
47041
|
+
db_system_id: typing.Optional[builtins.str] = None,
|
|
46889
47042
|
dedicated_log_volume: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
46890
47043
|
delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
46891
47044
|
deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
@@ -47095,6 +47248,12 @@ def _typecheckingstub__ee9b5bb70dbab22ab4481a77c04dc86a6cae16b4c7d30ccb17a77b55d
|
|
|
47095
47248
|
"""Type checking stubs"""
|
|
47096
47249
|
pass
|
|
47097
47250
|
|
|
47251
|
+
def _typecheckingstub__c2bcedc9b98a22e01ebba3d247528b50c6ecfcdf1d1d6193070deed3f0a91242(
|
|
47252
|
+
value: typing.Optional[builtins.str],
|
|
47253
|
+
) -> None:
|
|
47254
|
+
"""Type checking stubs"""
|
|
47255
|
+
pass
|
|
47256
|
+
|
|
47098
47257
|
def _typecheckingstub__7cd09d7a96adc908e67e26f47cc2b3781666622d7377834d51fb7cb5e0371bcf(
|
|
47099
47258
|
value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
|
|
47100
47259
|
) -> None:
|
|
@@ -47491,6 +47650,7 @@ def _typecheckingstub__3bddb1be0bd1f1699e3a084c5859d94d8879ff15011f2f2eaac29ec16
|
|
|
47491
47650
|
db_security_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
47492
47651
|
db_snapshot_identifier: typing.Optional[builtins.str] = None,
|
|
47493
47652
|
db_subnet_group_name: typing.Optional[builtins.str] = None,
|
|
47653
|
+
db_system_id: typing.Optional[builtins.str] = None,
|
|
47494
47654
|
dedicated_log_volume: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
47495
47655
|
delete_automated_backups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|
|
47496
47656
|
deletion_protection: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
|