aws-cdk-lib 2.161.1__py3-none-any.whl → 2.162.0__py3-none-any.whl

aws_cdk/aws_quicksight/__init__.py

@@ -147422,7 +147422,7 @@ class CfnFolder(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_quicksight.CfnFolder",
 ):
-    '''Definition of the AWS::QuickSight::Folder Resource Type.
+    '''Creates an empty shared folder.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-folder.html
     :cloudformationResource: AWS::QuickSight::Folder
@@ -147470,12 +147470,12 @@ class CfnFolder(
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param aws_account_id: 
-        :param folder_id: 
-        :param folder_type: 
-        :param name: 
-        :param parent_folder_arn: 
+        :param folder_id: The ID of the folder.
+        :param folder_type: The type of folder it is.
+        :param name: A display name for the folder.
+        :param parent_folder_arn: The Amazon Resource Name (ARN) for the folder.
         :param permissions: 
-        :param sharing_model: 
+        :param sharing_model: The sharing scope of the folder.
         :param tags: 
         '''
         if __debug__:
@@ -147528,7 +147528,8 @@ class CfnFolder(
     @builtins.property
     @jsii.member(jsii_name="attrArn")
     def attr_arn(self) -> builtins.str:
-        '''
+        '''The Amazon Resource Name (ARN) for the folder.
+
         :cloudformationAttribute: Arn
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrArn"))
@@ -147536,7 +147537,8 @@ class CfnFolder(
     @builtins.property
     @jsii.member(jsii_name="attrCreatedTime")
     def attr_created_time(self) -> builtins.str:
-        '''
+        '''The time that the folder was created.
+
         :cloudformationAttribute: CreatedTime
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrCreatedTime"))
@@ -147544,7 +147546,8 @@ class CfnFolder(
     @builtins.property
     @jsii.member(jsii_name="attrLastUpdatedTime")
     def attr_last_updated_time(self) -> builtins.str:
-        '''
+        '''The time that the folder was last updated.
+
         :cloudformationAttribute: LastUpdatedTime
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrLastUpdatedTime"))
@@ -147575,6 +147578,7 @@ class CfnFolder(
     @builtins.property
     @jsii.member(jsii_name="folderId")
     def folder_id(self) -> typing.Optional[builtins.str]:
+        '''The ID of the folder.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "folderId"))
 
     @folder_id.setter
@@ -147587,6 +147591,7 @@ class CfnFolder(
     @builtins.property
     @jsii.member(jsii_name="folderType")
     def folder_type(self) -> typing.Optional[builtins.str]:
+        '''The type of folder it is.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "folderType"))
 
     @folder_type.setter
@@ -147599,6 +147604,7 @@ class CfnFolder(
     @builtins.property
     @jsii.member(jsii_name="name")
     def name(self) -> typing.Optional[builtins.str]:
+        '''A display name for the folder.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "name"))
 
     @name.setter
@@ -147611,6 +147617,7 @@ class CfnFolder(
     @builtins.property
     @jsii.member(jsii_name="parentFolderArn")
     def parent_folder_arn(self) -> typing.Optional[builtins.str]:
+        '''The Amazon Resource Name (ARN) for the folder.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "parentFolderArn"))
 
     @parent_folder_arn.setter
@@ -147640,6 +147647,7 @@ class CfnFolder(
     @builtins.property
     @jsii.member(jsii_name="sharingModel")
     def sharing_model(self) -> typing.Optional[builtins.str]:
+        '''The sharing scope of the folder.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "sharingModel"))
 
     @sharing_model.setter
@@ -147763,12 +147771,12 @@ class CfnFolderProps:
         '''Properties for defining a ``CfnFolder``.
 
         :param aws_account_id: 
-        :param folder_id: 
-        :param folder_type: 
-        :param name: 
-        :param parent_folder_arn: 
+        :param folder_id: The ID of the folder.
+        :param folder_type: The type of folder it is.
+        :param name: A display name for the folder.
+        :param parent_folder_arn: The Amazon Resource Name (ARN) for the folder.
         :param permissions: 
-        :param sharing_model: 
+        :param sharing_model: The sharing scope of the folder.
         :param tags: 
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-folder.html
@@ -147835,7 +147843,8 @@ class CfnFolderProps:
 
     @builtins.property
     def folder_id(self) -> typing.Optional[builtins.str]:
-        '''
+        '''The ID of the folder.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-folder.html#cfn-quicksight-folder-folderid
         '''
         result = self._values.get("folder_id")
