aws-cdk-lib 2.164.1__py3-none-any.whl → 2.165.0__py3-none-any.whl

aws_cdk/aws_rds/__init__.py

@@ -1733,12 +1733,15 @@ class AuroraCapacityUnit(enum.Enum):
 )
 class AuroraClusterEngineProps:
     def __init__(self, *, version: "AuroraEngineVersion") -> None:
-        '''Creation properties of the plain Aurora database cluster engine.
+        '''(deprecated) Creation properties of the plain Aurora database cluster engine.
 
         Used in ``DatabaseClusterEngine.aurora``.
 
-        :param version: The version of the Aurora cluster engine.
+        :param version: (deprecated) The version of the Aurora cluster engine.
 
+        :deprecated: use ``AuroraMysqlClusterEngineProps`` instead
+
+        :stability: deprecated
         :exampleMetadata: infused
 
         Example::
@@ -1761,7 +1764,10 @@ class AuroraClusterEngineProps:
 
     @builtins.property
     def version(self) -> "AuroraEngineVersion":
-        '''The version of the Aurora cluster engine.'''
+        '''(deprecated) The version of the Aurora cluster engine.
+
+        :stability: deprecated
+        '''
         result = self._values.get("version")
         assert result is not None, "Required property 'version' is missing"
         return typing.cast("AuroraEngineVersion", result)
@@ -1782,8 +1788,11 @@ class AuroraEngineVersion(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_rds.AuroraEngineVersion",
 ):
-    '''The versions for the Aurora cluster engine (those returned by ``DatabaseClusterEngine.aurora``).
+    '''(deprecated) The versions for the Aurora cluster engine (those returned by ``DatabaseClusterEngine.aurora``).
+
+    :deprecated: use ``AuroraMysqlEngineVersion`` instead
 
+    :stability: deprecated
     :exampleMetadata: infused
 
     Example::
@@ -1805,10 +1814,12 @@ class AuroraEngineVersion(
         aurora_full_version: builtins.str,
         aurora_major_version: typing.Optional[builtins.str] = None,
     ) -> "AuroraEngineVersion":
-        '''Create a new AuroraEngineVersion with an arbitrary version.
+        '''(deprecated) Create a new AuroraEngineVersion with an arbitrary version.
 
         :param aurora_full_version: the full version string, for example "5.6.mysql_aurora.1.78.3.6".
         :param aurora_major_version: the major version of the engine, defaults to "5.6".
