# KubernetesVersion

Kubernetes cluster version.

- Source: [`aws-eks/lib/cluster.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0/packages/aws-cdk-lib/aws-eks/lib/cluster.ts#L938)
- Type last changed: v2.263.0 · 31 Jul 2026

## Example

```ts
import { KubectlV36Layer } from '@aws-cdk/lambda-layer-kubectl-v36';

const cluster = new eks.Cluster(this, 'HelloEKS', {
  version: eks.KubernetesVersion.V1_36,
  defaultCapacity: 0,
  kubectlLayer: new KubectlV36Layer(this, 'kubectl'),
});

cluster.addNodegroupCapacity('custom-node-group', {
  instanceTypes: [new ec2.InstanceType('m5.large')],
  minSize: 4,
  diskSize: 100,
});
```

## Properties

- `V1_14`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Use newer version of EKS

- `V1_15`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Use newer version of EKS

- `V1_16`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Use newer version of EKS

- `V1_17`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Use newer version of EKS

- `V1_18`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Use newer version of EKS

- `V1_19`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Use newer version of EKS

- `V1_20`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Use newer version of EKS

- `V1_21`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Use newer version of EKS

- `V1_22`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Use newer version of EKS

- `V1_23`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.23.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV23Layer` from
  `@aws-cdk/lambda-layer-kubectl-v23`.

- `V1_24`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.24.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV24Layer` from
  `@aws-cdk/lambda-layer-kubectl-v24`.

- `V1_25`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.25.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV25Layer` from
  `@aws-cdk/lambda-layer-kubectl-v25`.

- `V1_26`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.26.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV26Layer` from
  `@aws-cdk/lambda-layer-kubectl-v26`.

- `V1_27`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.27.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV27Layer` from
  `@aws-cdk/lambda-layer-kubectl-v27`.

- `V1_28`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.28.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV28Layer` from
  `@aws-cdk/lambda-layer-kubectl-v28`.

- `V1_29`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.29.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV29Layer` from
  `@aws-cdk/lambda-layer-kubectl-v29`.

- `V1_30`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.30.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV30Layer` from
  `@aws-cdk/lambda-layer-kubectl-v30`.

- `V1_31`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.31.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV31Layer` from
  `@aws-cdk/lambda-layer-kubectl-v31`.

- `V1_32`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.32.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV32Layer` from
  `@aws-cdk/lambda-layer-kubectl-v32`.

- `V1_33`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.33.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV33Layer` from
  `@aws-cdk/lambda-layer-kubectl-v33`.

- `V1_34`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.34.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV34Layer` from
  `@aws-cdk/lambda-layer-kubectl-v34`.

- `V1_35`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.35.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV35Layer` from
  `@aws-cdk/lambda-layer-kubectl-v35`.

- `V1_36`: [KubernetesVersion](/cdk/api/v2/docs/aws-cdk-lib.aws_eks.KubernetesVersion.html) (static) — Kubernetes version 1.36.

  When creating a `Cluster` with this version, you need to also specify the
  `kubectlLayer` property with a `KubectlV36Layer` from
  `@aws-cdk/lambda-layer-kubectl-v36`.

- `version`: string — cluster version number.

## Methods

- `of(version: string): KubernetesVersion // chainable` (static) — Custom cluster version.

  **Parameters**

  - `version` — custom version number.