aws-cdk-lib 2.157.0__py3-none-any.whl → 2.159.0__py3-none-any.whl

aws_cdk/aws_msk/__init__.py

@@ -43,7 +43,22 @@ import jsii
 import publication
 import typing_extensions
 
-from typeguard import check_type
+import typeguard
+from importlib.metadata import version as _metadata_package_version
+TYPEGUARD_MAJOR_VERSION = int(_metadata_package_version('typeguard').split('.')[0])
+
+def check_type(argname: str, value: object, expected_type: typing.Any) -> typing.Any:
+    if TYPEGUARD_MAJOR_VERSION <= 2:
+        return typeguard.check_type(argname=argname, value=value, expected_type=expected_type) # type:ignore
+    else:
+        if isinstance(value, jsii._reference_map.InterfaceDynamicProxy): # pyright: ignore [reportAttributeAccessIssue]
+           pass
+        else:
+            if TYPEGUARD_MAJOR_VERSION == 3:
+                typeguard.config.collection_check_strategy = typeguard.CollectionCheckStrategy.ALL_ITEMS # type:ignore
+                typeguard.check_type(value=value, expected_type=expected_type) # type:ignore
+            else:
+                typeguard.check_type(value=value, expected_type=expected_type, collection_check_strategy=typeguard.CollectionCheckStrategy.ALL_ITEMS) # type:ignore
 
 from .._jsii import *
 
@@ -251,12 +266,7 @@ class CfnCluster(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_msk.CfnCluster",
 ):
-    '''Creates a new MSK cluster.
-
-    The following Python 3.6 examples shows how you can create a cluster that's distributed over two Availability Zones. Before you run this Python script, replace the example subnet and security-group IDs with the IDs of your subnets and security group. When you create an MSK cluster, its brokers get evenly distributed over a number of Availability Zones that's equal to the number of subnets that you specify in the ``BrokerNodeGroupInfo`` parameter. In this example, you can add a third subnet to get a cluster that's distributed over three Availability Zones::
-
-       import boto3 client = boto3.client('kafka') response = client.create_cluster( BrokerNodeGroupInfo={ 'BrokerAZDistribution': 'DEFAULT', 'ClientSubnets': [ 'subnet-012345678901fedcba', 'subnet-9876543210abcdef01' ], 'InstanceType': 'kafka.m5.large', 'SecurityGroups': [ 'sg-012345abcdef789789' ] }, ClusterName='SalesCluster', EncryptionInfo={ 'EncryptionInTransit': { 'ClientBroker': 'TLS_PLAINTEXT', 'InCluster': True } }, EnhancedMonitoring='PER_TOPIC_PER_BROKER', KafkaVersion='2.2.1', NumberOfBrokerNodes=2
-       ) print(response)
+    '''http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html
     :cloudformationResource: AWS::MSK::Cluster
@@ -405,19 +415,19 @@ class CfnCluster(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param broker_node_group_info: Information about the broker nodes in the cluster.
-        :param cluster_name: The name of the cluster.
-        :param kafka_version: The version of Apache Kafka. You can use Amazon MSK to create clusters that use Apache Kafka versions 1.1.1 and 2.2.1.
-        :param number_of_broker_nodes: The number of broker nodes in the cluster.
-        :param client_authentication: Includes all client authentication related information.
-        :param configuration_info: Represents the configuration that you want MSK to use for the cluster.
-        :param current_version: The version of the cluster that you want to update.
-        :param encryption_info: Includes all encryption-related information.
-        :param enhanced_monitoring: Specifies the level of monitoring for the MSK cluster. The possible values are ``DEFAULT`` , ``PER_BROKER`` , and ``PER_TOPIC_PER_BROKER`` .
-        :param logging_info: Logging Info details.
-        :param open_monitoring: The settings for open monitoring.
-        :param storage_mode: This controls storage mode for supported storage tiers.
-        :param tags: Create tags when creating the cluster.
+        :param broker_node_group_info: 
+        :param cluster_name: 
+        :param kafka_version: 
+        :param number_of_broker_nodes: 
+        :param client_authentication: 
+        :param configuration_info: 
+        :param current_version: The current version of the MSK cluster.
+        :param encryption_info: 
+        :param enhanced_monitoring: 
+        :param logging_info: 
+        :param open_monitoring: 
+        :param storage_mode: 
+        :param tags: A key-value pair to associate with a resource.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__d267b4b2dcfdda539084655e7a1234ffaf8e77376f37d4914abbcef6c64e9f1c)
@@ -495,7 +505,6 @@ class CfnCluster(
     def broker_node_group_info(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, "CfnCluster.BrokerNodeGroupInfoProperty"]:
-        '''Information about the broker nodes in the cluster.'''
         return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnCluster.BrokerNodeGroupInfoProperty"], jsii.get(self, "brokerNodeGroupInfo"))
 
     @broker_node_group_info.setter
@@ -511,7 +520,6 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="clusterName")
     def cluster_name(self) -> builtins.str:
-        '''The name of the cluster.'''
         return typing.cast(builtins.str, jsii.get(self, "clusterName"))
 
     @cluster_name.setter
@@ -524,7 +532,6 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="kafkaVersion")
     def kafka_version(self) -> builtins.str:
-        '''The version of Apache Kafka.'''
         return typing.cast(builtins.str, jsii.get(self, "kafkaVersion"))
 
     @kafka_version.setter
@@ -537,7 +544,6 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="numberOfBrokerNodes")
     def number_of_broker_nodes(self) -> jsii.Number:
-        '''The number of broker nodes in the cluster.'''
         return typing.cast(jsii.Number, jsii.get(self, "numberOfBrokerNodes"))
 
     @number_of_broker_nodes.setter
@@ -552,7 +558,6 @@ class CfnCluster(
     def client_authentication(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ClientAuthenticationProperty"]]:
-        '''Includes all client authentication related information.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ClientAuthenticationProperty"]], jsii.get(self, "clientAuthentication"))
 
     @client_authentication.setter
@@ -570,7 +575,6 @@ class CfnCluster(
     def configuration_info(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ConfigurationInfoProperty"]]:
-        '''Represents the configuration that you want MSK to use for the cluster.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ConfigurationInfoProperty"]], jsii.get(self, "configurationInfo"))
 
     @configuration_info.setter
@@ -586,7 +590,7 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="currentVersion")
     def current_version(self) -> typing.Optional[builtins.str]:
-        '''The version of the cluster that you want to update.'''
+        '''The current version of the MSK cluster.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "currentVersion"))
 
     @current_version.setter
@@ -601,7 +605,6 @@ class CfnCluster(
     def encryption_info(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.EncryptionInfoProperty"]]:
-        '''Includes all encryption-related information.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.EncryptionInfoProperty"]], jsii.get(self, "encryptionInfo"))
 
     @encryption_info.setter
@@ -617,7 +620,6 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="enhancedMonitoring")
     def enhanced_monitoring(self) -> typing.Optional[builtins.str]:
-        '''Specifies the level of monitoring for the MSK cluster.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "enhancedMonitoring"))
 
     @enhanced_monitoring.setter
@@ -632,7 +634,6 @@ class CfnCluster(
     def logging_info(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.LoggingInfoProperty"]]:
-        '''Logging Info details.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.LoggingInfoProperty"]], jsii.get(self, "loggingInfo"))
 
     @logging_info.setter
@@ -650,7 +651,6 @@ class CfnCluster(
     def open_monitoring(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.OpenMonitoringProperty"]]:
-        '''The settings for open monitoring.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.OpenMonitoringProperty"]], jsii.get(self, "openMonitoring"))
 
     @open_monitoring.setter
@@ -666,7 +666,6 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="storageMode")
     def storage_mode(self) -> typing.Optional[builtins.str]:
-        '''This controls storage mode for supported storage tiers.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "storageMode"))
 
     @storage_mode.setter
