aws-cdk-lib 2.182.0__py3-none-any.whl → 2.184.0__py3-none-any.whl

aws_cdk/aws_msk/__init__.py

@@ -81,7 +81,7 @@ class CfnBatchScramSecret(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_msk.CfnBatchScramSecret",
 ):
-    '''http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-batchscramsecret.html.
+    '''Represents a secret stored in the AWS Secrets Manager that can be used to authenticate with a cluster using a user name and a password.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-batchscramsecret.html
     :cloudformationResource: AWS::MSK::BatchScramSecret
@@ -112,8 +112,8 @@ class CfnBatchScramSecret(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param cluster_arn: 
-        :param secret_arn_list: 
+        :param cluster_arn: The Amazon Resource Name (ARN) that uniquely identifies the cluster.
+        :param secret_arn_list: List of Amazon Resource Name (ARN)s of Secrets Manager secrets.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__7520d411e2ff468c392c477234cb67e342bdaac914895933d982e659ed9e98a4)
@@ -163,6 +163,7 @@ class CfnBatchScramSecret(
     @builtins.property
     @jsii.member(jsii_name="clusterArn")
     def cluster_arn(self) -> builtins.str:
+        '''The Amazon Resource Name (ARN) that uniquely identifies the cluster.'''
         return typing.cast(builtins.str, jsii.get(self, "clusterArn"))
 
     @cluster_arn.setter
@@ -175,6 +176,7 @@ class CfnBatchScramSecret(
     @builtins.property
     @jsii.member(jsii_name="secretArnList")
     def secret_arn_list(self) -> typing.Optional[typing.List[builtins.str]]:
+        '''List of Amazon Resource Name (ARN)s of Secrets Manager secrets.'''
         return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "secretArnList"))
 
     @secret_arn_list.setter
@@ -202,8 +204,8 @@ class CfnBatchScramSecretProps:
     ) -> None:
         '''Properties for defining a ``CfnBatchScramSecret``.
 
-        :param cluster_arn: 
-        :param secret_arn_list: 
+        :param cluster_arn: The Amazon Resource Name (ARN) that uniquely identifies the cluster.
+        :param secret_arn_list: List of Amazon Resource Name (ARN)s of Secrets Manager secrets.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-batchscramsecret.html
         :exampleMetadata: fixture=_generated
@@ -233,7 +235,8 @@ class CfnBatchScramSecretProps:
 
     @builtins.property
     def cluster_arn(self) -> builtins.str:
-        '''
+        '''The Amazon Resource Name (ARN) that uniquely identifies the cluster.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-batchscramsecret.html#cfn-msk-batchscramsecret-clusterarn
         '''
         result = self._values.get("cluster_arn")
@@ -242,7 +245,8 @@ class CfnBatchScramSecretProps:
 
     @builtins.property
     def secret_arn_list(self) -> typing.Optional[typing.List[builtins.str]]:
-        '''
+        '''List of Amazon Resource Name (ARN)s of Secrets Manager secrets.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-batchscramsecret.html#cfn-msk-batchscramsecret-secretarnlist
         '''
         result = self._values.get("secret_arn_list")
@@ -266,7 +270,14 @@ class CfnCluster(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_msk.CfnCluster",
 ):
-    '''http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html.
+    '''Creates a new MSK cluster.
+
+    The following Python 3.6 example shows how you can create a cluster that's distributed across two `Availability Zones <https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-availability-zones.html>`_ . 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 across a number of Availability Zones that's equal to the number of subnets that you specify in the ``BrokerNodeGroupInfo`` parameter. In the following example, you can add a third subnet to get a cluster that's distributed across 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)
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html
     :cloudformationResource: AWS::MSK::Cluster
@@ -415,19 +426,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: 
-        :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.
+        :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 `supported Apache Kafka versions <https://docs.aws.amazon.com/msk/latest/developerguide/supported-kafka-versions.html>`_ .
+        :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.
+        :param logging_info: Logging info details for the cluster.
+        :param open_monitoring: The settings for open monitoring.
+        :param storage_mode: This controls storage mode for supported storage tiers.
+        :param tags: An arbitrary set of tags (key-value pairs) for the cluster.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__d267b4b2dcfdda539084655e7a1234ffaf8e77376f37d4914abbcef6c64e9f1c)
@@ -484,7 +495,8 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="attrArn")
     def attr_arn(self) -> builtins.str:
-        '''
+        '''The Amazon Resource Name (ARN) of the MSK cluster.
+
         :cloudformationAttribute: Arn
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrArn"))
@@ -505,6 +517,7 @@ 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
@@ -520,6 +533,7 @@ 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
@@ -532,6 +546,7 @@ 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
@@ -544,6 +559,7 @@ 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
@@ -558,6 +574,7 @@ 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
@@ -575,6 +592,7 @@ 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
@@ -590,7 +608,7 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="currentVersion")
     def current_version(self) -> typing.Optional[builtins.str]:
-        '''The current version of the MSK cluster.'''
+        '''The version of the cluster that you want to update.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "currentVersion"))
 
     @current_version.setter