@@ -147843,7 +147852,8 @@ class CfnFolderProps:
 
     @builtins.property
     def folder_type(self) -> typing.Optional[builtins.str]:
-        '''
+        '''The type of folder it is.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-folder.html#cfn-quicksight-folder-foldertype
         '''
         result = self._values.get("folder_type")
@@ -147851,7 +147861,8 @@ class CfnFolderProps:
 
     @builtins.property
     def name(self) -> typing.Optional[builtins.str]:
-        '''
+        '''A display name for the folder.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-folder.html#cfn-quicksight-folder-name
         '''
         result = self._values.get("name")
@@ -147859,7 +147870,8 @@ class CfnFolderProps:
 
     @builtins.property
     def parent_folder_arn(self) -> typing.Optional[builtins.str]:
-        '''
+        '''The Amazon Resource Name (ARN) for the folder.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-folder.html#cfn-quicksight-folder-parentfolderarn
         '''
         result = self._values.get("parent_folder_arn")
@@ -147877,7 +147889,8 @@ class CfnFolderProps:
 
     @builtins.property
     def sharing_model(self) -> typing.Optional[builtins.str]:
-        '''
+        '''The sharing scope of the folder.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-folder.html#cfn-quicksight-folder-sharingmodel
         '''
         result = self._values.get("sharing_model")

aws_cdk/aws_rds/__init__.py

@@ -1418,6 +1418,7 @@ The following example shows granting Data API access to a Lamba function.
 ```python
 # vpc: ec2.Vpc
 # fn: lambda.Function
+# secret: secretsmanager.Secret
 
 
 # Create a serverless V1 cluster
@@ -1435,6 +1436,14 @@ cluster = rds.DatabaseCluster(self, "Cluster",
     enable_data_api=True
 )
 cluster.grant_data_api_access(fn)
+
+# Import an Aurora cluster
+imported_cluster = rds.DatabaseCluster.from_database_cluster_attributes(self, "ImportedCluster",
+    cluster_identifier="clusterIdentifier",
+    secret=secret,
+    data_api_enabled=True
+)
+imported_cluster.grant_data_api_access(fn)
 ```
 
 **Note**: To invoke the Data API, the resource will need to read the secret associated with the cluster.
@@ -8495,7 +8504,7 @@ class CfnDBInstance(
         :param db_name: The meaning of this parameter differs according to the database engine you use. .. epigraph:: If you specify the ``[DBSnapshotIdentifier](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-dbsnapshotidentifier)`` property, this property only applies to RDS for Oracle. *Amazon Aurora* Not applicable. The database name is managed by the DB cluster. *Db2* The name of the database to create when the DB instance is created. If this parameter isn't specified, no database is created in the DB instance. Constraints: - Must contain 1 to 64 letters or numbers. - Must begin with a letter. Subsequent characters can be letters, underscores, or digits (0-9). - Can't be a word reserved by the specified database engine. *MySQL* The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance. Constraints: - Must contain 1 to 64 letters or numbers. - Can't be a word reserved by the specified database engine *MariaDB* The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance. Constraints: - Must contain 1 to 64 letters or numbers. - Can't be a word reserved by the specified database engine *PostgreSQL* The name of the database to create when the DB instance is created. If this parameter is not specified, the default ``postgres`` database is created in the DB instance. Constraints: - Must begin with a letter. Subsequent characters can be letters, underscores, or digits (0-9). - Must contain 1 to 63 characters. - Can't be a word reserved by the specified database engine *Oracle* The Oracle System ID (SID) of the created DB instance. If you specify ``null`` , the default value ``ORCL`` is used. You can't specify the string NULL, or any other reserved word, for ``DBName`` . Default: ``ORCL`` Constraints: - Can't be longer than 8 characters *SQL Server* Not applicable. Must be null.
         :param db_parameter_group_name: The name of an existing DB parameter group or a reference to an `AWS::RDS::DBParameterGroup <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-dbparametergroup.html>`_ resource created in the template. To list all of the available DB parameter group names, use the following command: ``aws rds describe-db-parameter-groups --query "DBParameterGroups[].DBParameterGroupName" --output text`` .. epigraph:: If any of the data members of the referenced parameter group are changed during an update, the DB instance might need to be restarted, which causes some interruption. If the parameter group contains static parameters, whether they were changed or not, an update triggers a reboot. If you don't specify a value for ``DBParameterGroupName`` property, the default DB parameter group for the specified engine and engine version is used.
         :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.
-        :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`` - ``DeleteAutomatedBackups`` - ``KmsKeyId`` - ``MasterUsername`` - ``MasterUserPassword`` - ``PerformanceInsightsKMSKeyId`` - ``PerformanceInsightsRetentionPeriod`` - ``PromotionTier`` - ``SourceDBInstanceIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an encrypted snapshot) - ``Timezone`` *Amazon Aurora* Not applicable. Snapshot restore is managed by the DB cluster.
+        :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.
         :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.
         :param dedicated_log_volume: Indicates whether the DB instance has a dedicated log volume (DLV) enabled.
         :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.
