1. Packages
  2. Ibm Provider
  3. API Docs
  4. getContainerClusterVersions
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

ibm.getContainerClusterVersions

Explore with Pulumi AI

ibm logo
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

    Retrieve information about supported Kubernetes versions in IBM Cloud Kubernetes Service clusters. To find a list of supported Kubernetes versions, see the IBM Cloud Kubernetes Service documentation

    Example Usage

    The following example shows how to retrieve information about supported Kubernetes versions for the resource group 11222333111abc111.

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const clusterVersions = ibm.getContainerClusterVersions({
        region: "eu-de",
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    cluster_versions = ibm.get_container_cluster_versions(region="eu-de")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.GetContainerClusterVersions(ctx, &ibm.GetContainerClusterVersionsArgs{
    			Region: pulumi.StringRef("eu-de"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var clusterVersions = Ibm.GetContainerClusterVersions.Invoke(new()
        {
            Region = "eu-de",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IbmFunctions;
    import com.pulumi.ibm.inputs.GetContainerClusterVersionsArgs;
    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 clusterVersions = IbmFunctions.getContainerClusterVersions(GetContainerClusterVersionsArgs.builder()
                .region("eu-de")
                .build());
    
        }
    }
    
    variables:
      clusterVersions:
        fn::invoke:
          function: ibm:getContainerClusterVersions
          arguments:
            region: eu-de
    

    Using getContainerClusterVersions

    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 getContainerClusterVersions(args: GetContainerClusterVersionsArgs, opts?: InvokeOptions): Promise<GetContainerClusterVersionsResult>
    function getContainerClusterVersionsOutput(args: GetContainerClusterVersionsOutputArgs, opts?: InvokeOptions): Output<GetContainerClusterVersionsResult>
    def get_container_cluster_versions(account_guid: Optional[str] = None,
                                       id: Optional[str] = None,
                                       org_guid: Optional[str] = None,
                                       region: Optional[str] = None,
                                       resource_group_id: Optional[str] = None,
                                       space_guid: Optional[str] = None,
                                       opts: Optional[InvokeOptions] = None) -> GetContainerClusterVersionsResult
    def get_container_cluster_versions_output(account_guid: Optional[pulumi.Input[str]] = None,
                                       id: Optional[pulumi.Input[str]] = None,
                                       org_guid: Optional[pulumi.Input[str]] = None,
                                       region: Optional[pulumi.Input[str]] = None,
                                       resource_group_id: Optional[pulumi.Input[str]] = None,
                                       space_guid: Optional[pulumi.Input[str]] = None,
                                       opts: Optional[InvokeOptions] = None) -> Output[GetContainerClusterVersionsResult]
    func GetContainerClusterVersions(ctx *Context, args *GetContainerClusterVersionsArgs, opts ...InvokeOption) (*GetContainerClusterVersionsResult, error)
    func GetContainerClusterVersionsOutput(ctx *Context, args *GetContainerClusterVersionsOutputArgs, opts ...InvokeOption) GetContainerClusterVersionsResultOutput

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

    public static class GetContainerClusterVersions 
    {
        public static Task<GetContainerClusterVersionsResult> InvokeAsync(GetContainerClusterVersionsArgs args, InvokeOptions? opts = null)
        public static Output<GetContainerClusterVersionsResult> Invoke(GetContainerClusterVersionsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetContainerClusterVersionsResult> getContainerClusterVersions(GetContainerClusterVersionsArgs args, InvokeOptions options)
    public static Output<GetContainerClusterVersionsResult> getContainerClusterVersions(GetContainerClusterVersionsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ibm:index/getContainerClusterVersions:getContainerClusterVersions
      arguments:
        # arguments dictionary

    The following arguments are supported:

    AccountGuid string
    The GUID for the IBM Cloud account associated with the cluster. You can retrieve the value from the ibm.getAccount data source or by running the ibmcloud iam accounts command in the IBM Cloud CLI.

    Deprecated: Deprecated

    Id string
    (String) The unique identifier of the cluster.
    OrgGuid string
    The GUID for the IBM Cloud organization associated with the cluster. You can retrieve the value from the ibm.Org data source or by running the ibmcloud iam orgs --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    Region string
    The region to target. If the region is not specified it will be defaulted to provider region(IC_REGION/IBMCLOUD_REGION). To get the list of supported regions please access this link and use the alias.

    Deprecated: Deprecated

    ResourceGroupId string

    The ID of the resource group where your cluster is provisioned into. To find the resource group, run ibmcloud resource groups or use the ibm.ResourceGroup data source. If this parameter is not provided, the default resource group is used.

    Deprecated reference

    SpaceGuid string
    The GUID for the IBM Cloud space associated with the cluster. You can retrieve the value from the ibm.Space data source or by running the ibmcloud iam space <space-name> --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    AccountGuid string
    The GUID for the IBM Cloud account associated with the cluster. You can retrieve the value from the ibm.getAccount data source or by running the ibmcloud iam accounts command in the IBM Cloud CLI.

    Deprecated: Deprecated

    Id string
    (String) The unique identifier of the cluster.
    OrgGuid string
    The GUID for the IBM Cloud organization associated with the cluster. You can retrieve the value from the ibm.Org data source or by running the ibmcloud iam orgs --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    Region string
    The region to target. If the region is not specified it will be defaulted to provider region(IC_REGION/IBMCLOUD_REGION). To get the list of supported regions please access this link and use the alias.

    Deprecated: Deprecated

    ResourceGroupId string

    The ID of the resource group where your cluster is provisioned into. To find the resource group, run ibmcloud resource groups or use the ibm.ResourceGroup data source. If this parameter is not provided, the default resource group is used.

    Deprecated reference

    SpaceGuid string
    The GUID for the IBM Cloud space associated with the cluster. You can retrieve the value from the ibm.Space data source or by running the ibmcloud iam space <space-name> --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    accountGuid String
    The GUID for the IBM Cloud account associated with the cluster. You can retrieve the value from the ibm.getAccount data source or by running the ibmcloud iam accounts command in the IBM Cloud CLI.

    Deprecated: Deprecated

    id String
    (String) The unique identifier of the cluster.
    orgGuid String
    The GUID for the IBM Cloud organization associated with the cluster. You can retrieve the value from the ibm.Org data source or by running the ibmcloud iam orgs --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    region String
    The region to target. If the region is not specified it will be defaulted to provider region(IC_REGION/IBMCLOUD_REGION). To get the list of supported regions please access this link and use the alias.

    Deprecated: Deprecated

    resourceGroupId String

    The ID of the resource group where your cluster is provisioned into. To find the resource group, run ibmcloud resource groups or use the ibm.ResourceGroup data source. If this parameter is not provided, the default resource group is used.

    Deprecated reference

    spaceGuid String
    The GUID for the IBM Cloud space associated with the cluster. You can retrieve the value from the ibm.Space data source or by running the ibmcloud iam space <space-name> --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    accountGuid string
    The GUID for the IBM Cloud account associated with the cluster. You can retrieve the value from the ibm.getAccount data source or by running the ibmcloud iam accounts command in the IBM Cloud CLI.

    Deprecated: Deprecated

    id string
    (String) The unique identifier of the cluster.
    orgGuid string
    The GUID for the IBM Cloud organization associated with the cluster. You can retrieve the value from the ibm.Org data source or by running the ibmcloud iam orgs --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    region string
    The region to target. If the region is not specified it will be defaulted to provider region(IC_REGION/IBMCLOUD_REGION). To get the list of supported regions please access this link and use the alias.

    Deprecated: Deprecated

    resourceGroupId string

    The ID of the resource group where your cluster is provisioned into. To find the resource group, run ibmcloud resource groups or use the ibm.ResourceGroup data source. If this parameter is not provided, the default resource group is used.

    Deprecated reference

    spaceGuid string
    The GUID for the IBM Cloud space associated with the cluster. You can retrieve the value from the ibm.Space data source or by running the ibmcloud iam space <space-name> --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    account_guid str
    The GUID for the IBM Cloud account associated with the cluster. You can retrieve the value from the ibm.getAccount data source or by running the ibmcloud iam accounts command in the IBM Cloud CLI.

    Deprecated: Deprecated

    id str
    (String) The unique identifier of the cluster.
    org_guid str
    The GUID for the IBM Cloud organization associated with the cluster. You can retrieve the value from the ibm.Org data source or by running the ibmcloud iam orgs --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    region str
    The region to target. If the region is not specified it will be defaulted to provider region(IC_REGION/IBMCLOUD_REGION). To get the list of supported regions please access this link and use the alias.

    Deprecated: Deprecated

    resource_group_id str

    The ID of the resource group where your cluster is provisioned into. To find the resource group, run ibmcloud resource groups or use the ibm.ResourceGroup data source. If this parameter is not provided, the default resource group is used.

    Deprecated reference

    space_guid str
    The GUID for the IBM Cloud space associated with the cluster. You can retrieve the value from the ibm.Space data source or by running the ibmcloud iam space <space-name> --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    accountGuid String
    The GUID for the IBM Cloud account associated with the cluster. You can retrieve the value from the ibm.getAccount data source or by running the ibmcloud iam accounts command in the IBM Cloud CLI.

    Deprecated: Deprecated

    id String
    (String) The unique identifier of the cluster.
    orgGuid String
    The GUID for the IBM Cloud organization associated with the cluster. You can retrieve the value from the ibm.Org data source or by running the ibmcloud iam orgs --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    region String
    The region to target. If the region is not specified it will be defaulted to provider region(IC_REGION/IBMCLOUD_REGION). To get the list of supported regions please access this link and use the alias.

    Deprecated: Deprecated

    resourceGroupId String

    The ID of the resource group where your cluster is provisioned into. To find the resource group, run ibmcloud resource groups or use the ibm.ResourceGroup data source. If this parameter is not provided, the default resource group is used.

    Deprecated reference

    spaceGuid String
    The GUID for the IBM Cloud space associated with the cluster. You can retrieve the value from the ibm.Space data source or by running the ibmcloud iam space <space-name> --guid command in the IBM Cloud CLI.

    Deprecated: Deprecated

    getContainerClusterVersions Result

    The following output properties are available:

    DefaultKubeVersion string
    (String) The default Kubernetes version in IBM Cloud Kubernetes Service clusters.
    DefaultOpenshiftVersion string
    (String) The default OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    Id string
    (String) The unique identifier of the cluster.
    ValidKubeVersions List<string>
    (String) The supported Kubernetes version in IBM Cloud Kubernetes Service clusters.
    ValidOpenshiftVersions List<string>
    (String) The supported OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    AccountGuid string

    Deprecated: Deprecated

    OrgGuid string

    Deprecated: Deprecated

    Region string

    Deprecated: Deprecated

    ResourceGroupId string
    SpaceGuid string

    Deprecated: Deprecated

    DefaultKubeVersion string
    (String) The default Kubernetes version in IBM Cloud Kubernetes Service clusters.
    DefaultOpenshiftVersion string
    (String) The default OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    Id string
    (String) The unique identifier of the cluster.
    ValidKubeVersions []string
    (String) The supported Kubernetes version in IBM Cloud Kubernetes Service clusters.
    ValidOpenshiftVersions []string
    (String) The supported OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    AccountGuid string

    Deprecated: Deprecated

    OrgGuid string

    Deprecated: Deprecated

    Region string

    Deprecated: Deprecated

    ResourceGroupId string
    SpaceGuid string

    Deprecated: Deprecated

    defaultKubeVersion String
    (String) The default Kubernetes version in IBM Cloud Kubernetes Service clusters.
    defaultOpenshiftVersion String
    (String) The default OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    id String
    (String) The unique identifier of the cluster.
    validKubeVersions List<String>
    (String) The supported Kubernetes version in IBM Cloud Kubernetes Service clusters.
    validOpenshiftVersions List<String>
    (String) The supported OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    accountGuid String

    Deprecated: Deprecated

    orgGuid String

    Deprecated: Deprecated

    region String

    Deprecated: Deprecated

    resourceGroupId String
    spaceGuid String

    Deprecated: Deprecated

    defaultKubeVersion string
    (String) The default Kubernetes version in IBM Cloud Kubernetes Service clusters.
    defaultOpenshiftVersion string
    (String) The default OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    id string
    (String) The unique identifier of the cluster.
    validKubeVersions string[]
    (String) The supported Kubernetes version in IBM Cloud Kubernetes Service clusters.
    validOpenshiftVersions string[]
    (String) The supported OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    accountGuid string

    Deprecated: Deprecated

    orgGuid string

    Deprecated: Deprecated

    region string

    Deprecated: Deprecated

    resourceGroupId string
    spaceGuid string

    Deprecated: Deprecated

    default_kube_version str
    (String) The default Kubernetes version in IBM Cloud Kubernetes Service clusters.
    default_openshift_version str
    (String) The default OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    id str
    (String) The unique identifier of the cluster.
    valid_kube_versions Sequence[str]
    (String) The supported Kubernetes version in IBM Cloud Kubernetes Service clusters.
    valid_openshift_versions Sequence[str]
    (String) The supported OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    account_guid str

    Deprecated: Deprecated

    org_guid str

    Deprecated: Deprecated

    region str

    Deprecated: Deprecated

    resource_group_id str
    space_guid str

    Deprecated: Deprecated

    defaultKubeVersion String
    (String) The default Kubernetes version in IBM Cloud Kubernetes Service clusters.
    defaultOpenshiftVersion String
    (String) The default OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    id String
    (String) The unique identifier of the cluster.
    validKubeVersions List<String>
    (String) The supported Kubernetes version in IBM Cloud Kubernetes Service clusters.
    validOpenshiftVersions List<String>
    (String) The supported OpenShift Container Platform version in Red Hat OpenShift on IBM Cloud clusters.
    accountGuid String

    Deprecated: Deprecated

    orgGuid String

    Deprecated: Deprecated

    region String

    Deprecated: Deprecated

    resourceGroupId String
    spaceGuid String

    Deprecated: Deprecated

    Package Details

    Repository
    ibm ibm-cloud/terraform-provider-ibm
    License
    Notes
    This Pulumi package is based on the ibm Terraform Provider.
    ibm logo
    ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud