vkcs 0.13.0 published on Tuesday, Oct 14, 2025 by vk-cs
vkcs.getKubernetesCluster
Use this data source to get the ID of an available VKCS kubernetes cluster.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as vkcs from "@pulumi/vkcs";
const k8sCluster = vkcs.getKubernetesCluster({
    id: vkcs_kubernetes_cluster.k8s_cluster.id,
});
import pulumi
import pulumi_vkcs as vkcs
k8s_cluster = vkcs.get_kubernetes_cluster(id=vkcs_kubernetes_cluster["k8s_cluster"]["id"])
package main
import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/vkcs/vkcs"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vkcs.LookupKubernetesCluster(ctx, &vkcs.LookupKubernetesClusterArgs{
			Id: pulumi.StringRef(vkcs_kubernetes_cluster.K8s_cluster.Id),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Vkcs = Pulumi.Vkcs;
return await Deployment.RunAsync(() => 
{
    var k8sCluster = Vkcs.GetKubernetesCluster.Invoke(new()
    {
        Id = vkcs_kubernetes_cluster.K8s_cluster.Id,
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.vkcs.VkcsFunctions;
import com.pulumi.vkcs.inputs.GetKubernetesClusterArgs;
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 k8sCluster = VkcsFunctions.getKubernetesCluster(GetKubernetesClusterArgs.builder()
            .id(vkcs_kubernetes_cluster.k8s_cluster().id())
            .build());
    }
}
variables:
  k8sCluster:
    fn::invoke:
      function: vkcs:getKubernetesCluster
      arguments:
        id: ${vkcs_kubernetes_cluster.k8s_cluster.id}
Using getKubernetesCluster
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 getKubernetesCluster(args: GetKubernetesClusterArgs, opts?: InvokeOptions): Promise<GetKubernetesClusterResult>
function getKubernetesClusterOutput(args: GetKubernetesClusterOutputArgs, opts?: InvokeOptions): Output<GetKubernetesClusterResult>def get_kubernetes_cluster(cluster_id: Optional[str] = None,
                           dns_domain: Optional[str] = None,
                           id: Optional[str] = None,
                           name: Optional[str] = None,
                           region: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetKubernetesClusterResult
def get_kubernetes_cluster_output(cluster_id: Optional[pulumi.Input[str]] = None,
                           dns_domain: Optional[pulumi.Input[str]] = None,
                           id: Optional[pulumi.Input[str]] = None,
                           name: Optional[pulumi.Input[str]] = None,
                           region: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetKubernetesClusterResult]func LookupKubernetesCluster(ctx *Context, args *LookupKubernetesClusterArgs, opts ...InvokeOption) (*LookupKubernetesClusterResult, error)
func LookupKubernetesClusterOutput(ctx *Context, args *LookupKubernetesClusterOutputArgs, opts ...InvokeOption) LookupKubernetesClusterResultOutput> Note: This function is named LookupKubernetesCluster in the Go SDK.
public static class GetKubernetesCluster 
{
    public static Task<GetKubernetesClusterResult> InvokeAsync(GetKubernetesClusterArgs args, InvokeOptions? opts = null)
    public static Output<GetKubernetesClusterResult> Invoke(GetKubernetesClusterInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetKubernetesClusterResult> getKubernetesCluster(GetKubernetesClusterArgs args, InvokeOptions options)
public static Output<GetKubernetesClusterResult> getKubernetesCluster(GetKubernetesClusterArgs args, InvokeOptions options)
fn::invoke:
  function: vkcs:index/getKubernetesCluster:getKubernetesCluster
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Cluster
Id string - optional deprecated string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameorcluster_idmust be specified. Deprecated This argument is deprecated, please, use theidattribute instead. - Dns
Domain string - optional string → Custom DNS cluster domain.
 - Id string
 - optional string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameoridmust be specified. - Name string
 - optional string → The name of the cluster. Note: Only one of 
nameoridmust be specified. - Region string
 - optional string → The region in which to obtain the Container Infra client. If omitted, the 
regionargument of the provider is used. 
- Cluster
Id string - optional deprecated string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameorcluster_idmust be specified. Deprecated This argument is deprecated, please, use theidattribute instead. - Dns
Domain string - optional string → Custom DNS cluster domain.
 - Id string
 - optional string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameoridmust be specified. - Name string
 - optional string → The name of the cluster. Note: Only one of 
nameoridmust be specified. - Region string
 - optional string → The region in which to obtain the Container Infra client. If omitted, the 
regionargument of the provider is used. 
- cluster
Id String - optional deprecated string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameorcluster_idmust be specified. Deprecated This argument is deprecated, please, use theidattribute instead. - dns
Domain String - optional string → Custom DNS cluster domain.
 - id String
 - optional string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameoridmust be specified. - name String
 - optional string → The name of the cluster. Note: Only one of 
nameoridmust be specified. - region String
 - optional string → The region in which to obtain the Container Infra client. If omitted, the 
regionargument of the provider is used. 
- cluster
Id string - optional deprecated string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameorcluster_idmust be specified. Deprecated This argument is deprecated, please, use theidattribute instead. - dns
Domain string - optional string → Custom DNS cluster domain.
 - id string
 - optional string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameoridmust be specified. - name string
 - optional string → The name of the cluster. Note: Only one of 
nameoridmust be specified. - region string
 - optional string → The region in which to obtain the Container Infra client. If omitted, the 
regionargument of the provider is used. 
- cluster_
id str - optional deprecated string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameorcluster_idmust be specified. Deprecated This argument is deprecated, please, use theidattribute instead. - dns_
domain str - optional string → Custom DNS cluster domain.
 - id str
 - optional string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameoridmust be specified. - name str
 - optional string → The name of the cluster. Note: Only one of 
nameoridmust be specified. - region str
 - optional string → The region in which to obtain the Container Infra client. If omitted, the 
regionargument of the provider is used. 
- cluster
Id String - optional deprecated string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameorcluster_idmust be specified. Deprecated This argument is deprecated, please, use theidattribute instead. - dns
Domain String - optional string → Custom DNS cluster domain.
 - id String
 - optional string → The UUID of the Kubernetes cluster template. Note: Only one of 
nameoridmust be specified. - name String
 - optional string → The name of the cluster. Note: Only one of 
nameoridmust be specified. - region String
 - optional string → The region in which to obtain the Container Infra client. If omitted, the 
regionargument of the provider is used. 
getKubernetesCluster Result
The following output properties are available:
- Api
Address string - string → COE API address.
 - Api
Lb stringFip  - string → API LoadBalancer fip.
 - Api
Lb stringVip  - string → API LoadBalancer vip.
 - Availability
Zone string - string → Availability zone of the cluster.
 - Availability
Zones List<string> - set of string → Availability zones of the regional clusterNew since v0.8.3.
 - Cluster
Id string - Cluster
Template stringId  - string → The UUID of the V1 Container Infra cluster template.
 - Cluster
Type string - string → Type of the kubernetes cluster, may be 
standardorregionalNew since v0.8.3. - Created
At string - string → The time at which cluster was created.
 - Discovery
Url string - string → The URL used for cluster node discovery.
 - Dns
Domain string - Floating
Ip boolEnabled  - boolean → Indicates whether floating ip is enabled for cluster.
 - Id string
 - Ingress
Floating stringIp  - string → Floating IP created for ingress service. Deprecated This argument is deprecated as Ingress controller is not currently installed by default.
 - Insecure
Registries List<string> - string → Addresses of registries from which you can download images without checking certificates.
 - K8s
Config string - string → Kubeconfig for cluster
 - Keypair string
 - string → The name of the Compute service SSH keypair. Deprecated This argument is deprecated, please do not use it.
 - Labels Dictionary<string, string>
 - map of string → The list of key value pairs representing additional properties of the cluster.
 - Loadbalancer
Subnet stringId  - string → The ID of load balancer's subnet.
 - Master
Addresses List<string> - string → IP addresses of the master node of the cluster.
 - Master
Count double - number → The number of master nodes for the cluster.
 - Master
Flavor string - string → The ID of the flavor for the master nodes.
 - Name string
 - Network
Id string - string → UUID of the cluster's network.
 - Pods
Network stringCidr  - string → Network cidr of k8s virtual network.
 - Project
Id string - string → The project of the cluster.
 - Region string
 - Registry
Auth stringPassword  - string → Docker registry access password.
 - Stack
Id string - string → UUID of the Orchestration service stack.
 - Status string
 - string → Current state of a cluster.
 - Subnet
Id string - string → UUID of the cluster's subnet.
 - Sync
Security boolPolicy  - boolean → Enables syncing of security policies of cluster.New since v0.7.0.
 - Updated
At string - string → The time at which cluster was created.
 - User
Id string - string → The user of the cluster.
 
- Api
Address string - string → COE API address.
 - Api
Lb stringFip  - string → API LoadBalancer fip.
 - Api
Lb stringVip  - string → API LoadBalancer vip.
 - Availability
Zone string - string → Availability zone of the cluster.
 - Availability
Zones []string - set of string → Availability zones of the regional clusterNew since v0.8.3.
 - Cluster
Id string - Cluster
Template stringId  - string → The UUID of the V1 Container Infra cluster template.
 - Cluster
Type string - string → Type of the kubernetes cluster, may be 
standardorregionalNew since v0.8.3. - Created
At string - string → The time at which cluster was created.
 - Discovery
Url string - string → The URL used for cluster node discovery.
 - Dns
Domain string - Floating
Ip boolEnabled  - boolean → Indicates whether floating ip is enabled for cluster.
 - Id string
 - Ingress
Floating stringIp  - string → Floating IP created for ingress service. Deprecated This argument is deprecated as Ingress controller is not currently installed by default.
 - Insecure
Registries []string - string → Addresses of registries from which you can download images without checking certificates.
 - K8s
Config string - string → Kubeconfig for cluster
 - Keypair string
 - string → The name of the Compute service SSH keypair. Deprecated This argument is deprecated, please do not use it.
 - Labels map[string]string
 - map of string → The list of key value pairs representing additional properties of the cluster.
 - Loadbalancer
Subnet stringId  - string → The ID of load balancer's subnet.
 - Master
Addresses []string - string → IP addresses of the master node of the cluster.
 - Master
Count float64 - number → The number of master nodes for the cluster.
 - Master
Flavor string - string → The ID of the flavor for the master nodes.
 - Name string
 - Network
Id string - string → UUID of the cluster's network.
 - Pods
Network stringCidr  - string → Network cidr of k8s virtual network.
 - Project
Id string - string → The project of the cluster.
 - Region string
 - Registry
Auth stringPassword  - string → Docker registry access password.
 - Stack
Id string - string → UUID of the Orchestration service stack.
 - Status string
 - string → Current state of a cluster.
 - Subnet
Id string - string → UUID of the cluster's subnet.
 - Sync
Security boolPolicy  - boolean → Enables syncing of security policies of cluster.New since v0.7.0.
 - Updated
At string - string → The time at which cluster was created.
 - User
Id string - string → The user of the cluster.
 
- api
Address String - string → COE API address.
 - api
Lb StringFip  - string → API LoadBalancer fip.
 - api
Lb StringVip  - string → API LoadBalancer vip.
 - availability
Zone String - string → Availability zone of the cluster.
 - availability
Zones List<String> - set of string → Availability zones of the regional clusterNew since v0.8.3.
 - cluster
Id String - cluster
Template StringId  - string → The UUID of the V1 Container Infra cluster template.
 - cluster
Type String - string → Type of the kubernetes cluster, may be 
standardorregionalNew since v0.8.3. - created
At String - string → The time at which cluster was created.
 - discovery
Url String - string → The URL used for cluster node discovery.
 - dns
Domain String - floating
Ip BooleanEnabled  - boolean → Indicates whether floating ip is enabled for cluster.
 - id String
 - ingress
Floating StringIp  - string → Floating IP created for ingress service. Deprecated This argument is deprecated as Ingress controller is not currently installed by default.
 - insecure
Registries List<String> - string → Addresses of registries from which you can download images without checking certificates.
 - k8s
Config String - string → Kubeconfig for cluster
 - keypair String
 - string → The name of the Compute service SSH keypair. Deprecated This argument is deprecated, please do not use it.
 - labels Map<String,String>
 - map of string → The list of key value pairs representing additional properties of the cluster.
 - loadbalancer
Subnet StringId  - string → The ID of load balancer's subnet.
 - master
Addresses List<String> - string → IP addresses of the master node of the cluster.
 - master
Count Double - number → The number of master nodes for the cluster.
 - master
Flavor String - string → The ID of the flavor for the master nodes.
 - name String
 - network
Id String - string → UUID of the cluster's network.
 - pods
Network StringCidr  - string → Network cidr of k8s virtual network.
 - project
Id String - string → The project of the cluster.
 - region String
 - registry
Auth StringPassword  - string → Docker registry access password.
 - stack
Id String - string → UUID of the Orchestration service stack.
 - status String
 - string → Current state of a cluster.
 - subnet
Id String - string → UUID of the cluster's subnet.
 - sync
Security BooleanPolicy  - boolean → Enables syncing of security policies of cluster.New since v0.7.0.
 - updated
At String - string → The time at which cluster was created.
 - user
Id String - string → The user of the cluster.
 
- api
Address string - string → COE API address.
 - api
Lb stringFip  - string → API LoadBalancer fip.
 - api
Lb stringVip  - string → API LoadBalancer vip.
 - availability
Zone string - string → Availability zone of the cluster.
 - availability
Zones string[] - set of string → Availability zones of the regional clusterNew since v0.8.3.
 - cluster
Id string - cluster
Template stringId  - string → The UUID of the V1 Container Infra cluster template.
 - cluster
Type string - string → Type of the kubernetes cluster, may be 
standardorregionalNew since v0.8.3. - created
At string - string → The time at which cluster was created.
 - discovery
Url string - string → The URL used for cluster node discovery.
 - dns
Domain string - floating
Ip booleanEnabled  - boolean → Indicates whether floating ip is enabled for cluster.
 - id string
 - ingress
Floating stringIp  - string → Floating IP created for ingress service. Deprecated This argument is deprecated as Ingress controller is not currently installed by default.
 - insecure
Registries string[] - string → Addresses of registries from which you can download images without checking certificates.
 - k8s
Config string - string → Kubeconfig for cluster
 - keypair string
 - string → The name of the Compute service SSH keypair. Deprecated This argument is deprecated, please do not use it.
 - labels {[key: string]: string}
 - map of string → The list of key value pairs representing additional properties of the cluster.
 - loadbalancer
Subnet stringId  - string → The ID of load balancer's subnet.
 - master
Addresses string[] - string → IP addresses of the master node of the cluster.
 - master
Count number - number → The number of master nodes for the cluster.
 - master
Flavor string - string → The ID of the flavor for the master nodes.
 - name string
 - network
Id string - string → UUID of the cluster's network.
 - pods
Network stringCidr  - string → Network cidr of k8s virtual network.
 - project
Id string - string → The project of the cluster.
 - region string
 - registry
Auth stringPassword  - string → Docker registry access password.
 - stack
Id string - string → UUID of the Orchestration service stack.
 - status string
 - string → Current state of a cluster.
 - subnet
Id string - string → UUID of the cluster's subnet.
 - sync
Security booleanPolicy  - boolean → Enables syncing of security policies of cluster.New since v0.7.0.
 - updated
At string - string → The time at which cluster was created.
 - user
Id string - string → The user of the cluster.
 
- api_
address str - string → COE API address.
 - api_
lb_ strfip  - string → API LoadBalancer fip.
 - api_
lb_ strvip  - string → API LoadBalancer vip.
 - availability_
zone str - string → Availability zone of the cluster.
 - availability_
zones Sequence[str] - set of string → Availability zones of the regional clusterNew since v0.8.3.
 - cluster_
id str - cluster_
template_ strid  - string → The UUID of the V1 Container Infra cluster template.
 - cluster_
type str - string → Type of the kubernetes cluster, may be 
standardorregionalNew since v0.8.3. - created_
at str - string → The time at which cluster was created.
 - discovery_
url str - string → The URL used for cluster node discovery.
 - dns_
domain str - floating_
ip_ boolenabled  - boolean → Indicates whether floating ip is enabled for cluster.
 - id str
 - ingress_
floating_ strip  - string → Floating IP created for ingress service. Deprecated This argument is deprecated as Ingress controller is not currently installed by default.
 - insecure_
registries Sequence[str] - string → Addresses of registries from which you can download images without checking certificates.
 - k8s_
config str - string → Kubeconfig for cluster
 - keypair str
 - string → The name of the Compute service SSH keypair. Deprecated This argument is deprecated, please do not use it.
 - labels Mapping[str, str]
 - map of string → The list of key value pairs representing additional properties of the cluster.
 - loadbalancer_
subnet_ strid  - string → The ID of load balancer's subnet.
 - master_
addresses Sequence[str] - string → IP addresses of the master node of the cluster.
 - master_
count float - number → The number of master nodes for the cluster.
 - master_
flavor str - string → The ID of the flavor for the master nodes.
 - name str
 - network_
id str - string → UUID of the cluster's network.
 - pods_
network_ strcidr  - string → Network cidr of k8s virtual network.
 - project_
id str - string → The project of the cluster.
 - region str
 - registry_
auth_ strpassword  - string → Docker registry access password.
 - stack_
id str - string → UUID of the Orchestration service stack.
 - status str
 - string → Current state of a cluster.
 - subnet_
id str - string → UUID of the cluster's subnet.
 - sync_
security_ boolpolicy  - boolean → Enables syncing of security policies of cluster.New since v0.7.0.
 - updated_
at str - string → The time at which cluster was created.
 - user_
id str - string → The user of the cluster.
 
- api
Address String - string → COE API address.
 - api
Lb StringFip  - string → API LoadBalancer fip.
 - api
Lb StringVip  - string → API LoadBalancer vip.
 - availability
Zone String - string → Availability zone of the cluster.
 - availability
Zones List<String> - set of string → Availability zones of the regional clusterNew since v0.8.3.
 - cluster
Id String - cluster
Template StringId  - string → The UUID of the V1 Container Infra cluster template.
 - cluster
Type String - string → Type of the kubernetes cluster, may be 
standardorregionalNew since v0.8.3. - created
At String - string → The time at which cluster was created.
 - discovery
Url String - string → The URL used for cluster node discovery.
 - dns
Domain String - floating
Ip BooleanEnabled  - boolean → Indicates whether floating ip is enabled for cluster.
 - id String
 - ingress
Floating StringIp  - string → Floating IP created for ingress service. Deprecated This argument is deprecated as Ingress controller is not currently installed by default.
 - insecure
Registries List<String> - string → Addresses of registries from which you can download images without checking certificates.
 - k8s
Config String - string → Kubeconfig for cluster
 - keypair String
 - string → The name of the Compute service SSH keypair. Deprecated This argument is deprecated, please do not use it.
 - labels Map<String>
 - map of string → The list of key value pairs representing additional properties of the cluster.
 - loadbalancer
Subnet StringId  - string → The ID of load balancer's subnet.
 - master
Addresses List<String> - string → IP addresses of the master node of the cluster.
 - master
Count Number - number → The number of master nodes for the cluster.
 - master
Flavor String - string → The ID of the flavor for the master nodes.
 - name String
 - network
Id String - string → UUID of the cluster's network.
 - pods
Network StringCidr  - string → Network cidr of k8s virtual network.
 - project
Id String - string → The project of the cluster.
 - region String
 - registry
Auth StringPassword  - string → Docker registry access password.
 - stack
Id String - string → UUID of the Orchestration service stack.
 - status String
 - string → Current state of a cluster.
 - subnet
Id String - string → UUID of the cluster's subnet.
 - sync
Security BooleanPolicy  - boolean → Enables syncing of security policies of cluster.New since v0.7.0.
 - updated
At String - string → The time at which cluster was created.
 - user
Id String - string → The user of the cluster.
 
Package Details
- Repository
 - vkcs vk-cs/terraform-provider-vkcs
 - License
 - Notes
 - This Pulumi package is based on the 
vkcsTerraform Provider. 