@@ -679,7 +678,7 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="tagsRaw")
     def tags_raw(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''Create tags when creating the cluster.'''
+        '''A key-value pair to associate with a resource.'''
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "tagsRaw"))
 
     @tags_raw.setter
@@ -709,11 +708,10 @@ class CfnCluster(
             firehose: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.FirehoseProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             s3: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.S3Property", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''The broker logs configuration for this MSK cluster.
-
-            :param cloud_watch_logs: Details of the CloudWatch Logs destination for broker logs.
-            :param firehose: Details of the Kinesis Data Firehose delivery stream that is the destination for broker logs.
-            :param s3: Details of the Amazon S3 destination for broker logs.
+            '''
+            :param cloud_watch_logs: 
+            :param firehose: 
+            :param s3: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokerlogs.html
             :exampleMetadata: fixture=_generated
@@ -763,8 +761,7 @@ class CfnCluster(
         def cloud_watch_logs(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.CloudWatchLogsProperty"]]:
-            '''Details of the CloudWatch Logs destination for broker logs.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokerlogs.html#cfn-msk-cluster-brokerlogs-cloudwatchlogs
             '''
             result = self._values.get("cloud_watch_logs")
@@ -774,8 +771,7 @@ class CfnCluster(
         def firehose(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.FirehoseProperty"]]:
-            '''Details of the Kinesis Data Firehose delivery stream that is the destination for broker logs.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokerlogs.html#cfn-msk-cluster-brokerlogs-firehose
             '''
             result = self._values.get("firehose")
@@ -785,8 +781,7 @@ class CfnCluster(
         def s3(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.S3Property"]]:
-            '''Details of the Amazon S3 destination for broker logs.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokerlogs.html#cfn-msk-cluster-brokerlogs-s3
             '''
             result = self._values.get("s3")
@@ -826,14 +821,13 @@ class CfnCluster(
             security_groups: typing.Optional[typing.Sequence[builtins.str]] = None,
             storage_info: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.StorageInfoProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Describes the setup to be used for the broker nodes in the cluster.
-
-            :param client_subnets: The list of subnets to connect to in the client virtual private cloud (VPC). Amazon creates elastic network interfaces inside these subnets. Client applications use elastic network interfaces to produce and consume data. If you use the US West (N. California) Region, specify exactly two subnets. For other Regions where Amazon MSK is available, you can specify either two or three subnets. The subnets that you specify must be in distinct Availability Zones. When you create a cluster, Amazon MSK distributes the broker nodes evenly across the subnets that you specify. Client subnets can't occupy the Availability Zone with ID ``use1-az3`` .
+            '''
+            :param client_subnets: 
             :param instance_type: The type of Amazon EC2 instances to use for brokers. The following instance types are allowed: kafka.m5.large, kafka.m5.xlarge, kafka.m5.2xlarge, kafka.m5.4xlarge, kafka.m5.8xlarge, kafka.m5.12xlarge, kafka.m5.16xlarge, kafka.m5.24xlarge, and kafka.t3.small.
-            :param broker_az_distribution: This parameter is currently not in use.
-            :param connectivity_info: Information about the cluster's connectivity setting.
-            :param security_groups: The security groups to associate with the elastic network interfaces in order to specify who can connect to and communicate with the Amazon MSK cluster. If you don't specify a security group, Amazon MSK uses the default security group associated with the VPC. If you specify security groups that were shared with you, you must ensure that you have permissions to them. Specifically, you need the ``ec2:DescribeSecurityGroups`` permission.
-            :param storage_info: Contains information about storage volumes attached to Amazon MSK broker nodes.
+            :param broker_az_distribution: 
+            :param connectivity_info: 
+            :param security_groups: 
+            :param storage_info: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html
             :exampleMetadata: fixture=_generated
@@ -905,14 +899,7 @@ class CfnCluster(
 
         @builtins.property
         def client_subnets(self) -> typing.List[builtins.str]:
-            '''The list of subnets to connect to in the client virtual private cloud (VPC).
-
-            Amazon creates elastic network interfaces inside these subnets. Client applications use elastic network interfaces to produce and consume data.
-
-            If you use the US West (N. California) Region, specify exactly two subnets. For other Regions where Amazon MSK is available, you can specify either two or three subnets. The subnets that you specify must be in distinct Availability Zones. When you create a cluster, Amazon MSK distributes the broker nodes evenly across the subnets that you specify.
-
-            Client subnets can't occupy the Availability Zone with ID ``use1-az3`` .
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-clientsubnets
             '''
             result = self._values.get("client_subnets")
@@ -933,8 +920,7 @@ class CfnCluster(
 
         @builtins.property
         def broker_az_distribution(self) -> typing.Optional[builtins.str]:
-            '''This parameter is currently not in use.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-brokerazdistribution
             '''
             result = self._values.get("broker_az_distribution")
@@ -944,8 +930,7 @@ class CfnCluster(
         def connectivity_info(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ConnectivityInfoProperty"]]:
-            '''Information about the cluster's connectivity setting.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-connectivityinfo
             '''
             result = self._values.get("connectivity_info")
@@ -953,10 +938,7 @@ class CfnCluster(
 
         @builtins.property
         def security_groups(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''The security groups to associate with the elastic network interfaces in order to specify who can connect to and communicate with the Amazon MSK cluster.
-
-            If you don't specify a security group, Amazon MSK uses the default security group associated with the VPC. If you specify security groups that were shared with you, you must ensure that you have permissions to them. Specifically, you need the ``ec2:DescribeSecurityGroups`` permission.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-securitygroups
             '''
             result = self._values.get("security_groups")
@@ -966,8 +948,7 @@ class CfnCluster(
         def storage_info(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.StorageInfoProperty"]]:
-            '''Contains information about storage volumes attached to Amazon MSK broker nodes.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-storageinfo
             '''
             result = self._values.get("storage_info")
@@ -1001,11 +982,10 @@ class CfnCluster(
             tls: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.TlsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             unauthenticated: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.UnauthenticatedProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Includes all client authentication information.
-
-            :param sasl: Details for client authentication using SASL. To turn on SASL, you must also turn on ``EncryptionInTransit`` by setting ``inCluster`` to true. You must set ``clientBroker`` to either ``TLS`` or ``TLS_PLAINTEXT`` . If you choose ``TLS_PLAINTEXT`` , then you must also set ``unauthenticated`` to true.
-            :param tls: Details for ClientAuthentication using TLS. To turn on TLS access control, you must also turn on ``EncryptionInTransit`` by setting ``inCluster`` to true and ``clientBroker`` to ``TLS`` .
-            :param unauthenticated: Details for ClientAuthentication using no authentication.
+            '''
+            :param sasl: 
+            :param tls: 
+            :param unauthenticated: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-clientauthentication.html
             :exampleMetadata: fixture=_generated
@@ -1051,10 +1031,7 @@ class CfnCluster(
         def sasl(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.SaslProperty"]]:
-            '''Details for client authentication using SASL.
-
-            To turn on SASL, you must also turn on ``EncryptionInTransit`` by setting ``inCluster`` to true. You must set ``clientBroker`` to either ``TLS`` or ``TLS_PLAINTEXT`` . If you choose ``TLS_PLAINTEXT`` , then you must also set ``unauthenticated`` to true.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-clientauthentication.html#cfn-msk-cluster-clientauthentication-sasl
             '''
             result = self._values.get("sasl")
@@ -1064,10 +1041,7 @@ class CfnCluster(
         def tls(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.TlsProperty"]]:
-            '''Details for ClientAuthentication using TLS.
-
-            To turn on TLS access control, you must also turn on ``EncryptionInTransit`` by setting ``inCluster`` to true and ``clientBroker`` to ``TLS`` .
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-clientauthentication.html#cfn-msk-cluster-clientauthentication-tls
             '''
             result = self._values.get("tls")
@@ -1077,8 +1051,7 @@ class CfnCluster(
         def unauthenticated(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.UnauthenticatedProperty"]]:
-            '''Details for ClientAuthentication using no authentication.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-clientauthentication.html#cfn-msk-cluster-clientauthentication-unauthenticated
             '''
             result = self._values.get("unauthenticated")
@@ -1107,10 +1080,9 @@ class CfnCluster(
             enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
             log_group: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''Details of the CloudWatch Logs destination for broker logs.
-
-            :param enabled: Specifies whether broker logs get sent to the specified CloudWatch Logs destination.
-            :param log_group: The CloudWatch log group that is the destination for broker logs.
+            '''
+            :param enabled: 
+            :param log_group: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-cloudwatchlogs.html
             :exampleMetadata: fixture=_generated
@@ -1140,8 +1112,7 @@ class CfnCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''Specifies whether broker logs get sent to the specified CloudWatch Logs destination.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-cloudwatchlogs.html#cfn-msk-cluster-cloudwatchlogs-enabled
             '''
             result = self._values.get("enabled")
@@ -1150,8 +1121,7 @@ class CfnCluster(
 
         @builtins.property
         def log_group(self) -> typing.Optional[builtins.str]:
-            '''The CloudWatch log group that is the destination for broker logs.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-cloudwatchlogs.html#cfn-msk-cluster-cloudwatchlogs-loggroup
             '''
             result = self._values.get("log_group")
@@ -1175,10 +1145,9 @@ class CfnCluster(
     )
     class ConfigurationInfoProperty:
         def __init__(self, *, arn: builtins.str, revision: jsii.Number) -> None:
-            '''Specifies the configuration to use for the brokers.
-
-            :param arn: ARN of the configuration to use.
-            :param revision: The revision of the configuration to use.
+            '''
+            :param arn: 
+            :param revision: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-configurationinfo.html
             :exampleMetadata: fixture=_generated
@@ -1205,8 +1174,7 @@ class CfnCluster(
 
         @builtins.property
         def arn(self) -> builtins.str:
-            '''ARN of the configuration to use.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-configurationinfo.html#cfn-msk-cluster-configurationinfo-arn
             '''
             result = self._values.get("arn")
@@ -1215,8 +1183,7 @@ class CfnCluster(
 
         @builtins.property
         def revision(self) -> jsii.Number:
-            '''The revision of the configuration to use.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-configurationinfo.html#cfn-msk-cluster-configurationinfo-revision
             '''
             result = self._values.get("revision")
@@ -1249,10 +1216,9 @@ class CfnCluster(
             public_access: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.PublicAccessProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             vpc_connectivity: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.VpcConnectivityProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Broker access controls.
-
-            :param public_access: Access control settings for the cluster's brokers.
-            :param vpc_connectivity: VPC connection control settings for brokers.
+            '''
+            :param public_access: 
+            :param vpc_connectivity: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-connectivityinfo.html
             :exampleMetadata: fixture=_generated
@@ -1298,8 +1264,7 @@ class CfnCluster(
         def public_access(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.PublicAccessProperty"]]:
-            '''Access control settings for the cluster's brokers.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-connectivityinfo.html#cfn-msk-cluster-connectivityinfo-publicaccess
             '''
             result = self._values.get("public_access")
@@ -1309,8 +1274,7 @@ class CfnCluster(
         def vpc_connectivity(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.VpcConnectivityProperty"]]:
-            '''VPC connection control settings for brokers.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-connectivityinfo.html#cfn-msk-cluster-connectivityinfo-vpcconnectivity
             '''
             result = self._values.get("vpc_connectivity")
@@ -1342,10 +1306,9 @@ class CfnCluster(
             provisioned_throughput: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.ProvisionedThroughputProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             volume_size: typing.Optional[jsii.Number] = None,
         ) -> None:
-            '''Contains information about the EBS storage volumes attached to the broker nodes.
-
-            :param provisioned_throughput: EBS volume provisioned throughput information.
-            :param volume_size: The size in GiB of the EBS volume for the data drive on each broker node.
+            '''
+            :param provisioned_throughput: 
+            :param volume_size: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-ebsstorageinfo.html
             :exampleMetadata: fixture=_generated
@@ -1378,8 +1341,7 @@ class CfnCluster(
         def provisioned_throughput(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ProvisionedThroughputProperty"]]:
-            '''EBS volume provisioned throughput information.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-ebsstorageinfo.html#cfn-msk-cluster-ebsstorageinfo-provisionedthroughput
             '''
             result = self._values.get("provisioned_throughput")
@@ -1387,8 +1349,7 @@ class CfnCluster(
 
         @builtins.property
         def volume_size(self) -> typing.Optional[jsii.Number]:
-            '''The size in GiB of the EBS volume for the data drive on each broker node.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-ebsstorageinfo.html#cfn-msk-cluster-ebsstorageinfo-volumesize
             '''
             result = self._values.get("volume_size")
@@ -1412,11 +1373,8 @@ class CfnCluster(
     )
     class EncryptionAtRestProperty:
         def __init__(self, *, data_volume_kms_key_id: builtins.str) -> None:
-            '''The data-volume encryption details.
-
-            You can't update encryption at rest settings for existing clusters.
-
-            :param data_volume_kms_key_id: The Amazon Resource Name (ARN) of the Amazon KMS key for encrypting data at rest. If you don't specify a KMS key, MSK creates one for you and uses it.
+            '''
+            :param data_volume_kms_key_id: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionatrest.html
             :exampleMetadata: fixture=_generated
@@ -1440,10 +1398,7 @@ class CfnCluster(
 
         @builtins.property
         def data_volume_kms_key_id(self) -> builtins.str:
-            '''The Amazon Resource Name (ARN) of the Amazon KMS key for encrypting data at rest.
-
-            If you don't specify a KMS key, MSK creates one for you and uses it.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionatrest.html#cfn-msk-cluster-encryptionatrest-datavolumekmskeyid
             '''
             result = self._values.get("data_volume_kms_key_id")
@@ -1473,10 +1428,9 @@ class CfnCluster(
             client_broker: typing.Optional[builtins.str] = None,
             in_cluster: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         ) -> None:
-            '''The settings for encrypting data in transit.
-
-            :param client_broker: Indicates the encryption setting for data in transit between clients and brokers. You must set it to one of the following values. ``TLS`` means that client-broker communication is enabled with TLS only. ``TLS_PLAINTEXT`` means that client-broker communication is enabled for both TLS-encrypted, as well as plaintext data. ``PLAINTEXT`` means that client-broker communication is enabled in plaintext only. The default value is ``TLS`` .
-            :param in_cluster: When set to true, it indicates that data communication among the broker nodes of the cluster is encrypted. When set to false, the communication happens in plaintext. The default value is true.
+            '''
+            :param client_broker: 
+            :param in_cluster: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionintransit.html
             :exampleMetadata: fixture=_generated
@@ -1504,18 +1458,7 @@ class CfnCluster(
 
         @builtins.property
         def client_broker(self) -> typing.Optional[builtins.str]:
-            '''Indicates the encryption setting for data in transit between clients and brokers.
-
-            You must set it to one of the following values.
-
-            ``TLS`` means that client-broker communication is enabled with TLS only.
-
-            ``TLS_PLAINTEXT`` means that client-broker communication is enabled for both TLS-encrypted, as well as plaintext data.
-
-            ``PLAINTEXT`` means that client-broker communication is enabled in plaintext only.
-
-            The default value is ``TLS`` .
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionintransit.html#cfn-msk-cluster-encryptionintransit-clientbroker
             '''
             result = self._values.get("client_broker")
@@ -1525,12 +1468,7 @@ class CfnCluster(
         def in_cluster(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''When set to true, it indicates that data communication among the broker nodes of the cluster is encrypted.
-
-            When set to false, the communication happens in plaintext.
-
-            The default value is true.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionintransit.html#cfn-msk-cluster-encryptionintransit-incluster
             '''
             result = self._values.get("in_cluster")
@@ -1562,10 +1500,9 @@ class CfnCluster(
             encryption_at_rest: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.EncryptionAtRestProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             encryption_in_transit: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.EncryptionInTransitProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Includes encryption-related information, such as the Amazon KMS key used for encrypting data at rest and whether you want MSK to encrypt your data in transit.
-
-            :param encryption_at_rest: The data-volume encryption details.
-            :param encryption_in_transit: The details for encryption in transit.
+            '''
+            :param encryption_at_rest: 
+            :param encryption_in_transit: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptioninfo.html
             :exampleMetadata: fixture=_generated
@@ -1600,8 +1537,7 @@ class CfnCluster(
         def encryption_at_rest(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.EncryptionAtRestProperty"]]:
-            '''The data-volume encryption details.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptioninfo.html#cfn-msk-cluster-encryptioninfo-encryptionatrest
             '''
             result = self._values.get("encryption_at_rest")
@@ -1611,8 +1547,7 @@ class CfnCluster(
         def encryption_in_transit(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.EncryptionInTransitProperty"]]:
-            '''The details for encryption in transit.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptioninfo.html#cfn-msk-cluster-encryptioninfo-encryptionintransit
             '''
             result = self._values.get("encryption_in_transit")
@@ -1641,10 +1576,9 @@ class CfnCluster(
             enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
             delivery_stream: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''Firehose details for BrokerLogs.
-
-            :param enabled: Specifies whether broker logs get sent to the specified Kinesis Data Firehose delivery stream.
-            :param delivery_stream: The Kinesis Data Firehose delivery stream that is the destination for broker logs.
+            '''
+            :param enabled: 
+            :param delivery_stream: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-firehose.html
             :exampleMetadata: fixture=_generated
@@ -1674,8 +1608,7 @@ class CfnCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''Specifies whether broker logs get sent to the specified Kinesis Data Firehose delivery stream.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-firehose.html#cfn-msk-cluster-firehose-enabled
             '''
             result = self._values.get("enabled")
@@ -1684,8 +1617,7 @@ class CfnCluster(
 
         @builtins.property
         def delivery_stream(self) -> typing.Optional[builtins.str]:
-            '''The Kinesis Data Firehose delivery stream that is the destination for broker logs.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-firehose.html#cfn-msk-cluster-firehose-deliverystream
             '''
             result = self._values.get("delivery_stream")
@@ -1713,9 +1645,8 @@ class CfnCluster(
             *,
             enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''Details for SASL/IAM client authentication.
-
-            :param enabled: SASL/IAM authentication is enabled or not.
+            '''
+            :param enabled: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-iam.html
             :exampleMetadata: fixture=_generated
@@ -1739,8 +1670,7 @@ class CfnCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''SASL/IAM authentication is enabled or not.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-iam.html#cfn-msk-cluster-iam-enabled
             '''
             result = self._values.get("enabled")
@@ -1769,9 +1699,8 @@ class CfnCluster(
             *,
             enabled_in_broker: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''Indicates whether you want to enable or disable the JMX Exporter.
-
-            :param enabled_in_broker: Indicates whether you want to enable or disable the JMX Exporter.
+            '''
+            :param enabled_in_broker: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-jmxexporter.html
             :exampleMetadata: fixture=_generated
@@ -1797,8 +1726,7 @@ class CfnCluster(
         def enabled_in_broker(
             self,
         ) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''Indicates whether you want to enable or disable the JMX Exporter.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-jmxexporter.html#cfn-msk-cluster-jmxexporter-enabledinbroker
             '''
             result = self._values.get("enabled_in_broker")
@@ -1827,11 +1755,8 @@ class CfnCluster(
             *,
             broker_logs: typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.BrokerLogsProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''You can configure your MSK cluster to send broker logs to different destination types.
-
-            This is a container for the configuration details related to broker logs.
-
-            :param broker_logs: You can configure your MSK cluster to send broker logs to different destination types. This configuration specifies the details of these destinations.
+            '''
+            :param broker_logs: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-logginginfo.html
             :exampleMetadata: fixture=_generated
@@ -1877,10 +1802,7 @@ class CfnCluster(
         def broker_logs(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnCluster.BrokerLogsProperty"]:
-            '''You can configure your MSK cluster to send broker logs to different destination types.
-
-            This configuration specifies the details of these destinations.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-logginginfo.html#cfn-msk-cluster-logginginfo-brokerlogs
             '''
             result = self._values.get("broker_logs")
@@ -1909,9 +1831,8 @@ class CfnCluster(
             *,
             enabled_in_broker: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''Indicates whether you want to enable or disable the Node Exporter.
-
-            :param enabled_in_broker: Indicates whether you want to enable or disable the Node Exporter.
+            '''
+            :param enabled_in_broker: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-nodeexporter.html
             :exampleMetadata: fixture=_generated
@@ -1937,8 +1858,7 @@ class CfnCluster(
         def enabled_in_broker(
             self,
         ) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''Indicates whether you want to enable or disable the Node Exporter.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-nodeexporter.html#cfn-msk-cluster-nodeexporter-enabledinbroker
             '''
             result = self._values.get("enabled_in_broker")
@@ -1967,9 +1887,8 @@ class CfnCluster(
             *,
             prometheus: typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.PrometheusProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''JMX and Node monitoring for the MSK cluster.
-
-            :param prometheus: Prometheus exporter settings.
+            '''
+            :param prometheus: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-openmonitoring.html
             :exampleMetadata: fixture=_generated
@@ -2002,8 +1921,7 @@ class CfnCluster(
         def prometheus(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnCluster.PrometheusProperty"]:
-            '''Prometheus exporter settings.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-openmonitoring.html#cfn-msk-cluster-openmonitoring-prometheus
             '''
             result = self._values.get("prometheus")
@@ -2033,10 +1951,9 @@ class CfnCluster(
             jmx_exporter: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.JmxExporterProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             node_exporter: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.NodeExporterProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Prometheus settings for open monitoring.
-
-            :param jmx_exporter: Indicates whether you want to enable or disable the JMX Exporter.
-            :param node_exporter: Indicates whether you want to enable or disable the Node Exporter.
+            '''
+            :param jmx_exporter: 
+            :param node_exporter: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-prometheus.html
             :exampleMetadata: fixture=_generated
@@ -2070,8 +1987,7 @@ class CfnCluster(
         def jmx_exporter(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.JmxExporterProperty"]]:
-            '''Indicates whether you want to enable or disable the JMX Exporter.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-prometheus.html#cfn-msk-cluster-prometheus-jmxexporter
             '''
             result = self._values.get("jmx_exporter")
@@ -2081,8 +1997,7 @@ class CfnCluster(
         def node_exporter(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.NodeExporterProperty"]]:
-            '''Indicates whether you want to enable or disable the Node Exporter.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-prometheus.html#cfn-msk-cluster-prometheus-nodeexporter
             '''
             result = self._values.get("node_exporter")
@@ -2111,10 +2026,9 @@ class CfnCluster(
             enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
             volume_throughput: typing.Optional[jsii.Number] = None,
         ) -> None:
-            '''Contains information about provisioned throughput for EBS storage volumes attached to kafka broker nodes.
-
-            :param enabled: Provisioned throughput is enabled or not.
-            :param volume_throughput: Throughput value of the EBS volumes for the data drive on each kafka broker node in MiB per second.
+            '''
+            :param enabled: 
+            :param volume_throughput: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-provisionedthroughput.html
             :exampleMetadata: fixture=_generated
@@ -2144,8 +2058,7 @@ class CfnCluster(
         def enabled(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''Provisioned throughput is enabled or not.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-provisionedthroughput.html#cfn-msk-cluster-provisionedthroughput-enabled
             '''
             result = self._values.get("enabled")
@@ -2153,8 +2066,7 @@ class CfnCluster(
 
         @builtins.property
         def volume_throughput(self) -> typing.Optional[jsii.Number]:
-            '''Throughput value of the EBS volumes for the data drive on each kafka broker node in MiB per second.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-provisionedthroughput.html#cfn-msk-cluster-provisionedthroughput-volumethroughput
             '''
             result = self._values.get("volume_throughput")
@@ -2178,9 +2090,8 @@ class CfnCluster(
     )
     class PublicAccessProperty:
         def __init__(self, *, type: typing.Optional[builtins.str] = None) -> None:
-            '''Broker access controls.
-
-            :param type: DISABLED means that public access is turned off. SERVICE_PROVIDED_EIPS means that public access is turned on.
+            '''
+            :param type: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-publicaccess.html
             :exampleMetadata: fixture=_generated
@@ -2204,10 +2115,7 @@ class CfnCluster(
 
         @builtins.property
         def type(self) -> typing.Optional[builtins.str]:
-            '''DISABLED means that public access is turned off.
-
-            SERVICE_PROVIDED_EIPS means that public access is turned on.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-publicaccess.html#cfn-msk-cluster-publicaccess-type
             '''
             result = self._values.get("type")
@@ -2237,11 +2145,10 @@ class CfnCluster(
             bucket: typing.Optional[builtins.str] = None,
             prefix: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''The details of the Amazon S3 destination for broker logs.
-
-            :param enabled: Specifies whether broker logs get sent to the specified Amazon S3 destination.
-            :param bucket: The name of the S3 bucket that is the destination for broker logs.
-            :param prefix: The S3 prefix that is the destination for broker logs.
+            '''
+            :param enabled: 
+            :param bucket: 
+            :param prefix: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-s3.html
             :exampleMetadata: fixture=_generated
@@ -2275,8 +2182,7 @@ class CfnCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''Specifies whether broker logs get sent to the specified Amazon S3 destination.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-s3.html#cfn-msk-cluster-s3-enabled
             '''
             result = self._values.get("enabled")
@@ -2285,8 +2191,7 @@ class CfnCluster(
 
         @builtins.property
         def bucket(self) -> typing.Optional[builtins.str]:
-            '''The name of the S3 bucket that is the destination for broker logs.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-s3.html#cfn-msk-cluster-s3-bucket
             '''
             result = self._values.get("bucket")
@@ -2294,8 +2199,7 @@ class CfnCluster(
 
         @builtins.property
         def prefix(self) -> typing.Optional[builtins.str]:
-            '''The S3 prefix that is the destination for broker logs.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-s3.html#cfn-msk-cluster-s3-prefix
             '''
             result = self._values.get("prefix")
@@ -2324,12 +2228,9 @@ class CfnCluster(
             iam: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.IamProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             scram: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.ScramProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Details for client authentication using SASL.
-
-            To turn on SASL, you must also turn on ``EncryptionInTransit`` by setting ``inCluster`` to true. You must set ``clientBroker`` to either ``TLS`` or ``TLS_PLAINTEXT`` . If you choose ``TLS_PLAINTEXT`` , then you must also set ``unauthenticated`` to true.
-
-            :param iam: Details for ClientAuthentication using IAM.
-            :param scram: Details for SASL/SCRAM client authentication.
+            '''
+            :param iam: 
+            :param scram: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-sasl.html
             :exampleMetadata: fixture=_generated
@@ -2363,8 +2264,7 @@ class CfnCluster(
         def iam(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.IamProperty"]]:
-            '''Details for ClientAuthentication using IAM.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-sasl.html#cfn-msk-cluster-sasl-iam
             '''
             result = self._values.get("iam")
@@ -2374,8 +2274,7 @@ class CfnCluster(
         def scram(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ScramProperty"]]:
-            '''Details for SASL/SCRAM client authentication.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-sasl.html#cfn-msk-cluster-sasl-scram
             '''
             result = self._values.get("scram")
@@ -2403,9 +2302,8 @@ class CfnCluster(
             *,
             enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''Details for SASL/SCRAM client authentication.
-
-            :param enabled: SASL/SCRAM authentication is enabled or not.
+            '''
+            :param enabled: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-scram.html
             :exampleMetadata: fixture=_generated
@@ -2429,8 +2327,7 @@ class CfnCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''SASL/SCRAM authentication is enabled or not.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-scram.html#cfn-msk-cluster-scram-enabled
             '''
             result = self._values.get("enabled")
@@ -2459,9 +2356,8 @@ class CfnCluster(
             *,
             ebs_storage_info: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.EBSStorageInfoProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Contains information about storage volumes attached to Amazon MSK broker nodes.
-
-            :param ebs_storage_info: EBS volume information.
+            '''
+            :param ebs_storage_info: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-storageinfo.html
             :exampleMetadata: fixture=_generated
@@ -2493,8 +2389,7 @@ class CfnCluster(
         def ebs_storage_info(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.EBSStorageInfoProperty"]]:
-            '''EBS volume information.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-storageinfo.html#cfn-msk-cluster-storageinfo-ebsstorageinfo
             '''
             result = self._values.get("ebs_storage_info")
@@ -2526,10 +2421,9 @@ class CfnCluster(
             certificate_authority_arn_list: typing.Optional[typing.Sequence[builtins.str]] = None,
             enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         ) -> None:
-            '''Details for client authentication using TLS.
-
-            :param certificate_authority_arn_list: List of AWS Private CA Amazon Resource Name (ARN)s.
-            :param enabled: TLS authentication is enabled or not.
+            '''
+            :param certificate_authority_arn_list: 
+            :param enabled: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-tls.html
             :exampleMetadata: fixture=_generated
@@ -2559,8 +2453,7 @@ class CfnCluster(
         def certificate_authority_arn_list(
             self,
         ) -> typing.Optional[typing.List[builtins.str]]:
-            '''List of AWS Private CA Amazon Resource Name (ARN)s.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-tls.html#cfn-msk-cluster-tls-certificateauthorityarnlist
             '''
             result = self._values.get("certificate_authority_arn_list")
@@ -2570,8 +2463,7 @@ class CfnCluster(
         def enabled(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''TLS authentication is enabled or not.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-tls.html#cfn-msk-cluster-tls-enabled
             '''
             result = self._values.get("enabled")
@@ -2599,9 +2491,8 @@ class CfnCluster(
             *,
             enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''Details for allowing no client authentication.
-
-            :param enabled: Unauthenticated is enabled or not.
+            '''
+            :param enabled: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-unauthenticated.html
             :exampleMetadata: fixture=_generated
@@ -2625,8 +2516,7 @@ class CfnCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''Unauthenticated is enabled or not.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-unauthenticated.html#cfn-msk-cluster-unauthenticated-enabled
             '''
             result = self._values.get("enabled")
@@ -2656,10 +2546,9 @@ class CfnCluster(
             sasl: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.VpcConnectivitySaslProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             tls: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.VpcConnectivityTlsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Includes all client authentication information for VpcConnectivity.
-
-            :param sasl: Details for VpcConnectivity ClientAuthentication using SASL.
-            :param tls: Details for VpcConnectivity ClientAuthentication using TLS.
+            '''
+            :param sasl: 
+            :param tls: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivityclientauthentication.html
             :exampleMetadata: fixture=_generated
@@ -2698,8 +2587,7 @@ class CfnCluster(
         def sasl(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.VpcConnectivitySaslProperty"]]:
-            '''Details for VpcConnectivity ClientAuthentication using SASL.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivityclientauthentication.html#cfn-msk-cluster-vpcconnectivityclientauthentication-sasl
             '''
             result = self._values.get("sasl")
@@ -2709,8 +2597,7 @@ class CfnCluster(
         def tls(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.VpcConnectivityTlsProperty"]]:
-            '''Details for VpcConnectivity ClientAuthentication using TLS.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivityclientauthentication.html#cfn-msk-cluster-vpcconnectivityclientauthentication-tls
             '''
             result = self._values.get("tls")
@@ -2738,9 +2625,8 @@ class CfnCluster(
             *,
             enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''Details for SASL/IAM client authentication for VpcConnectivity.
-
-            :param enabled: SASL/IAM authentication is enabled or not.
+            '''
+            :param enabled: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivityiam.html
             :exampleMetadata: fixture=_generated
@@ -2764,8 +2650,7 @@ class CfnCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''SASL/IAM authentication is enabled or not.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivityiam.html#cfn-msk-cluster-vpcconnectivityiam-enabled
             '''
             result = self._values.get("enabled")
@@ -2794,9 +2679,8 @@ class CfnCluster(
             *,
             client_authentication: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.VpcConnectivityClientAuthenticationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''VPC connection control settings for brokers.
-
-            :param client_authentication: VPC connection control settings for brokers.
+            '''
+            :param client_authentication: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivity.html
             :exampleMetadata: fixture=_generated
@@ -2834,8 +2718,7 @@ class CfnCluster(
         def client_authentication(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.VpcConnectivityClientAuthenticationProperty"]]:
-            '''VPC connection control settings for brokers.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivity.html#cfn-msk-cluster-vpcconnectivity-clientauthentication
             '''
             result = self._values.get("client_authentication")
@@ -2864,10 +2747,9 @@ class CfnCluster(
             iam: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.VpcConnectivityIamProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             scram: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.VpcConnectivityScramProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''Details for client authentication using SASL for VpcConnectivity.
-
-            :param iam: Details for ClientAuthentication using IAM for VpcConnectivity.
-            :param scram: Details for SASL/SCRAM client authentication for VpcConnectivity.
+            '''
+            :param iam: 
+            :param scram: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivitysasl.html
             :exampleMetadata: fixture=_generated
@@ -2901,8 +2783,7 @@ class CfnCluster(
         def iam(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.VpcConnectivityIamProperty"]]:
-            '''Details for ClientAuthentication using IAM for VpcConnectivity.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivitysasl.html#cfn-msk-cluster-vpcconnectivitysasl-iam
             '''
             result = self._values.get("iam")
@@ -2912,8 +2793,7 @@ class CfnCluster(
         def scram(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.VpcConnectivityScramProperty"]]:
-            '''Details for SASL/SCRAM client authentication for VpcConnectivity.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivitysasl.html#cfn-msk-cluster-vpcconnectivitysasl-scram
             '''
             result = self._values.get("scram")
@@ -2941,9 +2821,8 @@ class CfnCluster(
             *,
             enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''Details for SASL/SCRAM client authentication for vpcConnectivity.
-
-            :param enabled: SASL/SCRAM authentication is enabled or not.
+            '''
+            :param enabled: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivityscram.html
             :exampleMetadata: fixture=_generated
@@ -2967,8 +2846,7 @@ class CfnCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''SASL/SCRAM authentication is enabled or not.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivityscram.html#cfn-msk-cluster-vpcconnectivityscram-enabled
             '''
             result = self._values.get("enabled")
@@ -2997,9 +2875,8 @@ class CfnCluster(
             *,
             enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''Details for client authentication using TLS for vpcConnectivity.
-
-            :param enabled: TLS authentication is enabled or not.
+            '''
+            :param enabled: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivitytls.html
             :exampleMetadata: fixture=_generated
@@ -3023,8 +2900,7 @@ class CfnCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''TLS authentication is enabled or not.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-vpcconnectivitytls.html#cfn-msk-cluster-vpcconnectivitytls-enabled
             '''
             result = self._values.get("enabled")
@@ -3270,19 +3146,19 @@ class CfnClusterProps:
     ) -> None:
         '''Properties for defining a ``CfnCluster``.
 
-        :param broker_node_group_info: Information about the broker nodes in the cluster.
-        :param cluster_name: The name of the cluster.
-        :param kafka_version: The version of Apache Kafka. You can use Amazon MSK to create clusters that use Apache Kafka versions 1.1.1 and 2.2.1.
-        :param number_of_broker_nodes: The number of broker nodes in the cluster.
-        :param client_authentication: Includes all client authentication related information.
-        :param configuration_info: Represents the configuration that you want MSK to use for the cluster.
-        :param current_version: The version of the cluster that you want to update.
-        :param encryption_info: Includes all encryption-related information.
-        :param enhanced_monitoring: Specifies the level of monitoring for the MSK cluster. The possible values are ``DEFAULT`` , ``PER_BROKER`` , and ``PER_TOPIC_PER_BROKER`` .
-        :param logging_info: Logging Info details.
-        :param open_monitoring: The settings for open monitoring.
-        :param storage_mode: This controls storage mode for supported storage tiers.
-        :param tags: Create tags when creating the cluster.
+        :param broker_node_group_info: 
+        :param cluster_name: 
+        :param kafka_version: 
+        :param number_of_broker_nodes: 
+        :param client_authentication: 
+        :param configuration_info: 
+        :param current_version: The current version of the MSK cluster.
+        :param encryption_info: 
+        :param enhanced_monitoring: 
+        :param logging_info: 
+        :param open_monitoring: 
+        :param storage_mode: 
+        :param tags: A key-value pair to associate with a resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html
         :exampleMetadata: fixture=_generated
@@ -3451,8 +3327,7 @@ class CfnClusterProps:
     def broker_node_group_info(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, CfnCluster.BrokerNodeGroupInfoProperty]:
-        '''Information about the broker nodes in the cluster.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-brokernodegroupinfo
         '''
         result = self._values.get("broker_node_group_info")
@@ -3461,8 +3336,7 @@ class CfnClusterProps:
 
     @builtins.property
     def cluster_name(self) -> builtins.str:
-        '''The name of the cluster.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-clustername
         '''
         result = self._values.get("cluster_name")
@@ -3471,10 +3345,7 @@ class CfnClusterProps:
 
     @builtins.property
     def kafka_version(self) -> builtins.str:
-        '''The version of Apache Kafka.
-
-        You can use Amazon MSK to create clusters that use Apache Kafka versions 1.1.1 and 2.2.1.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-kafkaversion
         '''
         result = self._values.get("kafka_version")
@@ -3483,8 +3354,7 @@ class CfnClusterProps:
 
     @builtins.property
     def number_of_broker_nodes(self) -> jsii.Number:
-        '''The number of broker nodes in the cluster.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-numberofbrokernodes
         '''
         result = self._values.get("number_of_broker_nodes")
@@ -3495,8 +3365,7 @@ class CfnClusterProps:
     def client_authentication(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCluster.ClientAuthenticationProperty]]:
-        '''Includes all client authentication related information.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-clientauthentication
         '''
         result = self._values.get("client_authentication")
@@ -3506,8 +3375,7 @@ class CfnClusterProps:
     def configuration_info(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCluster.ConfigurationInfoProperty]]:
-        '''Represents the configuration that you want MSK to use for the cluster.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-configurationinfo
         '''
         result = self._values.get("configuration_info")
@@ -3515,7 +3383,7 @@ class CfnClusterProps:
 
     @builtins.property
     def current_version(self) -> typing.Optional[builtins.str]:
-        '''The version of the cluster that you want to update.
+        '''The current version of the MSK cluster.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-currentversion
         '''
@@ -3526,8 +3394,7 @@ class CfnClusterProps:
     def encryption_info(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCluster.EncryptionInfoProperty]]:
-        '''Includes all encryption-related information.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-encryptioninfo
         '''
         result = self._values.get("encryption_info")
@@ -3535,10 +3402,7 @@ class CfnClusterProps:
 
     @builtins.property
     def enhanced_monitoring(self) -> typing.Optional[builtins.str]:
-        '''Specifies the level of monitoring for the MSK cluster.
-
-        The possible values are ``DEFAULT`` , ``PER_BROKER`` , and ``PER_TOPIC_PER_BROKER`` .
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-enhancedmonitoring
         '''
         result = self._values.get("enhanced_monitoring")
@@ -3548,8 +3412,7 @@ class CfnClusterProps:
     def logging_info(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCluster.LoggingInfoProperty]]:
-        '''Logging Info details.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-logginginfo
         '''
         result = self._values.get("logging_info")
@@ -3559,8 +3422,7 @@ class CfnClusterProps:
     def open_monitoring(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCluster.OpenMonitoringProperty]]:
-        '''The settings for open monitoring.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-openmonitoring
         '''
         result = self._values.get("open_monitoring")
@@ -3568,8 +3430,7 @@ class CfnClusterProps:
 
     @builtins.property
     def storage_mode(self) -> typing.Optional[builtins.str]:
-        '''This controls storage mode for supported storage tiers.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-storagemode
         '''
         result = self._values.get("storage_mode")
@@ -3577,7 +3438,7 @@ class CfnClusterProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''Create tags when creating the cluster.
+        '''A key-value pair to associate with a resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-tags
         '''
@@ -3602,16 +3463,7 @@ class CfnConfiguration(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_msk.CfnConfiguration",
 ):
-    '''Creates a new MSK configuration.
-
-    To see an example of how to use this operation, first save the following text to a file and name the file config-file.txt .
-
-    ``auto.create.topics.enable = true zookeeper.connection.timeout.ms = 1000 log.roll.ms = 604800000``
-
-    Now run the following Python 3.6 script in the folder where you saved config-file.txt . This script uses the properties specified in config-file.txt to create a configuration named ``SalesClusterConfiguration`` . This configuration can work with Apache Kafka versions 1.1.1 and 2.1.0::
-
-       import boto3 client = boto3.client('kafka') config_file = open('config-file.txt', 'r') server_properties = config_file.read() response = client.create_configuration( Name='SalesClusterConfiguration', Description='The configuration to use on all sales clusters.', KafkaVersions=['1.1.1', '2.1.0'], ServerProperties=server_properties
-       ) print(response)
+    '''http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html
     :cloudformationResource: AWS::MSK::Configuration
@@ -3652,11 +3504,11 @@ class CfnConfiguration(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param name: The name of the configuration. Configuration names are strings that match the regex "^[0-9A-Za-z][0-9A-Za-z-]{0,}$".
-        :param server_properties: Contents of the server.properties file. When using the API, you must ensure that the contents of the file are base64 encoded. When using the console, the SDK, or the CLI, the contents of server.properties can be in plaintext.
-        :param description: The description of the configuration.
+        :param name: 
+        :param server_properties: 
+        :param description: 
         :param kafka_versions_list: 
-        :param latest_revision: Latest revision of the configuration.
+        :param latest_revision: 
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__4496d16ab1313e2d6e75f55fc7cdb170962f756c6dc1149245dde1aba3113278)
@@ -3713,8 +3565,7 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="attrLatestRevisionCreationTime")
     def attr_latest_revision_creation_time(self) -> builtins.str:
-        '''The time when the configuration was created.
-
+        '''
         :cloudformationAttribute: LatestRevision.CreationTime
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrLatestRevisionCreationTime"))
@@ -3722,8 +3573,7 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="attrLatestRevisionDescription")
     def attr_latest_revision_description(self) -> builtins.str:
-        '''The description of the configuration.
-
+        '''
         :cloudformationAttribute: LatestRevision.Description
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrLatestRevisionDescription"))
@@ -3731,8 +3581,7 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="attrLatestRevisionRevision")
     def attr_latest_revision_revision(self) -> jsii.Number:
-        '''A string that uniquely identifies a revision of an MSK configuration.
-
+        '''
         :cloudformationAttribute: LatestRevision.Revision
         '''
         return typing.cast(jsii.Number, jsii.get(self, "attrLatestRevisionRevision"))
@@ -3745,7 +3594,6 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="name")
     def name(self) -> builtins.str:
-        '''The name of the configuration.'''
         return typing.cast(builtins.str, jsii.get(self, "name"))
 
     @name.setter
@@ -3758,7 +3606,6 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="serverProperties")
     def server_properties(self) -> builtins.str:
-        '''Contents of the server.properties file. When using the API, you must ensure that the contents of the file are base64 encoded. When using the console, the SDK, or the CLI, the contents of server.properties can be in plaintext.'''
         return typing.cast(builtins.str, jsii.get(self, "serverProperties"))
 
     @server_properties.setter
@@ -3771,7 +3618,6 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="description")
     def description(self) -> typing.Optional[builtins.str]:
-        '''The description of the configuration.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "description"))
 
     @description.setter
@@ -3801,7 +3647,6 @@ class CfnConfiguration(
     def latest_revision(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnConfiguration.LatestRevisionProperty"]]:
-        '''Latest revision of the configuration.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnConfiguration.LatestRevisionProperty"]], jsii.get(self, "latestRevision"))
 
     @latest_revision.setter
@@ -3923,11 +3768,11 @@ class CfnConfigurationProps:
     ) -> None:
         '''Properties for defining a ``CfnConfiguration``.
 
-        :param name: The name of the configuration. Configuration names are strings that match the regex "^[0-9A-Za-z][0-9A-Za-z-]{0,}$".
-        :param server_properties: Contents of the server.properties file. When using the API, you must ensure that the contents of the file are base64 encoded. When using the console, the SDK, or the CLI, the contents of server.properties can be in plaintext.
-        :param description: The description of the configuration.
+        :param name: 
+        :param server_properties: 
+        :param description: 
         :param kafka_versions_list: 
-        :param latest_revision: Latest revision of the configuration.
+        :param latest_revision: 
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html
         :exampleMetadata: fixture=_generated
@@ -3972,10 +3817,7 @@ class CfnConfigurationProps:
 
     @builtins.property
     def name(self) -> builtins.str:
-        '''The name of the configuration.
-
-        Configuration names are strings that match the regex "^[0-9A-Za-z][0-9A-Za-z-]{0,}$".
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html#cfn-msk-configuration-name
         '''
         result = self._values.get("name")
@@ -3984,8 +3826,7 @@ class CfnConfigurationProps:
 
     @builtins.property
     def server_properties(self) -> builtins.str:
-        '''Contents of the server.properties file. When using the API, you must ensure that the contents of the file are base64 encoded. When using the console, the SDK, or the CLI, the contents of server.properties can be in plaintext.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html#cfn-msk-configuration-serverproperties
         '''
         result = self._values.get("server_properties")
@@ -3994,8 +3835,7 @@ class CfnConfigurationProps:
 
     @builtins.property
     def description(self) -> typing.Optional[builtins.str]:
-        '''The description of the configuration.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html#cfn-msk-configuration-description
         '''
         result = self._values.get("description")
@@ -4013,8 +3853,7 @@ class CfnConfigurationProps:
     def latest_revision(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnConfiguration.LatestRevisionProperty]]:
-        '''Latest revision of the configuration.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html#cfn-msk-configuration-latestrevision
         '''
         result = self._values.get("latest_revision")
@@ -4038,7 +3877,7 @@ class CfnReplicator(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_msk.CfnReplicator",
 ):
-    '''Resource Type definition for AWS::MSK::Replicator.
+    '''Creates the replicator.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-replicator.html
     :cloudformationResource: AWS::MSK::Replicator
@@ -4119,13 +3958,13 @@ class CfnReplicator(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param kafka_clusters: Specifies a list of Kafka clusters which are targets of the replicator.
+        :param kafka_clusters: Kafka Clusters to use in setting up sources / targets for replication.
         :param replication_info_list: A list of replication configurations, where each configuration targets a given source cluster to target cluster replication flow.
-        :param replicator_name: The name of the replicator.
-        :param service_execution_role_arn: The Amazon Resource Name (ARN) of the IAM role used by the replicator to access external resources.
-        :param current_version: The current version of the MSK replicator.
+        :param replicator_name: The name of the replicator. Alpha-numeric characters with '-' are allowed.
+        :param service_execution_role_arn: The ARN of the IAM role used by the replicator to access resources in the customer's account (e.g source and target clusters).
+        :param current_version: The current version number of the replicator.
         :param description: A summary description of the replicator.
-        :param tags: A collection of tags associated with a resource.
+        :param tags: List of tags to attach to created Replicator.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__dfeb157957f65ee344afab32ca8fffe9eb07ec631c59935f85e890a85df3294b)
@@ -4198,7 +4037,7 @@ class CfnReplicator(
     def kafka_clusters(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnReplicator.KafkaClusterProperty"]]]:
-        '''Specifies a list of Kafka clusters which are targets of the replicator.'''
+        '''Kafka Clusters to use in setting up sources / targets for replication.'''
         return typing.cast(typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnReplicator.KafkaClusterProperty"]]], jsii.get(self, "kafkaClusters"))
 
     @kafka_clusters.setter
@@ -4245,7 +4084,7 @@ class CfnReplicator(
     @builtins.property
     @jsii.member(jsii_name="serviceExecutionRoleArn")
     def service_execution_role_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the IAM role used by the replicator to access external resources.'''
+        '''The ARN of the IAM role used by the replicator to access resources in the customer's account (e.g source and target clusters).'''
         return typing.cast(builtins.str, jsii.get(self, "serviceExecutionRoleArn"))
 
     @service_execution_role_arn.setter
@@ -4258,7 +4097,7 @@ class CfnReplicator(
     @builtins.property
     @jsii.member(jsii_name="currentVersion")
     def current_version(self) -> typing.Optional[builtins.str]:
-        '''The current version of the MSK replicator.'''
+        '''The current version number of the replicator.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "currentVersion"))
 
     @current_version.setter
@@ -4284,7 +4123,7 @@ class CfnReplicator(
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''A collection of tags associated with a resource.'''
+        '''List of tags to attach to created Replicator.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -4301,9 +4140,9 @@ class CfnReplicator(
     )
     class AmazonMskClusterProperty:
         def __init__(self, *, msk_cluster_arn: builtins.str) -> None:
-            '''Details of an Amazon MSK cluster.
+            '''Details of an Amazon MSK Cluster.
 
-            :param msk_cluster_arn: The ARN of an Amazon MSK cluster.
+            :param msk_cluster_arn: The Amazon Resource Name (ARN) of an Amazon MSK cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-amazonmskcluster.html
             :exampleMetadata: fixture=_generated
@@ -4327,7 +4166,7 @@ class CfnReplicator(
 
         @builtins.property
         def msk_cluster_arn(self) -> builtins.str:
-            '''The ARN of an Amazon MSK cluster.
+            '''The Amazon Resource Name (ARN) of an Amazon MSK cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-amazonmskcluster.html#cfn-msk-replicator-amazonmskcluster-mskclusterarn
             '''
@@ -4365,12 +4204,12 @@ class CfnReplicator(
             detect_and_copy_new_consumer_groups: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
             synchronise_consumer_group_offsets: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         ) -> None:
-            '''Configuration relating to consumer group replication.
+            '''Details about consumer group replication.
 
             :param consumer_groups_to_replicate: List of regular expression patterns indicating the consumer groups to copy.
             :param consumer_groups_to_exclude: List of regular expression patterns indicating the consumer groups that should not be replicated.
-            :param detect_and_copy_new_consumer_groups: Whether to periodically check for new consumer groups.
-            :param synchronise_consumer_group_offsets: Whether to periodically write the translated offsets to __consumer_offsets topic in target cluster.
+            :param detect_and_copy_new_consumer_groups: Enables synchronization of consumer groups to target cluster.
+            :param synchronise_consumer_group_offsets: Enables synchronization of consumer group offsets to target cluster. The translated offsets will be written to topic __consumer_offsets.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-consumergroupreplication.html
             :exampleMetadata: fixture=_generated
@@ -4431,7 +4270,7 @@ class CfnReplicator(
         def detect_and_copy_new_consumer_groups(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''Whether to periodically check for new consumer groups.
+            '''Enables synchronization of consumer groups to target cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-consumergroupreplication.html#cfn-msk-replicator-consumergroupreplication-detectandcopynewconsumergroups
             '''
@@ -4442,7 +4281,9 @@ class CfnReplicator(
         def synchronise_consumer_group_offsets(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''Whether to periodically write the translated offsets to __consumer_offsets topic in target cluster.
+            '''Enables synchronization of consumer group offsets to target cluster.
+
+            The translated offsets will be written to topic __consumer_offsets.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-consumergroupreplication.html#cfn-msk-replicator-consumergroupreplication-synchroniseconsumergroupoffsets
             '''
@@ -4475,10 +4316,10 @@ class CfnReplicator(
             subnet_ids: typing.Sequence[builtins.str],
             security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
         ) -> None:
-            '''Details of an Amazon VPC which has network connectivity to the Kafka cluster.
+            '''Details of an Amazon VPC which has network connectivity to the Apache Kafka cluster.
 
-            :param subnet_ids: The list of subnets to connect to in the virtual private cloud (VPC). AWS creates elastic network interfaces inside these subnets.
-            :param security_group_ids: The AWS security groups to associate with the elastic network interfaces in order to specify what the replicator has access to. If a security group is not specified, the default security group associated with the VPC is used.
+            :param subnet_ids: The list of subnets in the client VPC to connect to.
+            :param security_group_ids: The security groups to attach to the ENIs for the broker nodes.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-kafkaclusterclientvpcconfig.html
             :exampleMetadata: fixture=_generated
@@ -4508,9 +4349,7 @@ class CfnReplicator(
 
         @builtins.property
         def subnet_ids(self) -> typing.List[builtins.str]:
-            '''The list of subnets to connect to in the virtual private cloud (VPC).
-
-            AWS creates elastic network interfaces inside these subnets.
+            '''The list of subnets in the client VPC to connect to.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-kafkaclusterclientvpcconfig.html#cfn-msk-replicator-kafkaclusterclientvpcconfig-subnetids
             '''
@@ -4520,9 +4359,7 @@ class CfnReplicator(
 
         @builtins.property
         def security_group_ids(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''The AWS security groups to associate with the elastic network interfaces in order to specify what the replicator has access to.
-
-            If a security group is not specified, the default security group associated with the VPC is used.
+            '''The security groups to attach to the ENIs for the broker nodes.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-kafkaclusterclientvpcconfig.html#cfn-msk-replicator-kafkaclusterclientvpcconfig-securitygroupids
             '''
@@ -4555,10 +4392,10 @@ class CfnReplicator(
             amazon_msk_cluster: typing.Union[_IResolvable_da3f097b, typing.Union["CfnReplicator.AmazonMskClusterProperty", typing.Dict[builtins.str, typing.Any]]],
             vpc_config: typing.Union[_IResolvable_da3f097b, typing.Union["CfnReplicator.KafkaClusterClientVpcConfigProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''Details of a Kafka cluster for replication.
+            '''Information about Kafka Cluster to be used as source / target for replication.
 
-            :param amazon_msk_cluster: Details of an Amazon MSK cluster.
-            :param vpc_config: Details of an Amazon VPC which has network connectivity to the Kafka cluster.
+            :param amazon_msk_cluster: Details of an Amazon MSK Cluster.
+            :param vpc_config: Details of an Amazon VPC which has network connectivity to the Apache Kafka cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-kafkacluster.html
             :exampleMetadata: fixture=_generated
@@ -4594,7 +4431,7 @@ class CfnReplicator(
         def amazon_msk_cluster(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnReplicator.AmazonMskClusterProperty"]:
-            '''Details of an Amazon MSK cluster.
+            '''Details of an Amazon MSK Cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-kafkacluster.html#cfn-msk-replicator-kafkacluster-amazonmskcluster
             '''
@@ -4606,7 +4443,7 @@ class CfnReplicator(
         def vpc_config(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnReplicator.KafkaClusterClientVpcConfigProperty"]:
-            '''Details of an Amazon VPC which has network connectivity to the Kafka cluster.
+            '''Details of an Amazon VPC which has network connectivity to the Apache Kafka cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-kafkacluster.html#cfn-msk-replicator-kafkacluster-vpcconfig
             '''
@@ -4649,10 +4486,10 @@ class CfnReplicator(
             '''Specifies configuration for replication between a source and target Kafka cluster.
 
             :param consumer_group_replication: Configuration relating to consumer group replication.
-            :param source_kafka_cluster_arn: Amazon Resource Name of the source Kafka cluster.
-            :param target_compression_type: The type of compression to use writing records to target Kafka cluster.
-            :param target_kafka_cluster_arn: Amazon Resource Name of the target Kafka cluster.
-            :param topic_replication: 
+            :param source_kafka_cluster_arn: The ARN of the source Kafka cluster.
+            :param target_compression_type: The compression type to use when producing records to target cluster.
+            :param target_kafka_cluster_arn: The ARN of the target Kafka cluster.
+            :param topic_replication: Configuration relating to topic replication.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-replicationinfo.html
             :exampleMetadata: fixture=_generated
@@ -4721,7 +4558,7 @@ class CfnReplicator(
 
         @builtins.property
         def source_kafka_cluster_arn(self) -> builtins.str:
-            '''Amazon Resource Name of the source Kafka cluster.
+            '''The ARN of the source Kafka cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-replicationinfo.html#cfn-msk-replicator-replicationinfo-sourcekafkaclusterarn
             '''
@@ -4731,7 +4568,7 @@ class CfnReplicator(
 
         @builtins.property
         def target_compression_type(self) -> builtins.str:
-            '''The type of compression to use writing records to target Kafka cluster.
+            '''The compression type to use when producing records to target cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-replicationinfo.html#cfn-msk-replicator-replicationinfo-targetcompressiontype
             '''
@@ -4741,7 +4578,7 @@ class CfnReplicator(
 
         @builtins.property
         def target_kafka_cluster_arn(self) -> builtins.str:
-            '''Amazon Resource Name of the target Kafka cluster.
+            '''The ARN of the target Kafka cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-replicationinfo.html#cfn-msk-replicator-replicationinfo-targetkafkaclusterarn
             '''
@@ -4753,7 +4590,8 @@ class CfnReplicator(
         def topic_replication(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnReplicator.TopicReplicationProperty"]:
-            '''
+            '''Configuration relating to topic replication.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-replicationinfo.html#cfn-msk-replicator-replicationinfo-topicreplication
             '''
             result = self._values.get("topic_replication")
@@ -4778,7 +4616,7 @@ class CfnReplicator(
     )
     class ReplicationStartingPositionProperty:
         def __init__(self, *, type: typing.Optional[builtins.str] = None) -> None:
-            '''Configuration for specifying the position in the topics to start replicating from.
+            '''Specifies the position in the topics to start replicating from.
 
             :param type: The type of replication starting position.
 
@@ -4829,9 +4667,9 @@ class CfnReplicator(
     )
     class ReplicationTopicNameConfigurationProperty:
         def __init__(self, *, type: typing.Optional[builtins.str] = None) -> None:
-            '''Configuration for specifying replicated topic names should be the same as their corresponding upstream topics or prefixed with source cluster alias.
+            '''Configuration for specifying replicated topic names will be the same as their corresponding upstream topics or prefixed with source cluster alias.
 
-            :param type: The type of replicated topic name.
+            :param type: The type of replication topic name configuration, identical to upstream topic name or prefixed with source cluster alias.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-replicationtopicnameconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -4855,7 +4693,7 @@ class CfnReplicator(
 
         @builtins.property
         def type(self) -> typing.Optional[builtins.str]:
-            '''The type of replicated topic name.
+            '''The type of replication topic name configuration, identical to upstream topic name or prefixed with source cluster alias.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-replicationtopicnameconfiguration.html#cfn-msk-replicator-replicationtopicnameconfiguration-type
             '''
@@ -4898,13 +4736,14 @@ class CfnReplicator(
             topic_name_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnReplicator.ReplicationTopicNameConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             topics_to_exclude: typing.Optional[typing.Sequence[builtins.str]] = None,
         ) -> None:
-            '''
+            '''Details about topic replication.
+
             :param topics_to_replicate: List of regular expression patterns indicating the topics to copy.
             :param copy_access_control_lists_for_topics: Whether to periodically configure remote topic ACLs to match their corresponding upstream topics.
             :param copy_topic_configurations: Whether to periodically configure remote topics to match their corresponding upstream topics.
             :param detect_and_copy_new_topics: Whether to periodically check for new topics and partitions.
-            :param starting_position: Configuration for specifying the position in the topics to start replicating from.
-            :param topic_name_configuration: Configuration for specifying replicated topic names should be the same as their corresponding upstream topics or prefixed with source cluster alias.
+            :param starting_position: Specifies the position in the topics to start replicating from.
+            :param topic_name_configuration: Configuration for specifying replicated topic names will be the same as their corresponding upstream topics or prefixed with source cluster alias.
             :param topics_to_exclude: List of regular expression patterns indicating the topics that should not be replicated.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-topicreplication.html
@@ -5004,7 +4843,7 @@ class CfnReplicator(
         def starting_position(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnReplicator.ReplicationStartingPositionProperty"]]:
-            '''Configuration for specifying the position in the topics to start replicating from.
+            '''Specifies the position in the topics to start replicating from.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-topicreplication.html#cfn-msk-replicator-topicreplication-startingposition
             '''
@@ -5015,7 +4854,7 @@ class CfnReplicator(
         def topic_name_configuration(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnReplicator.ReplicationTopicNameConfigurationProperty"]]:
-            '''Configuration for specifying replicated topic names should be the same as their corresponding upstream topics or prefixed with source cluster alias.
+            '''Configuration for specifying replicated topic names will be the same as their corresponding upstream topics or prefixed with source cluster alias.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-replicator-topicreplication.html#cfn-msk-replicator-topicreplication-topicnameconfiguration
             '''
@@ -5070,13 +4909,13 @@ class CfnReplicatorProps:
     ) -> None:
         '''Properties for defining a ``CfnReplicator``.
 
-        :param kafka_clusters: Specifies a list of Kafka clusters which are targets of the replicator.
+        :param kafka_clusters: Kafka Clusters to use in setting up sources / targets for replication.
         :param replication_info_list: A list of replication configurations, where each configuration targets a given source cluster to target cluster replication flow.
-        :param replicator_name: The name of the replicator.
-        :param service_execution_role_arn: The Amazon Resource Name (ARN) of the IAM role used by the replicator to access external resources.
-        :param current_version: The current version of the MSK replicator.
+        :param replicator_name: The name of the replicator. Alpha-numeric characters with '-' are allowed.
+        :param service_execution_role_arn: The ARN of the IAM role used by the replicator to access resources in the customer's account (e.g source and target clusters).
+        :param current_version: The current version number of the replicator.
         :param description: A summary description of the replicator.
-        :param tags: A collection of tags associated with a resource.
+        :param tags: List of tags to attach to created Replicator.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-replicator.html
         :exampleMetadata: fixture=_generated
@@ -5165,7 +5004,7 @@ class CfnReplicatorProps:
     def kafka_clusters(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnReplicator.KafkaClusterProperty]]]:
-        '''Specifies a list of Kafka clusters which are targets of the replicator.
+        '''Kafka Clusters to use in setting up sources / targets for replication.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-replicator.html#cfn-msk-replicator-kafkaclusters
         '''
@@ -5189,6 +5028,8 @@ class CfnReplicatorProps:
     def replicator_name(self) -> builtins.str:
         '''The name of the replicator.
 
+        Alpha-numeric characters with '-' are allowed.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-replicator.html#cfn-msk-replicator-replicatorname
         '''
         result = self._values.get("replicator_name")
@@ -5197,7 +5038,7 @@ class CfnReplicatorProps:
 
     @builtins.property
     def service_execution_role_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the IAM role used by the replicator to access external resources.
+        '''The ARN of the IAM role used by the replicator to access resources in the customer's account (e.g source and target clusters).
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-replicator.html#cfn-msk-replicator-serviceexecutionrolearn
         '''
@@ -5207,7 +5048,7 @@ class CfnReplicatorProps:
 
     @builtins.property
     def current_version(self) -> typing.Optional[builtins.str]:
-        '''The current version of the MSK replicator.
+        '''The current version number of the replicator.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-replicator.html#cfn-msk-replicator-currentversion
         '''
@@ -5225,7 +5066,7 @@ class CfnReplicatorProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''A collection of tags associated with a resource.
+        '''List of tags to attach to created Replicator.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-replicator.html#cfn-msk-replicator-tags
         '''
@@ -5298,7 +5139,7 @@ class CfnServerlessCluster(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param client_authentication: Includes all client authentication information.
+        :param client_authentication: 
         :param cluster_name: 
         :param vpc_configs: 
         :param tags: A key-value pair to associate with a resource.
@@ -5370,7 +5211,6 @@ class CfnServerlessCluster(
     def client_authentication(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, "CfnServerlessCluster.ClientAuthenticationProperty"]:
-        '''Includes all client authentication information.'''
         return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnServerlessCluster.ClientAuthenticationProperty"], jsii.get(self, "clientAuthentication"))
 
     @client_authentication.setter
@@ -5439,9 +5279,8 @@ class CfnServerlessCluster(
             *,
             sasl: typing.Union[_IResolvable_da3f097b, typing.Union["CfnServerlessCluster.SaslProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''Includes all client authentication information.
-
-            :param sasl: Details for client authentication using SASL. To turn on SASL, you must also turn on ``EncryptionInTransit`` by setting ``inCluster`` to true. You must set ``clientBroker`` to either ``TLS`` or ``TLS_PLAINTEXT`` . If you choose ``TLS_PLAINTEXT`` , then you must also set ``unauthenticated`` to true.
+            '''
+            :param sasl: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-serverlesscluster-clientauthentication.html
             :exampleMetadata: fixture=_generated
@@ -5471,10 +5310,7 @@ class CfnServerlessCluster(
         def sasl(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnServerlessCluster.SaslProperty"]:
-            '''Details for client authentication using SASL.
-
-            To turn on SASL, you must also turn on ``EncryptionInTransit`` by setting ``inCluster`` to true. You must set ``clientBroker`` to either ``TLS`` or ``TLS_PLAINTEXT`` . If you choose ``TLS_PLAINTEXT`` , then you must also set ``unauthenticated`` to true.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-serverlesscluster-clientauthentication.html#cfn-msk-serverlesscluster-clientauthentication-sasl
             '''
             result = self._values.get("sasl")
@@ -5503,9 +5339,8 @@ class CfnServerlessCluster(
             *,
             enabled: typing.Union[builtins.bool, _IResolvable_da3f097b],
         ) -> None:
-            '''Details for SASL/IAM client authentication.
-
-            :param enabled: SASL/IAM authentication is enabled or not.
+            '''
+            :param enabled: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-serverlesscluster-iam.html
             :exampleMetadata: fixture=_generated
@@ -5529,8 +5364,7 @@ class CfnServerlessCluster(
 
         @builtins.property
         def enabled(self) -> typing.Union[builtins.bool, _IResolvable_da3f097b]:
-            '''SASL/IAM authentication is enabled or not.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-serverlesscluster-iam.html#cfn-msk-serverlesscluster-iam-enabled
             '''
             result = self._values.get("enabled")
@@ -5559,11 +5393,8 @@ class CfnServerlessCluster(
             *,
             iam: typing.Union[_IResolvable_da3f097b, typing.Union["CfnServerlessCluster.IamProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''Details for client authentication using SASL.
-
-            To turn on SASL, you must also turn on ``EncryptionInTransit`` by setting ``inCluster`` to true. You must set ``clientBroker`` to either ``TLS`` or ``TLS_PLAINTEXT`` . If you choose ``TLS_PLAINTEXT`` , then you must also set ``unauthenticated`` to true.
-
-            :param iam: Details for ClientAuthentication using IAM.
+            '''
+            :param iam: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-serverlesscluster-sasl.html
             :exampleMetadata: fixture=_generated
@@ -5591,8 +5422,7 @@ class CfnServerlessCluster(
         def iam(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnServerlessCluster.IamProperty"]:
-            '''Details for ClientAuthentication using IAM.
-
+            '''
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-serverlesscluster-sasl.html#cfn-msk-serverlesscluster-sasl-iam
             '''
             result = self._values.get("iam")
@@ -5702,7 +5532,7 @@ class CfnServerlessClusterProps:
     ) -> None:
         '''Properties for defining a ``CfnServerlessCluster``.
 
-        :param client_authentication: Includes all client authentication information.
+        :param client_authentication: 
         :param cluster_name: 
         :param vpc_configs: 
         :param tags: A key-value pair to associate with a resource.
@@ -5756,8 +5586,7 @@ class CfnServerlessClusterProps:
     def client_authentication(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, CfnServerlessCluster.ClientAuthenticationProperty]:
-        '''Includes all client authentication information.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-serverlesscluster.html#cfn-msk-serverlesscluster-clientauthentication
         '''
         result = self._values.get("client_authentication")
@@ -5811,7 +5640,7 @@ class CfnVpcConnection(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_msk.CfnVpcConnection",
 ):
-    '''Create remote VPC connection.
+    '''http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html
     :cloudformationResource: AWS::MSK::VpcConnection
@@ -5853,11 +5682,11 @@ class CfnVpcConnection(
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param authentication: The type of private link authentication.
-        :param client_subnets: The list of subnets in the client VPC to connect to.
-        :param security_groups: The security groups to attach to the ENIs for the broker nodes.
-        :param target_cluster_arn: The Amazon Resource Name (ARN) of the cluster.
-        :param vpc_id: The VPC id of the remote client.
-        :param tags: Create tags when creating the VPC connection.
+        :param client_subnets: 
+        :param security_groups: 
+        :param target_cluster_arn: The Amazon Resource Name (ARN) of the target cluster.
+        :param vpc_id: 
+        :param tags: A key-value pair to associate with a resource.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__910be42f1d726644d84801975cd038e26103e9dbcfb02007fe4ebdbeb62c3af8)
@@ -5940,7 +5769,6 @@ class CfnVpcConnection(
     @builtins.property
     @jsii.member(jsii_name="clientSubnets")
     def client_subnets(self) -> typing.List[builtins.str]:
-        '''The list of subnets in the client VPC to connect to.'''
         return typing.cast(typing.List[builtins.str], jsii.get(self, "clientSubnets"))
 
     @client_subnets.setter
@@ -5953,7 +5781,6 @@ class CfnVpcConnection(
     @builtins.property
     @jsii.member(jsii_name="securityGroups")
     def security_groups(self) -> typing.List[builtins.str]:
-        '''The security groups to attach to the ENIs for the broker nodes.'''
         return typing.cast(typing.List[builtins.str], jsii.get(self, "securityGroups"))
 
     @security_groups.setter
@@ -5966,7 +5793,7 @@ class CfnVpcConnection(
     @builtins.property
     @jsii.member(jsii_name="targetClusterArn")
     def target_cluster_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the cluster.'''
+        '''The Amazon Resource Name (ARN) of the target cluster.'''
         return typing.cast(builtins.str, jsii.get(self, "targetClusterArn"))
 
     @target_cluster_arn.setter
@@ -5979,7 +5806,6 @@ class CfnVpcConnection(
     @builtins.property
     @jsii.member(jsii_name="vpcId")
     def vpc_id(self) -> builtins.str:
-        '''The VPC id of the remote client.'''
         return typing.cast(builtins.str, jsii.get(self, "vpcId"))
 
     @vpc_id.setter
@@ -5992,7 +5818,7 @@ class CfnVpcConnection(
     @builtins.property
     @jsii.member(jsii_name="tagsRaw")
     def tags_raw(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''Create tags when creating the VPC connection.'''
+        '''A key-value pair to associate with a resource.'''
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "tagsRaw"))
 
     @tags_raw.setter
@@ -6032,11 +5858,11 @@ class CfnVpcConnectionProps:
         '''Properties for defining a ``CfnVpcConnection``.
 
         :param authentication: The type of private link authentication.
-        :param client_subnets: The list of subnets in the client VPC to connect to.
-        :param security_groups: The security groups to attach to the ENIs for the broker nodes.
-        :param target_cluster_arn: The Amazon Resource Name (ARN) of the cluster.
-        :param vpc_id: The VPC id of the remote client.
-        :param tags: Create tags when creating the VPC connection.
+        :param client_subnets: 
+        :param security_groups: 
+        :param target_cluster_arn: The Amazon Resource Name (ARN) of the target cluster.
+        :param vpc_id: 
+        :param tags: A key-value pair to associate with a resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html
         :exampleMetadata: fixture=_generated
@@ -6090,8 +5916,7 @@ class CfnVpcConnectionProps:
 
     @builtins.property
     def client_subnets(self) -> typing.List[builtins.str]:
-        '''The list of subnets in the client VPC to connect to.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html#cfn-msk-vpcconnection-clientsubnets
         '''
         result = self._values.get("client_subnets")
@@ -6100,8 +5925,7 @@ class CfnVpcConnectionProps:
 
     @builtins.property
     def security_groups(self) -> typing.List[builtins.str]:
-        '''The security groups to attach to the ENIs for the broker nodes.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html#cfn-msk-vpcconnection-securitygroups
         '''
         result = self._values.get("security_groups")
@@ -6110,7 +5934,7 @@ class CfnVpcConnectionProps:
 
     @builtins.property
     def target_cluster_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the cluster.
+        '''The Amazon Resource Name (ARN) of the target cluster.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html#cfn-msk-vpcconnection-targetclusterarn
         '''
@@ -6120,8 +5944,7 @@ class CfnVpcConnectionProps:
 
     @builtins.property
     def vpc_id(self) -> builtins.str:
-        '''The VPC id of the remote client.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html#cfn-msk-vpcconnection-vpcid
         '''
         result = self._values.get("vpc_id")
@@ -6130,7 +5953,7 @@ class CfnVpcConnectionProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''Create tags when creating the VPC connection.
+        '''A key-value pair to associate with a resource.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html#cfn-msk-vpcconnection-tags
         '''