• Public
  • Public/Protected
  • All

Interface CreateClusterCommandInput




Optional clientRequestToken

clientRequestToken: undefined | string

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Optional encryptionConfig

encryptionConfig: EncryptionConfig[]

The encryption configuration for the cluster.

Optional kubernetesNetworkConfig

kubernetesNetworkConfig: KubernetesNetworkConfigRequest

The Kubernetes network configuration for the cluster.

Optional logging

logging: Logging

Enable or disable exporting the Kubernetes control plane logs for your cluster to CloudWatch Logs. By default, cluster control plane logs aren't exported to CloudWatch Logs. For more information, see Amazon EKS Cluster control plane logs in the Amazon EKS User Guide .

CloudWatch Logs ingestion, archive storage, and data scanning rates apply to exported control plane logs. For more information, see CloudWatch Pricing.


name: string | undefined

The unique name to give to your cluster.

Optional outpostConfig

outpostConfig: OutpostConfigRequest

An object representing the configuration of your local Amazon EKS cluster on an Amazon Web Services Outpost. Before creating a local cluster on an Outpost, review Local clusters for Amazon EKS on Amazon Web Services Outposts in the Amazon EKS User Guide. This object isn't available for creating Amazon EKS clusters on the Amazon Web Services cloud.


resourcesVpcConfig: VpcConfigRequest | undefined

The VPC configuration that's used by the cluster control plane. Amazon EKS VPC resources have specific requirements to work properly with Kubernetes. For more information, see Cluster VPC Considerations and Cluster Security Group Considerations in the Amazon EKS User Guide. You must specify at least two subnets. You can specify up to five security groups. However, we recommend that you use a dedicated security group for your cluster control plane.


roleArn: string | undefined

The Amazon Resource Name (ARN) of the IAM role that provides permissions for the Kubernetes control plane to make calls to Amazon Web Services API operations on your behalf. For more information, see Amazon EKS Service IAM Role in the Amazon EKS User Guide .

Optional tags

tags: Record<string, string>

The metadata to apply to the cluster to assist with categorization and organization. Each tag consists of a key and an optional value. You define both.

Optional version

version: undefined | string

The desired Kubernetes version for your cluster. If you don't specify a value here, the default version available in Amazon EKS is used.

The default version might not be the latest version available.