@@ -605,6 +623,7 @@ 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
@@ -620,6 +639,7 @@ 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
@@ -634,6 +654,7 @@ class CfnCluster(
     def logging_info(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.LoggingInfoProperty"]]:
+        '''Logging info details for the cluster.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.LoggingInfoProperty"]], jsii.get(self, "loggingInfo"))
 
     @logging_info.setter
@@ -651,6 +672,7 @@ 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,6 +688,7 @@ 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
@@ -678,7 +701,7 @@ class CfnCluster(
     @builtins.property
     @jsii.member(jsii_name="tagsRaw")
     def tags_raw(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''A key-value pair to associate with a resource.'''
+        '''An arbitrary set of tags (key-value pairs) for the cluster.'''
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "tagsRaw"))
 
     @tags_raw.setter
@@ -821,13 +844,14 @@ 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:
-            '''
-            :param client_subnets: 
+            '''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 (ENIs) inside these subnets. Client applications use ENIs 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 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: 
-            :param connectivity_info: 
-            :param security_groups: 
-            :param storage_info: 
+            :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 ENIs 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.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html
             :exampleMetadata: fixture=_generated
@@ -899,7 +923,14 @@ 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 (ENIs) inside these subnets. Client applications use ENIs 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")
@@ -920,7 +951,8 @@ 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")
@@ -930,7 +962,8 @@ 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")
@@ -938,7 +971,10 @@ class CfnCluster(
 
         @builtins.property
         def security_groups(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''
+            '''The security groups to associate with the ENIs 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")
@@ -948,7 +984,8 @@ 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")
@@ -1428,9 +1465,10 @@ class CfnCluster(
             client_broker: typing.Optional[builtins.str] = None,
             in_cluster: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         ) -> None:
-            '''
-            :param client_broker: 
-            :param in_cluster: 
+            '''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`` : Indicates that client-broker communication is enabled with TLS only. - ``TLS_PLAINTEXT`` : Indicates that client-broker communication is enabled for both TLS-encrypted, as well as plaintext data. - ``PLAINTEXT`` : Indicates 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.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionintransit.html
             :exampleMetadata: fixture=_generated
@@ -1458,7 +1496,16 @@ 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`` : Indicates that client-broker communication is enabled with TLS only.
+            - ``TLS_PLAINTEXT`` : Indicates that client-broker communication is enabled for both TLS-encrypted, as well as plaintext data.
+            - ``PLAINTEXT`` : Indicates 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")
@@ -1468,7 +1515,12 @@ 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")
@@ -1502,7 +1554,7 @@ class CfnCluster(
         ) -> None:
             '''
             :param encryption_at_rest: 
-            :param encryption_in_transit: 
+            :param encryption_in_transit: The details for encryption in transit.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptioninfo.html
             :exampleMetadata: fixture=_generated
@@ -1547,7 +1599,8 @@ 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")
@@ -3146,19 +3199,19 @@ class CfnClusterProps:
     ) -> None:
         '''Properties for defining a ``CfnCluster``.
 
-        :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.
+        :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 `supported Apache Kafka versions <https://docs.aws.amazon.com/msk/latest/developerguide/supported-kafka-versions.html>`_ .
+        :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.
+        :param logging_info: Logging info details for the cluster.
+        :param open_monitoring: The settings for open monitoring.
+        :param storage_mode: This controls storage mode for supported storage tiers.
+        :param tags: An arbitrary set of tags (key-value pairs) for the cluster.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html
         :exampleMetadata: fixture=_generated
@@ -3327,7 +3380,8 @@ 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")
@@ -3336,7 +3390,8 @@ 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")
@@ -3345,7 +3400,10 @@ 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 `supported Apache Kafka versions <https://docs.aws.amazon.com/msk/latest/developerguide/supported-kafka-versions.html>`_ .
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-kafkaversion
         '''
         result = self._values.get("kafka_version")
@@ -3354,7 +3412,8 @@ 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")
@@ -3365,7 +3424,8 @@ 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")
@@ -3375,7 +3435,8 @@ 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")
@@ -3383,7 +3444,7 @@ class CfnClusterProps:
 
     @builtins.property
     def current_version(self) -> typing.Optional[builtins.str]:
-        '''The current version of the MSK cluster.
+        '''The version of the cluster that you want to update.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-currentversion
         '''
@@ -3394,7 +3455,8 @@ 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")
@@ -3402,7 +3464,8 @@ class CfnClusterProps:
 
     @builtins.property
     def enhanced_monitoring(self) -> typing.Optional[builtins.str]:
-        '''
+        '''Specifies the level of monitoring for the MSK cluster.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-enhancedmonitoring
         '''
         result = self._values.get("enhanced_monitoring")
@@ -3412,7 +3475,8 @@ class CfnClusterProps:
     def logging_info(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCluster.LoggingInfoProperty]]:
-        '''
+        '''Logging info details for the cluster.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-logginginfo
         '''
         result = self._values.get("logging_info")
@@ -3422,7 +3486,8 @@ 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")
@@ -3430,7 +3495,8 @@ 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")
@@ -3438,7 +3504,7 @@ class CfnClusterProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''A key-value pair to associate with a resource.
+        '''An arbitrary set of tags (key-value pairs) for the cluster.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-tags
         '''
@@ -3463,7 +3529,16 @@ class CfnConfiguration(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_msk.CfnConfiguration",
 ):
-    '''http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html.
+    '''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)
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html
     :cloudformationResource: AWS::MSK::Configuration
@@ -3504,11 +3579,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: 
-        :param server_properties: 
-        :param description: 
-        :param kafka_versions_list: 
-        :param latest_revision: 
+        :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 this property, you must ensure that the contents of the file are base64 encoded. When using the console, the SDK, or the AWS CLI , the contents of ``server.properties`` can be in plaintext.
+        :param description: The description of the configuration.
+        :param kafka_versions_list: The `versions of Apache Kafka <https://docs.aws.amazon.com/msk/latest/developerguide/supported-kafka-versions.html>`_ with which you can use this MSK configuration.
+        :param latest_revision: Latest revision of the MSK configuration.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__4496d16ab1313e2d6e75f55fc7cdb170962f756c6dc1149245dde1aba3113278)
@@ -3557,7 +3632,8 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="attrArn")
     def attr_arn(self) -> builtins.str:
-        '''
+        '''The Amazon Resource Name (ARN) of the configuration.
+
         :cloudformationAttribute: Arn
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrArn"))
@@ -3565,7 +3641,8 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="attrLatestRevisionCreationTime")
     def attr_latest_revision_creation_time(self) -> builtins.str:
-        '''
+        '''The time when the configuration revision was created.
+
         :cloudformationAttribute: LatestRevision.CreationTime
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrLatestRevisionCreationTime"))
@@ -3573,7 +3650,8 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="attrLatestRevisionDescription")
     def attr_latest_revision_description(self) -> builtins.str:
-        '''
+        '''The description of the configuration revision.
+
         :cloudformationAttribute: LatestRevision.Description
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrLatestRevisionDescription"))
@@ -3581,7 +3659,8 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="attrLatestRevisionRevision")
     def attr_latest_revision_revision(self) -> jsii.Number:
-        '''
+        '''The revision number.
+
         :cloudformationAttribute: LatestRevision.Revision
         '''
         return typing.cast(jsii.Number, jsii.get(self, "attrLatestRevisionRevision"))