+
+        :stability: deprecated
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__df17b87254cb31dd21f497140057c7bf82f0bc2436472cda0fb6ff7a099ecbde)
@@ -1819,147 +1830,218 @@ class AuroraEngineVersion(
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_17_9")
     def VER_1_17_9(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.17.9".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.17.9".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_17_9"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_19_0")
     def VER_1_19_0(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.19.0".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.19.0".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_19_0"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_19_1")
     def VER_1_19_1(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.19.1".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.19.1".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_19_1"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_19_2")
     def VER_1_19_2(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.19.2".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.19.2".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_19_2"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_19_5")
     def VER_1_19_5(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.19.5".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.19.5".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_19_5"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_19_6")
     def VER_1_19_6(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.19.6".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.19.6".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_19_6"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_20_0")
     def VER_1_20_0(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.20.0".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.20.0".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_20_0"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_20_1")
     def VER_1_20_1(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.20.1".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.20.1".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_20_1"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_21_0")
     def VER_1_21_0(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.21.0".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.21.0".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_21_0"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_22_0")
     def VER_1_22_0(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.22.0".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.22.0".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_22_0"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_22_1")
     def VER_1_22_1(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.22.1".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.22.1".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_22_1"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_22_1_3")
     def VER_1_22_1_3(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.22.1.3".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.22.1.3".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_22_1_3"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_22_2")
     def VER_1_22_2(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.22.2".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.22.2".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_22_2"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_22_3")
     def VER_1_22_3(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.22.3".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.22.3".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_22_3"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_22_4")
     def VER_1_22_4(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.22.4".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.22.4".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_22_4"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_22_5")
     def VER_1_22_5(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.22.5".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.22.5".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_22_5"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_23_0")
     def VER_1_23_0(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.23.0".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.23.0".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_23_0"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_23_1")
     def VER_1_23_1(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.23.1".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.23.1".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_23_1"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_23_2")
     def VER_1_23_2(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.23.2".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.23.2".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_23_2"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_23_3")
     def VER_1_23_3(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.23.3".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.23.3".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_23_3"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_1_23_4")
     def VER_1_23_4(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.mysql_aurora.1.23.4".'''
+        '''(deprecated) Version "5.6.mysql_aurora.1.23.4".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_1_23_4"))
 
     @jsii.python.classproperty
     @jsii.member(jsii_name="VER_10A")
     def VER_10_A(cls) -> "AuroraEngineVersion":
-        '''Version "5.6.10a".'''
+        '''(deprecated) Version "5.6.10a".
+
+        :stability: deprecated
+        '''
         return typing.cast("AuroraEngineVersion", jsii.sget(cls, "VER_10A"))
 
     @builtins.property
     @jsii.member(jsii_name="auroraFullVersion")
     def aurora_full_version(self) -> builtins.str:
-        '''The full version string, for example, "5.6.mysql_aurora.1.78.3.6".'''
+        '''(deprecated) The full version string, for example, "5.6.mysql_aurora.1.78.3.6".
+
+        :stability: deprecated
+        '''
         return typing.cast(builtins.str, jsii.get(self, "auroraFullVersion"))
 
     @builtins.property
     @jsii.member(jsii_name="auroraMajorVersion")
     def aurora_major_version(self) -> builtins.str:
-        '''The major version of the engine.
+        '''(deprecated) The major version of the engine.
 
         Currently, it's always "5.6".
+
+        :stability: deprecated
         '''
         return typing.cast(builtins.str, jsii.get(self, "auroraMajorVersion"))
 
@@ -19806,9 +19888,13 @@ class DatabaseClusterEngine(
     @jsii.member(jsii_name="aurora")
     @builtins.classmethod
     def aurora(cls, *, version: AuroraEngineVersion) -> "IClusterEngine":
-        '''Creates a new plain Aurora database cluster engine.
+        '''(deprecated) Creates a new plain Aurora database cluster engine.
+
+        :param version: (deprecated) The version of the Aurora cluster engine.
 
-        :param version: The version of the Aurora cluster engine.
+        :deprecated: use ``auroraMysql()`` instead
+
+        :stability: deprecated
         '''
         props = AuroraClusterEngineProps(version=version)
 
@@ -19843,11 +19929,15 @@ class DatabaseClusterEngine(
     @jsii.python.classproperty
     @jsii.member(jsii_name="AURORA")
     def AURORA(cls) -> "IClusterEngine":
-        '''The unversioned 'aurora' cluster engine.
+        '''(deprecated) The unversioned 'aurora' cluster engine.
 
         **Note**: we do not recommend using unversioned engines for non-serverless Clusters,
         as that can pose an availability risk.
         We recommend using versioned engines created using the ``aurora()`` method
+
+        :deprecated: use ``AURORA_MYSQL`` instead
+
+        :stability: deprecated
         '''
         return typing.cast("IClusterEngine", jsii.sget(cls, "AURORA"))
 

aws_cdk/aws_redshift/__init__.py

@@ -5118,7 +5118,7 @@ class CfnIntegration(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_redshift.CfnIntegration",
 ):
-    '''Integration from a source AWS service to a Redshift cluster.
+    '''Describes a zero-ETL integration.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html
     :cloudformationResource: AWS::Redshift::Integration
@@ -5162,12 +5162,12 @@ class CfnIntegration(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param source_arn: The Amazon Resource Name (ARN) of the database to use as the source for replication, for example, arn:aws:dynamodb:us-east-2:123412341234:table/dynamotable.
-        :param target_arn: The Amazon Resource Name (ARN) of the Redshift data warehouse to use as the target for replication, for example, arn:aws:redshift:us-east-2:123412341234:namespace:e43aab3e-10a3-4ec4-83d4-f227ff9bfbcf.
-        :param additional_encryption_context: An optional set of non-secret key–value pairs that contains additional contextual information about the data.
+        :param source_arn: The Amazon Resource Name (ARN) of the database used as the source for replication.
+        :param target_arn: The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.
+        :param additional_encryption_context: The encryption context for the integration. For more information, see `Encryption context <https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#encrypt_context>`_ in the *AWS Key Management Service Developer Guide* .
         :param integration_name: The name of the integration.
-        :param kms_key_id: An KMS key identifier for the key to use to encrypt the integration. If you don't specify an encryption key, the default AWS owned KMS key is used.
-        :param tags: An array of key-value pairs to apply to this resource.
+        :param kms_key_id: The AWS Key Management Service ( AWS KMS ) key identifier for the key used to encrypt the integration.
+        :param tags: The list of tags associated with the integration.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__195f43b15319a462222fa2f5a73df1bdd50a48d85ec97165e527a5a9511ec709)
@@ -5246,7 +5246,7 @@ class CfnIntegration(
     @builtins.property
     @jsii.member(jsii_name="sourceArn")
     def source_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the database to use as the source for replication, for example, arn:aws:dynamodb:us-east-2:123412341234:table/dynamotable.'''
+        '''The Amazon Resource Name (ARN) of the database used as the source for replication.'''
         return typing.cast(builtins.str, jsii.get(self, "sourceArn"))
 
     @source_arn.setter
@@ -5259,7 +5259,7 @@ class CfnIntegration(
     @builtins.property
     @jsii.member(jsii_name="targetArn")
     def target_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the Redshift data warehouse to use as the target for replication, for example, arn:aws:redshift:us-east-2:123412341234:namespace:e43aab3e-10a3-4ec4-83d4-f227ff9bfbcf.'''
+        '''The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.'''
         return typing.cast(builtins.str, jsii.get(self, "targetArn"))
 
     @target_arn.setter
@@ -5274,7 +5274,7 @@ class CfnIntegration(
     def additional_encryption_context(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]]:
-        '''An optional set of non-secret key–value pairs that contains additional contextual information about the data.'''
+        '''The encryption context for the integration.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]], jsii.get(self, "additionalEncryptionContext"))
 
     @additional_encryption_context.setter
@@ -5303,7 +5303,7 @@ class CfnIntegration(
     @builtins.property
     @jsii.member(jsii_name="kmsKeyId")
     def kms_key_id(self) -> typing.Optional[builtins.str]:
-        '''An KMS key identifier for the key to use to encrypt the integration.'''
+        '''The AWS Key Management Service ( AWS KMS ) key identifier for the key used to encrypt the integration.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "kmsKeyId"))
 
     @kms_key_id.setter
@@ -5316,7 +5316,7 @@ class CfnIntegration(
     @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.'''
+        '''The list of tags associated with the integration.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -5352,12 +5352,12 @@ class CfnIntegrationProps:
     ) -> None:
         '''Properties for defining a ``CfnIntegration``.
 
-        :param source_arn: The Amazon Resource Name (ARN) of the database to use as the source for replication, for example, arn:aws:dynamodb:us-east-2:123412341234:table/dynamotable.
-        :param target_arn: The Amazon Resource Name (ARN) of the Redshift data warehouse to use as the target for replication, for example, arn:aws:redshift:us-east-2:123412341234:namespace:e43aab3e-10a3-4ec4-83d4-f227ff9bfbcf.
-        :param additional_encryption_context: An optional set of non-secret key–value pairs that contains additional contextual information about the data.
+        :param source_arn: The Amazon Resource Name (ARN) of the database used as the source for replication.
+        :param target_arn: The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.
+        :param additional_encryption_context: The encryption context for the integration. For more information, see `Encryption context <https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#encrypt_context>`_ in the *AWS Key Management Service Developer Guide* .
         :param integration_name: The name of the integration.
-        :param kms_key_id: An KMS key identifier for the key to use to encrypt the integration. If you don't specify an encryption key, the default AWS owned KMS key is used.
-        :param tags: An array of key-value pairs to apply to this resource.
+        :param kms_key_id: The AWS Key Management Service ( AWS KMS ) key identifier for the key used to encrypt the integration.
+        :param tags: The list of tags associated with the integration.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html
         :exampleMetadata: fixture=_generated
@@ -5407,7 +5407,7 @@ class CfnIntegrationProps:
 
     @builtins.property
     def source_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the database to use as the source for replication, for example, arn:aws:dynamodb:us-east-2:123412341234:table/dynamotable.
+        '''The Amazon Resource Name (ARN) of the database used as the source for replication.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html#cfn-redshift-integration-sourcearn
         '''
@@ -5417,7 +5417,7 @@ class CfnIntegrationProps:
 
     @builtins.property
     def target_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the Redshift data warehouse to use as the target for replication, for example, arn:aws:redshift:us-east-2:123412341234:namespace:e43aab3e-10a3-4ec4-83d4-f227ff9bfbcf.
+        '''The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html#cfn-redshift-integration-targetarn
         '''
@@ -5429,7 +5429,9 @@ class CfnIntegrationProps:
     def additional_encryption_context(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]]:
-        '''An optional set of non-secret key–value pairs that contains additional contextual information about the data.
+        '''The encryption context for the integration.
+
+        For more information, see `Encryption context <https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#encrypt_context>`_ in the *AWS Key Management Service Developer Guide* .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html#cfn-redshift-integration-additionalencryptioncontext
         '''
@@ -5447,9 +5449,7 @@ class CfnIntegrationProps:
 
     @builtins.property
     def kms_key_id(self) -> typing.Optional[builtins.str]:
-        '''An KMS key identifier for the key to use to encrypt the integration.
-
-        If you don't specify an encryption key, the default AWS owned KMS key is used.
+        '''The AWS Key Management Service ( AWS KMS ) key identifier for the key used to encrypt the integration.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html#cfn-redshift-integration-kmskeyid
         '''
@@ -5458,7 +5458,7 @@ class CfnIntegrationProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''An array of key-value pairs to apply to this resource.
+        '''The list of tags associated with the integration.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshift-integration.html#cfn-redshift-integration-tags
         '''