1. Packages
  2. AWS
  3. API Docs
  4. eks
  5. getClusterVersions
Viewing docs for AWS v6.83.1 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-aws

aws.eks.getClusterVersions

aws logo
Viewing docs for AWS v6.83.1 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-aws

    Data source for managing AWS EKS (Elastic Kubernetes) Cluster Versions.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = aws.eks.getClusterVersions({});

    import pulumi
import pulumi_aws as aws

example = aws.eks.get_cluster_versions()

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/eks"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := eks.GetClusterVersions(ctx, &eks.GetClusterVersionsArgs{}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.Eks.GetClusterVersions.Invoke();

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.eks.EksFunctions;
import com.pulumi.aws.eks.inputs.GetClusterVersionsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = EksFunctions.getClusterVersions(GetClusterVersionsArgs.builder()
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: aws:eks:getClusterVersions
      arguments: {}

    Filter by Cluster Type

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = aws.eks.getClusterVersions({
    clusterType: "eks",
});

    import pulumi
import pulumi_aws as aws

example = aws.eks.get_cluster_versions(cluster_type="eks")

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/eks"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := eks.GetClusterVersions(ctx, &eks.GetClusterVersionsArgs{
			ClusterType: pulumi.StringRef("eks"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.Eks.GetClusterVersions.Invoke(new()
    {
        ClusterType = "eks",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.eks.EksFunctions;
import com.pulumi.aws.eks.inputs.GetClusterVersionsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = EksFunctions.getClusterVersions(GetClusterVersionsArgs.builder()
            .clusterType("eks")
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: aws:eks:getClusterVersions
      arguments:
        clusterType: eks

    Filter by Version Status

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = aws.eks.getClusterVersions({
    versionStatus: "STANDARD_SUPPORT",
});

    import pulumi
import pulumi_aws as aws

example = aws.eks.get_cluster_versions(version_status="STANDARD_SUPPORT")

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/eks"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := eks.GetClusterVersions(ctx, &eks.GetClusterVersionsArgs{
			VersionStatus: pulumi.StringRef("STANDARD_SUPPORT"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.Eks.GetClusterVersions.Invoke(new()
    {
        VersionStatus = "STANDARD_SUPPORT",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.eks.EksFunctions;
import com.pulumi.aws.eks.inputs.GetClusterVersionsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = EksFunctions.getClusterVersions(GetClusterVersionsArgs.builder()
            .versionStatus("STANDARD_SUPPORT")
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: aws:eks:getClusterVersions
      arguments:
        versionStatus: STANDARD_SUPPORT

    Using getClusterVersions

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getClusterVersions(args: GetClusterVersionsArgs, opts?: InvokeOptions): Promise<GetClusterVersionsResult>
function getClusterVersionsOutput(args: GetClusterVersionsOutputArgs, opts?: InvokeOptions): Output<GetClusterVersionsResult>
    def get_cluster_versions(cluster_type: Optional[str] = None,
                         cluster_versions_onlies: Optional[Sequence[str]] = None,
                         default_only: Optional[bool] = None,
                         include_all: Optional[bool] = None,
                         version_status: Optional[str] = None,
                         opts: Optional[InvokeOptions] = None) -> GetClusterVersionsResult
def get_cluster_versions_output(cluster_type: Optional[pulumi.Input[str]] = None,
                         cluster_versions_onlies: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                         default_only: Optional[pulumi.Input[bool]] = None,
                         include_all: Optional[pulumi.Input[bool]] = None,
                         version_status: Optional[pulumi.Input[str]] = None,
                         opts: Optional[InvokeOptions] = None) -> Output[GetClusterVersionsResult]
    func GetClusterVersions(ctx *Context, args *GetClusterVersionsArgs, opts ...InvokeOption) (*GetClusterVersionsResult, error)
func GetClusterVersionsOutput(ctx *Context, args *GetClusterVersionsOutputArgs, opts ...InvokeOption) GetClusterVersionsResultOutput

    > Note: This function is named GetClusterVersions in the Go SDK.

    public static class GetClusterVersions 
{
    public static Task<GetClusterVersionsResult> InvokeAsync(GetClusterVersionsArgs args, InvokeOptions? opts = null)
    public static Output<GetClusterVersionsResult> Invoke(GetClusterVersionsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetClusterVersionsResult> getClusterVersions(GetClusterVersionsArgs args, InvokeOptions options)
public static Output<GetClusterVersionsResult> getClusterVersions(GetClusterVersionsArgs args, InvokeOptions options)

    fn::invoke:
  function: aws:eks/getClusterVersions:getClusterVersions
  arguments:
    # arguments dictionary

    The following arguments are supported:

    ClusterType string
    Type of clusters to filter by. Currently, the only valid value is eks.
    ClusterVersionsOnlies List<string>
    DefaultOnly bool
    Whether to show only the default versions of Kubernetes supported by EKS.
    IncludeAll bool
    Whether to include all kubernetes versions in the response.
    VersionStatus string
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    ClusterType string
    Type of clusters to filter by. Currently, the only valid value is eks.
    ClusterVersionsOnlies []string
    DefaultOnly bool
    Whether to show only the default versions of Kubernetes supported by EKS.
    IncludeAll bool
    Whether to include all kubernetes versions in the response.
    VersionStatus string
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    clusterType String
    Type of clusters to filter by. Currently, the only valid value is eks.
    clusterVersionsOnlies List<String>
    defaultOnly Boolean
    Whether to show only the default versions of Kubernetes supported by EKS.
    includeAll Boolean
    Whether to include all kubernetes versions in the response.
    versionStatus String
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    clusterType string
    Type of clusters to filter by. Currently, the only valid value is eks.
    clusterVersionsOnlies string[]
    defaultOnly boolean
    Whether to show only the default versions of Kubernetes supported by EKS.
    includeAll boolean
    Whether to include all kubernetes versions in the response.
    versionStatus string
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    cluster_type str
    Type of clusters to filter by. Currently, the only valid value is eks.
    cluster_versions_onlies Sequence[str]
    default_only bool
    Whether to show only the default versions of Kubernetes supported by EKS.
    include_all bool
    Whether to include all kubernetes versions in the response.
    version_status str
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    clusterType String
    Type of clusters to filter by. Currently, the only valid value is eks.
    clusterVersionsOnlies List<String>
    defaultOnly Boolean
    Whether to show only the default versions of Kubernetes supported by EKS.
    includeAll Boolean
    Whether to include all kubernetes versions in the response.
    versionStatus String
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.

    getClusterVersions Result

    The following output properties are available:

    ClusterVersions List<GetClusterVersionsClusterVersion>
    Id string
    The provider-assigned unique ID for this managed resource.
    ClusterType string
    Type of cluster that the version belongs to.
    ClusterVersionsOnlies List<string>
    DefaultOnly bool
    IncludeAll bool
    VersionStatus string
    Status of the EKS cluster version.
    ClusterVersions []GetClusterVersionsClusterVersion
    Id string
    The provider-assigned unique ID for this managed resource.
    ClusterType string
    Type of cluster that the version belongs to.
    ClusterVersionsOnlies []string
    DefaultOnly bool
    IncludeAll bool
    VersionStatus string
    Status of the EKS cluster version.
    clusterVersions List<GetClusterVersionsClusterVersion>
    id String
    The provider-assigned unique ID for this managed resource.
    clusterType String
    Type of cluster that the version belongs to.
    clusterVersionsOnlies List<String>
    defaultOnly Boolean
    includeAll Boolean
    versionStatus String
    Status of the EKS cluster version.
    clusterVersions GetClusterVersionsClusterVersion[]
    id string
    The provider-assigned unique ID for this managed resource.
    clusterType string
    Type of cluster that the version belongs to.
    clusterVersionsOnlies string[]
    defaultOnly boolean
    includeAll boolean
    versionStatus string
    Status of the EKS cluster version.
    cluster_versions Sequence[GetClusterVersionsClusterVersion]
    id str
    The provider-assigned unique ID for this managed resource.
    cluster_type str
    Type of cluster that the version belongs to.
    cluster_versions_onlies Sequence[str]
    default_only bool
    include_all bool
    version_status str
    Status of the EKS cluster version.
    clusterVersions List<Property Map>
    id String
    The provider-assigned unique ID for this managed resource.
    clusterType String
    Type of cluster that the version belongs to.
    clusterVersionsOnlies List<String>
    defaultOnly Boolean
    includeAll Boolean
    versionStatus String
    Status of the EKS cluster version.

    Supporting Types

    GetClusterVersionsClusterVersion

    ClusterType string
    Type of clusters to filter by. Currently, the only valid value is eks.
    ClusterVersion string
    Kubernetes version supported by EKS.
    DefaultPlatformVersion string
    Default eks platform version for the cluster version.
    DefaultVersion bool
    Default Kubernetes version for the cluster version.
    EndOfExtendedSupportDate string
    End of extended support date for the cluster version.
    EndOfStandardSupportDate string
    End of standard support date for the cluster version.
    KubernetesPatchVersion string
    Kubernetes patch version for the cluster version.
    ReleaseDate string
    Release date of the cluster version.
    VersionStatus string
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    ClusterType string
    Type of clusters to filter by. Currently, the only valid value is eks.
    ClusterVersion string
    Kubernetes version supported by EKS.
    DefaultPlatformVersion string
    Default eks platform version for the cluster version.
    DefaultVersion bool
    Default Kubernetes version for the cluster version.
    EndOfExtendedSupportDate string
    End of extended support date for the cluster version.
    EndOfStandardSupportDate string
    End of standard support date for the cluster version.
    KubernetesPatchVersion string
    Kubernetes patch version for the cluster version.
    ReleaseDate string
    Release date of the cluster version.
    VersionStatus string
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    clusterType String
    Type of clusters to filter by. Currently, the only valid value is eks.
    clusterVersion String
    Kubernetes version supported by EKS.
    defaultPlatformVersion String
    Default eks platform version for the cluster version.
    defaultVersion Boolean
    Default Kubernetes version for the cluster version.
    endOfExtendedSupportDate String
    End of extended support date for the cluster version.
    endOfStandardSupportDate String
    End of standard support date for the cluster version.
    kubernetesPatchVersion String
    Kubernetes patch version for the cluster version.
    releaseDate String
    Release date of the cluster version.
    versionStatus String
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    clusterType string
    Type of clusters to filter by. Currently, the only valid value is eks.
    clusterVersion string
    Kubernetes version supported by EKS.
    defaultPlatformVersion string
    Default eks platform version for the cluster version.
    defaultVersion boolean
    Default Kubernetes version for the cluster version.
    endOfExtendedSupportDate string
    End of extended support date for the cluster version.
    endOfStandardSupportDate string
    End of standard support date for the cluster version.
    kubernetesPatchVersion string
    Kubernetes patch version for the cluster version.
    releaseDate string
    Release date of the cluster version.
    versionStatus string
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    cluster_type str
    Type of clusters to filter by. Currently, the only valid value is eks.
    cluster_version str
    Kubernetes version supported by EKS.
    default_platform_version str
    Default eks platform version for the cluster version.
    default_version bool
    Default Kubernetes version for the cluster version.
    end_of_extended_support_date str
    End of extended support date for the cluster version.
    end_of_standard_support_date str
    End of standard support date for the cluster version.
    kubernetes_patch_version str
    Kubernetes patch version for the cluster version.
    release_date str
    Release date of the cluster version.
    version_status str
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.
    clusterType String
    Type of clusters to filter by. Currently, the only valid value is eks.
    clusterVersion String
    Kubernetes version supported by EKS.
    defaultPlatformVersion String
    Default eks platform version for the cluster version.
    defaultVersion Boolean
    Default Kubernetes version for the cluster version.
    endOfExtendedSupportDate String
    End of extended support date for the cluster version.
    endOfStandardSupportDate String
    End of standard support date for the cluster version.
    kubernetesPatchVersion String
    Kubernetes patch version for the cluster version.
    releaseDate String
    Release date of the cluster version.
    versionStatus String
    Status of the EKS cluster versions to list. Valid values are STANDARD_SUPPORT or UNSUPPORTED or EXTENDED_SUPPORT.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    Viewing docs for AWS v6.83.1 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
    Go to latest version
    Schema (JSON)
    pulumi/pulumi-aws
      Try Pulumi Cloud free. Your team will thank you.