@aws-cdk_aws-msk-alpha.ClusterProps

interface ClusterProps ๐Ÿ”น

LanguageType name
.NETAmazon.CDK.AWS.MSK.Alpha.ClusterProps
Gogithub.com/aws/aws-cdk-go/awscdkmskalpha/v2#ClusterProps
Javasoftware.amazon.awscdk.services.msk.alpha.ClusterProps
Pythonaws_cdk.aws_msk_alpha.ClusterProps
TypeScript (source)@aws-cdk/aws-msk-alpha ยป ClusterProps

Properties for a MSK Cluster.

Example

declare const vpc: ec2.Vpc;
const cluster = new msk.Cluster(this, 'cluster', {
  clusterName: 'myCluster',
  kafkaVersion: msk.KafkaVersion.V2_8_1,
  vpc,
  encryptionInTransit: {
    clientBroker: msk.ClientBrokerEncryption.TLS,
  },
  clientAuthentication: msk.ClientAuthentication.sasl({
    scram: true,
  }),
});

Properties

NameTypeDescription
clusterName๐Ÿ”นstringThe physical name of the cluster.
kafkaVersion๐Ÿ”นKafkaVersionThe version of Apache Kafka.
vpc๐Ÿ”นIVpcDefines the virtual networking environment for this cluster.
clientAuthentication?๐Ÿ”นClientAuthenticationConfiguration properties for client authentication.
configurationInfo?๐Ÿ”นClusterConfigurationInfoThe Amazon MSK configuration to use for the cluster.
ebsStorageInfo?๐Ÿ”นEbsStorageInfoInformation about storage volumes attached to MSK broker nodes.
encryptionInTransit?๐Ÿ”นEncryptionInTransitConfigConfig details for encryption in transit.
instanceType?๐Ÿ”นInstanceTypeThe EC2 instance type that you want Amazon MSK to use when it creates your brokers.
logging?๐Ÿ”นBrokerLoggingConfigure your MSK cluster to send broker logs to different destination types.
monitoring?๐Ÿ”นMonitoringConfigurationCluster monitoring configuration.
numberOfBrokerNodes?๐Ÿ”นnumberNumber of Apache Kafka brokers deployed in each Availability Zone.
removalPolicy?๐Ÿ”นRemovalPolicyWhat to do when this resource is deleted from a stack.
securityGroups?๐Ÿ”นISecurityGroup[]The AWS security groups to associate with the elastic network interfaces in order to specify who can connect to and communicate with the Amazon MSK cluster.
vpcSubnets?๐Ÿ”นSubnetSelectionWhere to place the nodes within the VPC.

clusterName๐Ÿ”น

Type: string

The physical name of the cluster.


kafkaVersion๐Ÿ”น

Type: KafkaVersion

The version of Apache Kafka.


vpc๐Ÿ”น

Type: IVpc

Defines the virtual networking environment for this cluster.

Must have at least 2 subnets in two different AZs.


clientAuthentication?๐Ÿ”น

Type: ClientAuthentication (optional, default: disabled)

Configuration properties for client authentication.

MSK supports using private TLS certificates or SASL/SCRAM to authenticate the identity of clients.


configurationInfo?๐Ÿ”น

Type: ClusterConfigurationInfo (optional, default: none)

The Amazon MSK configuration to use for the cluster.


ebsStorageInfo?๐Ÿ”น

Type: EbsStorageInfo (optional, default: 1000 GiB EBS volume)

Information about storage volumes attached to MSK broker nodes.


encryptionInTransit?๐Ÿ”น

Type: EncryptionInTransitConfig (optional, default: enabled)

Config details for encryption in transit.


instanceType?๐Ÿ”น

Type: InstanceType (optional, default: kafka.m5.large)

The EC2 instance type that you want Amazon MSK to use when it creates your brokers.

See also: https://docs.aws.amazon.com/msk/latest/developerguide/msk-create-cluster.html#broker-instance-types


logging?๐Ÿ”น

Type: BrokerLogging (optional, default: disabled)

Configure your MSK cluster to send broker logs to different destination types.


monitoring?๐Ÿ”น

Type: MonitoringConfiguration (optional, default: DEFAULT monitoring level)

Cluster monitoring configuration.


numberOfBrokerNodes?๐Ÿ”น

Type: number (optional, default: 1)

Number of Apache Kafka brokers deployed in each Availability Zone.


removalPolicy?๐Ÿ”น

Type: RemovalPolicy (optional, default: RemovalPolicy.RETAIN)

What to do when this resource is deleted from a stack.


securityGroups?๐Ÿ”น

Type: ISecurityGroup[] (optional, default: create new security group)

The AWS security groups to associate with the elastic network interfaces in order to specify who can connect to and communicate with the Amazon MSK cluster.


vpcSubnets?๐Ÿ”น

Type: SubnetSelection (optional, default: the Vpc default strategy if not specified.)

Where to place the nodes within the VPC.

Amazon MSK distributes the broker nodes evenly across the subnets that you specify. The subnets that you specify must be in distinct Availability Zones. Client subnets can't be in Availability Zone us-east-1e.