@@ -10522,7 +10531,7 @@ class CfnDBInstanceProps:
         :param db_name: The meaning of this parameter differs according to the database engine you use. .. epigraph:: If you specify the ``[DBSnapshotIdentifier](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-database-instance.html#cfn-rds-dbinstance-dbsnapshotidentifier)`` property, this property only applies to RDS for Oracle. *Amazon Aurora* Not applicable. The database name is managed by the DB cluster. *Db2* The name of the database to create when the DB instance is created. If this parameter isn't specified, no database is created in the DB instance. Constraints: - Must contain 1 to 64 letters or numbers. - Must begin with a letter. Subsequent characters can be letters, underscores, or digits (0-9). - Can't be a word reserved by the specified database engine. *MySQL* The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance. Constraints: - Must contain 1 to 64 letters or numbers. - Can't be a word reserved by the specified database engine *MariaDB* The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance. Constraints: - Must contain 1 to 64 letters or numbers. - Can't be a word reserved by the specified database engine *PostgreSQL* The name of the database to create when the DB instance is created. If this parameter is not specified, the default ``postgres`` database is created in the DB instance. Constraints: - Must begin with a letter. Subsequent characters can be letters, underscores, or digits (0-9). - Must contain 1 to 63 characters. - Can't be a word reserved by the specified database engine *Oracle* The Oracle System ID (SID) of the created DB instance. If you specify ``null`` , the default value ``ORCL`` is used. You can't specify the string NULL, or any other reserved word, for ``DBName`` . Default: ``ORCL`` Constraints: - Can't be longer than 8 characters *SQL Server* Not applicable. Must be null.
         :param db_parameter_group_name: The name of an existing DB parameter group or a reference to an `AWS::RDS::DBParameterGroup <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-rds-dbparametergroup.html>`_ resource created in the template. To list all of the available DB parameter group names, use the following command: ``aws rds describe-db-parameter-groups --query "DBParameterGroups[].DBParameterGroupName" --output text`` .. epigraph:: If any of the data members of the referenced parameter group are changed during an update, the DB instance might need to be restarted, which causes some interruption. If the parameter group contains static parameters, whether they were changed or not, an update triggers a reboot. If you don't specify a value for ``DBParameterGroupName`` property, the default DB parameter group for the specified engine and engine version is used.
         :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.
-        :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`` - ``DeleteAutomatedBackups`` - ``KmsKeyId`` - ``MasterUsername`` - ``MasterUserPassword`` - ``PerformanceInsightsKMSKeyId`` - ``PerformanceInsightsRetentionPeriod`` - ``PromotionTier`` - ``SourceDBInstanceIdentifier`` - ``SourceRegion`` - ``StorageEncrypted`` (for an encrypted snapshot) - ``Timezone`` *Amazon Aurora* Not applicable. Snapshot restore is managed by the DB cluster.
+        :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.
         :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.
         :param dedicated_log_volume: Indicates whether the DB instance has a dedicated log volume (DLV) enabled.
         :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.
@@ -11394,16 +11403,13 @@ class CfnDBInstanceProps:
         - ``CharacterSetName``
         - ``DBClusterIdentifier``
         - ``DBName``
-        - ``DeleteAutomatedBackups``
         - ``KmsKeyId``
         - ``MasterUsername``
         - ``MasterUserPassword``
-        - ``PerformanceInsightsKMSKeyId``
-        - ``PerformanceInsightsRetentionPeriod``
         - ``PromotionTier``
         - ``SourceDBInstanceIdentifier``
         - ``SourceRegion``
-        - ``StorageEncrypted`` (for an encrypted snapshot)
+        - ``StorageEncrypted`` (for an unencrypted snapshot)
         - ``Timezone``
 
         *Amazon Aurora*
@@ -16063,7 +16069,7 @@ class CfnGlobalCluster(
         :param global_cluster_identifier: The cluster identifier for this global database cluster. This parameter is stored as a lowercase string.
         :param source_db_cluster_identifier: The Amazon Resource Name (ARN) to use as the primary cluster of the global database. If you provide a value for this parameter, don't specify values for the following settings because Amazon Aurora uses the values from the specified source DB cluster: - ``DatabaseName`` - ``Engine`` - ``EngineVersion`` - ``StorageEncrypted``
         :param storage_encrypted: Specifies whether to enable storage encryption for the new global database cluster. Constraints: - Can't be specified if ``SourceDBClusterIdentifier`` is specified. In this case, Amazon Aurora uses the setting from the source DB cluster.
-        :param tags: An array of key-value pairs to apply to this resource.
+        :param tags: Metadata assigned to an Amazon RDS resource consisting of a key-value pair. For more information, see `Tagging Amazon RDS resources <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html>`_ in the *Amazon RDS User Guide* or `Tagging Amazon Aurora and Amazon RDS resources <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html>`_ in the *Amazon Aurora User Guide* .
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__1611fa62b935d4f304c9fd8befd7c639fa3cc4898c7c6d9f86feb2d669b72e80)
@@ -16230,7 +16236,7 @@ class CfnGlobalCluster(
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''An array of key-value pairs to apply to this resource.'''
+        '''Metadata assigned to an Amazon RDS resource consisting of a key-value pair.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -16277,7 +16283,7 @@ class CfnGlobalClusterProps:
         :param global_cluster_identifier: The cluster identifier for this global database cluster. This parameter is stored as a lowercase string.
         :param source_db_cluster_identifier: The Amazon Resource Name (ARN) to use as the primary cluster of the global database. If you provide a value for this parameter, don't specify values for the following settings because Amazon Aurora uses the values from the specified source DB cluster: - ``DatabaseName`` - ``Engine`` - ``EngineVersion`` - ``StorageEncrypted``
         :param storage_encrypted: Specifies whether to enable storage encryption for the new global database cluster. Constraints: - Can't be specified if ``SourceDBClusterIdentifier`` is specified. In this case, Amazon Aurora uses the setting from the source DB cluster.
-        :param tags: An array of key-value pairs to apply to this resource.
+        :param tags: Metadata assigned to an Amazon RDS resource consisting of a key-value pair. For more information, see `Tagging Amazon RDS resources <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html>`_ in the *Amazon RDS User Guide* or `Tagging Amazon Aurora and Amazon RDS resources <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html>`_ in the *Amazon Aurora User Guide* .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-globalcluster.html
         :exampleMetadata: fixture=_generated
@@ -16436,7 +16442,9 @@ class CfnGlobalClusterProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''An array of key-value pairs to apply to this resource.
+        '''Metadata assigned to an Amazon RDS resource consisting of a key-value pair.
+
+        For more information, see `Tagging Amazon RDS resources <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html>`_ in the *Amazon RDS User Guide* or `Tagging Amazon Aurora and Amazon RDS resources <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html>`_ in the *Amazon Aurora User Guide* .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-globalcluster.html#cfn-rds-globalcluster-tags
         '''
@@ -19450,6 +19458,7 @@ class DBClusterStorageType(enum.Enum):
         "cluster_identifier": "clusterIdentifier",
         "cluster_endpoint_address": "clusterEndpointAddress",
         "cluster_resource_identifier": "clusterResourceIdentifier",
+        "data_api_enabled": "dataApiEnabled",
         "engine": "engine",
         "instance_endpoint_addresses": "instanceEndpointAddresses",
         "instance_identifiers": "instanceIdentifiers",
@@ -19466,6 +19475,7 @@ class DatabaseClusterAttributes:
         cluster_identifier: builtins.str,
         cluster_endpoint_address: typing.Optional[builtins.str] = None,
         cluster_resource_identifier: typing.Optional[builtins.str] = None,
+        data_api_enabled: typing.Optional[builtins.bool] = None,
         engine: typing.Optional["IClusterEngine"] = None,
         instance_endpoint_addresses: typing.Optional[typing.Sequence[builtins.str]] = None,
         instance_identifiers: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -19479,6 +19489,7 @@ class DatabaseClusterAttributes:
         :param cluster_identifier: Identifier for the cluster.
         :param cluster_endpoint_address: Cluster endpoint address. Default: - no endpoint address
         :param cluster_resource_identifier: The immutable identifier for the cluster; for example: cluster-ABCD1234EFGH5678IJKL90MNOP. This AWS Region-unique identifier is used to grant access to the cluster. Default: none
+        :param data_api_enabled: Whether the Data API for the cluster is enabled. Default: false
         :param engine: The engine of the existing Cluster. Default: - the imported Cluster's engine is unknown
         :param instance_endpoint_addresses: Endpoint addresses of individual instances. Default: - no instance endpoints
         :param instance_identifiers: Identifier for the instances. Default: - no instance identifiers
@@ -19487,40 +19498,45 @@ class DatabaseClusterAttributes:
         :param secret: The secret attached to the database cluster. Default: - the imported Cluster's secret is unknown
         :param security_groups: The security groups of the database cluster. Default: - no security groups
 
-        :exampleMetadata: fixture=_generated
+        :exampleMetadata: infused
 
         Example::
 
-            # The code below shows an example of how to instantiate this type.
-            # The values are placeholders you should change.
-            from aws_cdk import aws_ec2 as ec2
-            from aws_cdk import aws_rds as rds
-            from aws_cdk import aws_secretsmanager as secretsmanager
-            
-            # cluster_engine: rds.IClusterEngine
+            # vpc: ec2.Vpc
+            # fn: lambda.Function
             # secret: secretsmanager.Secret
-            # security_group: ec2.SecurityGroup
             
-            database_cluster_attributes = rds.DatabaseClusterAttributes(
-                cluster_identifier="clusterIdentifier",
             
-                # the properties below are optional
-                cluster_endpoint_address="clusterEndpointAddress",
-                cluster_resource_identifier="clusterResourceIdentifier",
-                engine=cluster_engine,
-                instance_endpoint_addresses=["instanceEndpointAddresses"],
-                instance_identifiers=["instanceIdentifiers"],
-                port=123,
-                reader_endpoint_address="readerEndpointAddress",
+            # Create a serverless V1 cluster
+            serverless_v1_cluster = rds.ServerlessCluster(self, "AnotherCluster",
+                engine=rds.DatabaseClusterEngine.AURORA_MYSQL,
+                vpc=vpc,  # this parameter is optional for serverless Clusters
+                enable_data_api=True
+            )
+            serverless_v1_cluster.grant_data_api_access(fn)
+            
+            # Create an Aurora cluster
+            cluster = rds.DatabaseCluster(self, "Cluster",
+                engine=rds.DatabaseClusterEngine.AURORA_MYSQL,
+                vpc=vpc,
+                enable_data_api=True
+            )
+            cluster.grant_data_api_access(fn)
+            
+            # Import an Aurora cluster
+            imported_cluster = rds.DatabaseCluster.from_database_cluster_attributes(self, "ImportedCluster",
+                cluster_identifier="clusterIdentifier",
                 secret=secret,
-                security_groups=[security_group]
+                data_api_enabled=True
             )
+            imported_cluster.grant_data_api_access(fn)
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__ed300072ed57a352a09d26b0a71ae628bf48c46f003dddeb880d02b1b85a68bc)
             check_type(argname="argument cluster_identifier", value=cluster_identifier, expected_type=type_hints["cluster_identifier"])
             check_type(argname="argument cluster_endpoint_address", value=cluster_endpoint_address, expected_type=type_hints["cluster_endpoint_address"])
             check_type(argname="argument cluster_resource_identifier", value=cluster_resource_identifier, expected_type=type_hints["cluster_resource_identifier"])
+            check_type(argname="argument data_api_enabled", value=data_api_enabled, expected_type=type_hints["data_api_enabled"])
             check_type(argname="argument engine", value=engine, expected_type=type_hints["engine"])
             check_type(argname="argument instance_endpoint_addresses", value=instance_endpoint_addresses, expected_type=type_hints["instance_endpoint_addresses"])
             check_type(argname="argument instance_identifiers", value=instance_identifiers, expected_type=type_hints["instance_identifiers"])
@@ -19535,6 +19551,8 @@ class DatabaseClusterAttributes:
             self._values["cluster_endpoint_address"] = cluster_endpoint_address
         if cluster_resource_identifier is not None:
             self._values["cluster_resource_identifier"] = cluster_resource_identifier
+        if data_api_enabled is not None:
+            self._values["data_api_enabled"] = data_api_enabled
         if engine is not None:
             self._values["engine"] = engine
         if instance_endpoint_addresses is not None:
@@ -19577,6 +19595,15 @@ class DatabaseClusterAttributes:
         result = self._values.get("cluster_resource_identifier")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def data_api_enabled(self) -> typing.Optional[builtins.bool]:
+        '''Whether the Data API for the cluster is enabled.
+
+        :default: false
+        '''
+        result = self._values.get("data_api_enabled")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     @builtins.property
     def engine(self) -> typing.Optional["IClusterEngine"]:
         '''The engine of the existing Cluster.
@@ -43746,6 +43773,7 @@ class DatabaseCluster(
         cluster_identifier: builtins.str,
         cluster_endpoint_address: typing.Optional[builtins.str] = None,
         cluster_resource_identifier: typing.Optional[builtins.str] = None,
+        data_api_enabled: typing.Optional[builtins.bool] = None,
         engine: typing.Optional[IClusterEngine] = None,
         instance_endpoint_addresses: typing.Optional[typing.Sequence[builtins.str]] = None,
         instance_identifiers: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -43761,6 +43789,7 @@ class DatabaseCluster(
         :param cluster_identifier: Identifier for the cluster.
         :param cluster_endpoint_address: Cluster endpoint address. Default: - no endpoint address
         :param cluster_resource_identifier: The immutable identifier for the cluster; for example: cluster-ABCD1234EFGH5678IJKL90MNOP. This AWS Region-unique identifier is used to grant access to the cluster. Default: none
+        :param data_api_enabled: Whether the Data API for the cluster is enabled. Default: false
         :param engine: The engine of the existing Cluster. Default: - the imported Cluster's engine is unknown
         :param instance_endpoint_addresses: Endpoint addresses of individual instances. Default: - no instance endpoints
         :param instance_identifiers: Identifier for the instances. Default: - no instance identifiers
@@ -43777,6 +43806,7 @@ class DatabaseCluster(
             cluster_identifier=cluster_identifier,
             cluster_endpoint_address=cluster_endpoint_address,
             cluster_resource_identifier=cluster_resource_identifier,
+            data_api_enabled=data_api_enabled,
             engine=engine,
             instance_endpoint_addresses=instance_endpoint_addresses,
             instance_identifiers=instance_identifiers,
@@ -47186,6 +47216,7 @@ def _typecheckingstub__ed300072ed57a352a09d26b0a71ae628bf48c46f003dddeb880d02b1b
     cluster_identifier: builtins.str,
     cluster_endpoint_address: typing.Optional[builtins.str] = None,
     cluster_resource_identifier: typing.Optional[builtins.str] = None,
+    data_api_enabled: typing.Optional[builtins.bool] = None,
     engine: typing.Optional[IClusterEngine] = None,
     instance_endpoint_addresses: typing.Optional[typing.Sequence[builtins.str]] = None,
     instance_identifiers: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -48989,6 +49020,7 @@ def _typecheckingstub__d7cb0d9ec8799a7f25049acfbf2838c0699426663debfac03fac47054
     cluster_identifier: builtins.str,
     cluster_endpoint_address: typing.Optional[builtins.str] = None,
     cluster_resource_identifier: typing.Optional[builtins.str] = None,
+    data_api_enabled: typing.Optional[builtins.bool] = None,
     engine: typing.Optional[IClusterEngine] = None,
     instance_endpoint_addresses: typing.Optional[typing.Sequence[builtins.str]] = None,
     instance_identifiers: typing.Optional[typing.Sequence[builtins.str]] = None,

aws_cdk/aws_route53/__init__.py

@@ -106,11 +106,14 @@ route53.ARecord(self, "ARecord",
 
 To create an A record of type alias with target set to another record created outside CDK:
 
-### This function registers the given input i.e. DNS Name(string) of an existing record as an AliasTarget to the new ARecord. To register a target that is created as part of CDK use this instead https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_route53_targets-readme.html
+This function registers the given input i.e. DNS Name(string) of an existing record as an AliasTarget to the new ARecord. To register a target that is created as part of CDK use this instead.
+
+Detailed information can be found in the [documentation](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_route53_targets-readme.html).
 
 ```python
 # my_zone: route53.HostedZone
 
+
 target_record = "existing.record.cdk.local"
 record = route53.ARecord.from_aRecord_attributes(self, "A",
     zone=my_zone,
@@ -10240,6 +10243,7 @@ class ARecordAttrs(RecordSetOptions):
 
             # my_zone: route53.HostedZone
             
+            
             target_record = "existing.record.cdk.local"
             record = route53.ARecord.from_aRecord_attributes(self, "A",
                 zone=my_zone,

aws_cdk/aws_route53resolver/__init__.py

@@ -3650,7 +3650,7 @@ class CfnResolverRule(
             :param ip: One IPv4 address that you want to forward DNS queries to.
             :param ipv6: One IPv6 address that you want to forward DNS queries to.
             :param port: The port at ``Ip`` that you want to forward DNS queries to.
-            :param protocol: The protocols for the target address. The protocol you choose needs to be supported by the outbound endpoint of the Resolver rule.
+            :param protocol: The protocols for the Resolver endpoints. DoH-FIPS is applicable for inbound endpoints only. For an inbound endpoint you can apply the protocols as follows: - Do53 and DoH in combination. - Do53 and DoH-FIPS in combination. - Do53 alone. - DoH alone. - DoH-FIPS alone. - None, which is treated as Do53. For an outbound endpoint you can apply the protocols as follows: - Do53 and DoH in combination. - Do53 alone. - DoH alone. - None, which is treated as Do53.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53resolver-resolverrule-targetaddress.html
             :exampleMetadata: fixture=_generated
@@ -3713,9 +3713,23 @@ class CfnResolverRule(
 
         @builtins.property
         def protocol(self) -> typing.Optional[builtins.str]:
-            '''The protocols for the target address.
+            '''The protocols for the Resolver endpoints. DoH-FIPS is applicable for inbound endpoints only.
 
-            The protocol you choose needs to be supported by the outbound endpoint of the Resolver rule.
+            For an inbound endpoint you can apply the protocols as follows:
+
+            - Do53 and DoH in combination.
+            - Do53 and DoH-FIPS in combination.
+            - Do53 alone.
+            - DoH alone.
+            - DoH-FIPS alone.
+            - None, which is treated as Do53.
+
+            For an outbound endpoint you can apply the protocols as follows:
+
+            - Do53 and DoH in combination.
+            - Do53 alone.
+            - DoH alone.
+            - None, which is treated as Do53.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53resolver-resolverrule-targetaddress.html#cfn-route53resolver-resolverrule-targetaddress-protocol
             '''