@@ -3594,6 +3673,7 @@ 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
@@ -3606,6 +3686,7 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="serverProperties")
     def server_properties(self) -> builtins.str:
+        '''Contents of the ``server.properties`` file. When using this property, you must ensure that the contents of the file are base64 encoded. When using the console, the SDK, or the AWS CLI , the contents of ``server.properties`` can be in plaintext.'''
         return typing.cast(builtins.str, jsii.get(self, "serverProperties"))
 
     @server_properties.setter
@@ -3618,6 +3699,7 @@ 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
@@ -3630,6 +3712,7 @@ class CfnConfiguration(
     @builtins.property
     @jsii.member(jsii_name="kafkaVersionsList")
     def kafka_versions_list(self) -> typing.Optional[typing.List[builtins.str]]:
+        '''The `versions of Apache Kafka <https://docs.aws.amazon.com/msk/latest/developerguide/supported-kafka-versions.html>`_ with which you can use this MSK configuration.'''
         return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "kafkaVersionsList"))
 
     @kafka_versions_list.setter
@@ -3647,6 +3730,7 @@ class CfnConfiguration(
     def latest_revision(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnConfiguration.LatestRevisionProperty"]]:
+        '''Latest revision of the MSK configuration.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnConfiguration.LatestRevisionProperty"]], jsii.get(self, "latestRevision"))
 
     @latest_revision.setter
@@ -3676,10 +3760,11 @@ class CfnConfiguration(
             description: typing.Optional[builtins.str] = None,
             revision: typing.Optional[jsii.Number] = None,
         ) -> None:
-            '''
-            :param creation_time: 
-            :param description: 
-            :param revision: 
+            '''Describes a configuration revision.
+
+            :param creation_time: The time when the configuration revision was created.
+            :param description: The description of the configuration revision.
+            :param revision: The revision number.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-configuration-latestrevision.html
             :exampleMetadata: fixture=_generated
@@ -3711,7 +3796,8 @@ class CfnConfiguration(
 
         @builtins.property
         def creation_time(self) -> typing.Optional[builtins.str]:
-            '''
+            '''The time when the configuration revision was created.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-configuration-latestrevision.html#cfn-msk-configuration-latestrevision-creationtime
             '''
             result = self._values.get("creation_time")
@@ -3719,7 +3805,8 @@ class CfnConfiguration(
 
         @builtins.property
         def description(self) -> typing.Optional[builtins.str]:
-            '''
+            '''The description of the configuration revision.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-configuration-latestrevision.html#cfn-msk-configuration-latestrevision-description
             '''
             result = self._values.get("description")
@@ -3727,7 +3814,8 @@ class CfnConfiguration(
 
         @builtins.property
         def revision(self) -> typing.Optional[jsii.Number]:
-            '''
+            '''The revision number.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-configuration-latestrevision.html#cfn-msk-configuration-latestrevision-revision
             '''
             result = self._values.get("revision")
@@ -3768,11 +3856,11 @@ class CfnConfigurationProps:
     ) -> None:
         '''Properties for defining a ``CfnConfiguration``.
 
-        :param name: 
-        :param server_properties: 
-        :param description: 
-        :param kafka_versions_list: 
-        :param latest_revision: 
+        :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 this property, you must ensure that the contents of the file are base64 encoded. When using the console, the SDK, or the AWS CLI , the contents of ``server.properties`` can be in plaintext.
+        :param description: The description of the configuration.
+        :param kafka_versions_list: The `versions of Apache Kafka <https://docs.aws.amazon.com/msk/latest/developerguide/supported-kafka-versions.html>`_ with which you can use this MSK configuration.
+        :param latest_revision: Latest revision of the MSK configuration.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html
         :exampleMetadata: fixture=_generated
@@ -3817,7 +3905,10 @@ 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")
@@ -3826,7 +3917,8 @@ class CfnConfigurationProps:
 
     @builtins.property
     def server_properties(self) -> builtins.str:
-        '''
+        '''Contents of the ``server.properties`` file. When using this property, you must ensure that the contents of the file are base64 encoded. When using the console, the SDK, or the AWS 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")
@@ -3835,7 +3927,8 @@ 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")
@@ -3843,7 +3936,8 @@ class CfnConfigurationProps:
 
     @builtins.property
     def kafka_versions_list(self) -> typing.Optional[typing.List[builtins.str]]:
-        '''
+        '''The `versions of Apache Kafka <https://docs.aws.amazon.com/msk/latest/developerguide/supported-kafka-versions.html>`_ with which you can use this MSK configuration.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-configuration.html#cfn-msk-configuration-kafkaversionslist
         '''
         result = self._values.get("kafka_versions_list")
@@ -3853,7 +3947,8 @@ class CfnConfigurationProps:
     def latest_revision(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnConfiguration.LatestRevisionProperty]]:
-        '''
+        '''Latest revision of the MSK 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")
@@ -5091,7 +5186,7 @@ class CfnServerlessCluster(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_msk.CfnServerlessCluster",
 ):
-    '''http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-serverlesscluster.html.
+    '''Specifies the properties required for creating a serverless cluster.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-serverlesscluster.html
     :cloudformationResource: AWS::MSK::ServerlessCluster
@@ -5139,10 +5234,10 @@ 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: 
-        :param cluster_name: 
-        :param vpc_configs: 
-        :param tags: A key-value pair to associate with a resource.
+        :param client_authentication: Includes all client authentication related information.
+        :param cluster_name: The name of the cluster.
+        :param vpc_configs: VPC configuration information for the serverless cluster.
+        :param tags: An arbitrary set of tags (key-value pairs) for the cluster.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__aef99cf7cce653b94ea5543af8d6966cab3ba1c8ff81b50f8736048fff8227ff)
@@ -5190,7 +5285,8 @@ class CfnServerlessCluster(
     @builtins.property
     @jsii.member(jsii_name="attrArn")
     def attr_arn(self) -> builtins.str:
-        '''
+        '''The Amazon Resource Name (ARN) of the MSK cluster.
+
         :cloudformationAttribute: Arn
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrArn"))
@@ -5211,6 +5307,7 @@ class CfnServerlessCluster(
     def client_authentication(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, "CfnServerlessCluster.ClientAuthenticationProperty"]:
+        '''Includes all client authentication related information.'''
         return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnServerlessCluster.ClientAuthenticationProperty"], jsii.get(self, "clientAuthentication"))
 
     @client_authentication.setter
@@ -5226,6 +5323,7 @@ class CfnServerlessCluster(
     @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
@@ -5240,6 +5338,7 @@ class CfnServerlessCluster(
     def vpc_configs(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnServerlessCluster.VpcConfigProperty"]]]:
+        '''VPC configuration information for the serverless cluster.'''
         return typing.cast(typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnServerlessCluster.VpcConfigProperty"]]], jsii.get(self, "vpcConfigs"))
 
     @vpc_configs.setter
@@ -5255,7 +5354,7 @@ class CfnServerlessCluster(
     @builtins.property
     @jsii.member(jsii_name="tagsRaw")
     def tags_raw(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''A key-value pair to associate with a resource.'''
+        '''An arbitrary set of tags (key-value pairs) for the cluster.'''
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "tagsRaw"))
 
     @tags_raw.setter
@@ -5532,10 +5631,10 @@ class CfnServerlessClusterProps:
     ) -> None:
         '''Properties for defining a ``CfnServerlessCluster``.
 
-        :param client_authentication: 
-        :param cluster_name: 
-        :param vpc_configs: 
-        :param tags: A key-value pair to associate with a resource.
+        :param client_authentication: Includes all client authentication related information.
+        :param cluster_name: The name of the cluster.
+        :param vpc_configs: VPC configuration information for the serverless cluster.
+        :param tags: An arbitrary set of tags (key-value pairs) for the cluster.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-serverlesscluster.html
         :exampleMetadata: fixture=_generated
@@ -5586,7 +5685,8 @@ class CfnServerlessClusterProps:
     def client_authentication(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, CfnServerlessCluster.ClientAuthenticationProperty]:
-        '''
+        '''Includes all client authentication related 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")
@@ -5595,7 +5695,8 @@ class CfnServerlessClusterProps:
 
     @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-serverlesscluster.html#cfn-msk-serverlesscluster-clustername
         '''
         result = self._values.get("cluster_name")
@@ -5606,7 +5707,8 @@ class CfnServerlessClusterProps:
     def vpc_configs(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnServerlessCluster.VpcConfigProperty]]]:
-        '''
+        '''VPC configuration information for the serverless cluster.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-serverlesscluster.html#cfn-msk-serverlesscluster-vpcconfigs
         '''
         result = self._values.get("vpc_configs")
@@ -5615,7 +5717,7 @@ class CfnServerlessClusterProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''A key-value pair to associate with a resource.
+        '''An arbitrary set of tags (key-value pairs) for the cluster.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-serverlesscluster.html#cfn-msk-serverlesscluster-tags
         '''
@@ -5640,7 +5742,7 @@ class CfnVpcConnection(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_msk.CfnVpcConnection",
 ):
-    '''http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html.
+    '''Create remote VPC connection.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html
     :cloudformationResource: AWS::MSK::VpcConnection
@@ -5682,11 +5784,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: 
-        :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.
+        :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: An arbitrary set of tags (key-value pairs) you specify while creating the VPC connection.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__910be42f1d726644d84801975cd038e26103e9dbcfb02007fe4ebdbeb62c3af8)
@@ -5769,6 +5871,7 @@ 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
@@ -5781,6 +5884,7 @@ 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
@@ -5793,7 +5897,7 @@ class CfnVpcConnection(
     @builtins.property
     @jsii.member(jsii_name="targetClusterArn")
     def target_cluster_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the target cluster.'''
+        '''The Amazon Resource Name (ARN) of the cluster.'''
         return typing.cast(builtins.str, jsii.get(self, "targetClusterArn"))
 
     @target_cluster_arn.setter
@@ -5806,6 +5910,7 @@ 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
@@ -5818,7 +5923,7 @@ class CfnVpcConnection(
     @builtins.property
     @jsii.member(jsii_name="tagsRaw")
     def tags_raw(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''A key-value pair to associate with a resource.'''
+        '''An arbitrary set of tags (key-value pairs) you specify while creating the VPC connection.'''
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "tagsRaw"))
 
     @tags_raw.setter
@@ -5858,11 +5963,11 @@ class CfnVpcConnectionProps:
         '''Properties for defining a ``CfnVpcConnection``.
 
         :param authentication: The type of private link authentication.
-        :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.
+        :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: An arbitrary set of tags (key-value pairs) you specify while creating the VPC connection.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html
         :exampleMetadata: fixture=_generated
@@ -5916,7 +6021,8 @@ 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")
@@ -5925,7 +6031,8 @@ 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")
@@ -5934,7 +6041,7 @@ class CfnVpcConnectionProps:
 
     @builtins.property
     def target_cluster_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) of the target cluster.
+        '''The Amazon Resource Name (ARN) of the cluster.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html#cfn-msk-vpcconnection-targetclusterarn
         '''
@@ -5944,7 +6051,8 @@ 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")
@@ -5953,7 +6061,7 @@ class CfnVpcConnectionProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''A key-value pair to associate with a resource.
+        '''An arbitrary set of tags (key-value pairs) you specify while creating the VPC connection.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-vpcconnection.html#cfn-msk-vpcconnection-tags
         '''