1. Packages
  2. Google Cloud (GCP) Classic
  3. API Docs
  4. vmwareengine
  5. getCluster
Google Cloud v8.26.0 published on Thursday, Apr 10, 2025 by Pulumi

gcp.vmwareengine.getCluster

Explore with Pulumi AI

Google Cloud v8.26.0 published on Thursday, Apr 10, 2025 by Pulumi

Use this data source to get details about a cluster resource.

To get more information about private cloud cluster, see:

Example Usage

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

const myCluster = gcp.vmwareengine.getCluster({
    name: "my-cluster",
    parent: "project/locations/us-west1-a/privateClouds/my-cloud",
});
Copy
import pulumi
import pulumi_gcp as gcp

my_cluster = gcp.vmwareengine.get_cluster(name="my-cluster",
    parent="project/locations/us-west1-a/privateClouds/my-cloud")
Copy
package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/vmwareengine"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vmwareengine.LookupCluster(ctx, &vmwareengine.LookupClusterArgs{
			Name:   "my-cluster",
			Parent: "project/locations/us-west1-a/privateClouds/my-cloud",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var myCluster = Gcp.VMwareEngine.GetCluster.Invoke(new()
    {
        Name = "my-cluster",
        Parent = "project/locations/us-west1-a/privateClouds/my-cloud",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.vmwareengine.VmwareengineFunctions;
import com.pulumi.gcp.vmwareengine.inputs.GetClusterArgs;
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 myCluster = VmwareengineFunctions.getCluster(GetClusterArgs.builder()
            .name("my-cluster")
            .parent("project/locations/us-west1-a/privateClouds/my-cloud")
            .build());

    }
}
Copy
variables:
  myCluster:
    fn::invoke:
      function: gcp:vmwareengine:getCluster
      arguments:
        name: my-cluster
        parent: project/locations/us-west1-a/privateClouds/my-cloud
Copy

Using getCluster

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 getCluster(args: GetClusterArgs, opts?: InvokeOptions): Promise<GetClusterResult>
function getClusterOutput(args: GetClusterOutputArgs, opts?: InvokeOptions): Output<GetClusterResult>
Copy
def get_cluster(name: Optional[str] = None,
                parent: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetClusterResult
def get_cluster_output(name: Optional[pulumi.Input[str]] = None,
                parent: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetClusterResult]
Copy
func LookupCluster(ctx *Context, args *LookupClusterArgs, opts ...InvokeOption) (*LookupClusterResult, error)
func LookupClusterOutput(ctx *Context, args *LookupClusterOutputArgs, opts ...InvokeOption) LookupClusterResultOutput
Copy

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

public static class GetCluster 
{
    public static Task<GetClusterResult> InvokeAsync(GetClusterArgs args, InvokeOptions? opts = null)
    public static Output<GetClusterResult> Invoke(GetClusterInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetClusterResult> getCluster(GetClusterArgs args, InvokeOptions options)
public static Output<GetClusterResult> getCluster(GetClusterArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: gcp:vmwareengine/getCluster:getCluster
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

Name This property is required. string
Name of the resource.
Parent This property is required. string
The resource name of the private cloud that this cluster belongs.
Name This property is required. string
Name of the resource.
Parent This property is required. string
The resource name of the private cloud that this cluster belongs.
name This property is required. String
Name of the resource.
parent This property is required. String
The resource name of the private cloud that this cluster belongs.
name This property is required. string
Name of the resource.
parent This property is required. string
The resource name of the private cloud that this cluster belongs.
name This property is required. str
Name of the resource.
parent This property is required. str
The resource name of the private cloud that this cluster belongs.
name This property is required. String
Name of the resource.
parent This property is required. String
The resource name of the private cloud that this cluster belongs.

getCluster Result

The following output properties are available:

AutoscalingSettings List<GetClusterAutoscalingSetting>
Id string
The provider-assigned unique ID for this managed resource.
Management bool
Name string
NodeTypeConfigs List<GetClusterNodeTypeConfig>
Parent string
State string
Uid string
AutoscalingSettings []GetClusterAutoscalingSetting
Id string
The provider-assigned unique ID for this managed resource.
Management bool
Name string
NodeTypeConfigs []GetClusterNodeTypeConfig
Parent string
State string
Uid string
autoscalingSettings List<GetClusterAutoscalingSetting>
id String
The provider-assigned unique ID for this managed resource.
management Boolean
name String
nodeTypeConfigs List<GetClusterNodeTypeConfig>
parent String
state String
uid String
autoscalingSettings GetClusterAutoscalingSetting[]
id string
The provider-assigned unique ID for this managed resource.
management boolean
name string
nodeTypeConfigs GetClusterNodeTypeConfig[]
parent string
state string
uid string
autoscalingSettings List<Property Map>
id String
The provider-assigned unique ID for this managed resource.
management Boolean
name String
nodeTypeConfigs List<Property Map>
parent String
state String
uid String

Supporting Types

GetClusterAutoscalingSetting

AutoscalingPolicies This property is required. List<GetClusterAutoscalingSettingAutoscalingPolicy>

The map with autoscaling policies applied to the cluster. The key is the identifier of the policy. It must meet the following requirements:

  • Only contains 1-63 alphanumeric characters and hyphens
  • Begins with an alphabetical character
  • Ends with a non-hyphen character
  • Not formatted as a UUID
  • Complies with RFC 1034 (section 3.5)

Currently the map must contain only one element that describes the autoscaling policy for compute nodes.

CoolDownPeriod This property is required. string
The minimum duration between consecutive autoscale operations. It starts once addition or removal of nodes is fully completed. Minimum cool down period is 30m. Cool down period must be in whole minutes (for example, 30m, 31m, 50m). Mandatory for successful addition of autoscaling settings in cluster.
MaxClusterNodeCount This property is required. int
Maximum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
MinClusterNodeCount This property is required. int
Minimum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
AutoscalingPolicies This property is required. []GetClusterAutoscalingSettingAutoscalingPolicy

The map with autoscaling policies applied to the cluster. The key is the identifier of the policy. It must meet the following requirements:

  • Only contains 1-63 alphanumeric characters and hyphens
  • Begins with an alphabetical character
  • Ends with a non-hyphen character
  • Not formatted as a UUID
  • Complies with RFC 1034 (section 3.5)

Currently the map must contain only one element that describes the autoscaling policy for compute nodes.

CoolDownPeriod This property is required. string
The minimum duration between consecutive autoscale operations. It starts once addition or removal of nodes is fully completed. Minimum cool down period is 30m. Cool down period must be in whole minutes (for example, 30m, 31m, 50m). Mandatory for successful addition of autoscaling settings in cluster.
MaxClusterNodeCount This property is required. int
Maximum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
MinClusterNodeCount This property is required. int
Minimum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
autoscalingPolicies This property is required. List<GetClusterAutoscalingSettingAutoscalingPolicy>

The map with autoscaling policies applied to the cluster. The key is the identifier of the policy. It must meet the following requirements:

  • Only contains 1-63 alphanumeric characters and hyphens
  • Begins with an alphabetical character
  • Ends with a non-hyphen character
  • Not formatted as a UUID
  • Complies with RFC 1034 (section 3.5)

Currently the map must contain only one element that describes the autoscaling policy for compute nodes.

coolDownPeriod This property is required. String
The minimum duration between consecutive autoscale operations. It starts once addition or removal of nodes is fully completed. Minimum cool down period is 30m. Cool down period must be in whole minutes (for example, 30m, 31m, 50m). Mandatory for successful addition of autoscaling settings in cluster.
maxClusterNodeCount This property is required. Integer
Maximum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
minClusterNodeCount This property is required. Integer
Minimum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
autoscalingPolicies This property is required. GetClusterAutoscalingSettingAutoscalingPolicy[]

The map with autoscaling policies applied to the cluster. The key is the identifier of the policy. It must meet the following requirements:

  • Only contains 1-63 alphanumeric characters and hyphens
  • Begins with an alphabetical character
  • Ends with a non-hyphen character
  • Not formatted as a UUID
  • Complies with RFC 1034 (section 3.5)

Currently the map must contain only one element that describes the autoscaling policy for compute nodes.

coolDownPeriod This property is required. string
The minimum duration between consecutive autoscale operations. It starts once addition or removal of nodes is fully completed. Minimum cool down period is 30m. Cool down period must be in whole minutes (for example, 30m, 31m, 50m). Mandatory for successful addition of autoscaling settings in cluster.
maxClusterNodeCount This property is required. number
Maximum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
minClusterNodeCount This property is required. number
Minimum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
autoscaling_policies This property is required. Sequence[GetClusterAutoscalingSettingAutoscalingPolicy]

The map with autoscaling policies applied to the cluster. The key is the identifier of the policy. It must meet the following requirements:

  • Only contains 1-63 alphanumeric characters and hyphens
  • Begins with an alphabetical character
  • Ends with a non-hyphen character
  • Not formatted as a UUID
  • Complies with RFC 1034 (section 3.5)

Currently the map must contain only one element that describes the autoscaling policy for compute nodes.

cool_down_period This property is required. str
The minimum duration between consecutive autoscale operations. It starts once addition or removal of nodes is fully completed. Minimum cool down period is 30m. Cool down period must be in whole minutes (for example, 30m, 31m, 50m). Mandatory for successful addition of autoscaling settings in cluster.
max_cluster_node_count This property is required. int
Maximum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
min_cluster_node_count This property is required. int
Minimum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
autoscalingPolicies This property is required. List<Property Map>

The map with autoscaling policies applied to the cluster. The key is the identifier of the policy. It must meet the following requirements:

  • Only contains 1-63 alphanumeric characters and hyphens
  • Begins with an alphabetical character
  • Ends with a non-hyphen character
  • Not formatted as a UUID
  • Complies with RFC 1034 (section 3.5)

Currently the map must contain only one element that describes the autoscaling policy for compute nodes.

coolDownPeriod This property is required. String
The minimum duration between consecutive autoscale operations. It starts once addition or removal of nodes is fully completed. Minimum cool down period is 30m. Cool down period must be in whole minutes (for example, 30m, 31m, 50m). Mandatory for successful addition of autoscaling settings in cluster.
maxClusterNodeCount This property is required. Number
Maximum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.
minClusterNodeCount This property is required. Number
Minimum number of nodes of any type in a cluster. Mandatory for successful addition of autoscaling settings in cluster.

GetClusterAutoscalingSettingAutoscalingPolicy

AutoscalePolicyId This property is required. string
ConsumedMemoryThresholds This property is required. List<GetClusterAutoscalingSettingAutoscalingPolicyConsumedMemoryThreshold>
Utilization thresholds pertaining to amount of consumed memory.
CpuThresholds This property is required. List<GetClusterAutoscalingSettingAutoscalingPolicyCpuThreshold>
Utilization thresholds pertaining to CPU utilization.
NodeTypeId This property is required. string
The canonical identifier of the node type to add or remove.
ScaleOutSize This property is required. int
Number of nodes to add to a cluster during a scale-out operation. Must be divisible by 2 for stretched clusters.
StorageThresholds This property is required. List<GetClusterAutoscalingSettingAutoscalingPolicyStorageThreshold>
Utilization thresholds pertaining to amount of consumed storage.
AutoscalePolicyId This property is required. string
ConsumedMemoryThresholds This property is required. []GetClusterAutoscalingSettingAutoscalingPolicyConsumedMemoryThreshold
Utilization thresholds pertaining to amount of consumed memory.
CpuThresholds This property is required. []GetClusterAutoscalingSettingAutoscalingPolicyCpuThreshold
Utilization thresholds pertaining to CPU utilization.
NodeTypeId This property is required. string
The canonical identifier of the node type to add or remove.
ScaleOutSize This property is required. int
Number of nodes to add to a cluster during a scale-out operation. Must be divisible by 2 for stretched clusters.
StorageThresholds This property is required. []GetClusterAutoscalingSettingAutoscalingPolicyStorageThreshold
Utilization thresholds pertaining to amount of consumed storage.
autoscalePolicyId This property is required. String
consumedMemoryThresholds This property is required. List<GetClusterAutoscalingSettingAutoscalingPolicyConsumedMemoryThreshold>
Utilization thresholds pertaining to amount of consumed memory.
cpuThresholds This property is required. List<GetClusterAutoscalingSettingAutoscalingPolicyCpuThreshold>
Utilization thresholds pertaining to CPU utilization.
nodeTypeId This property is required. String
The canonical identifier of the node type to add or remove.
scaleOutSize This property is required. Integer
Number of nodes to add to a cluster during a scale-out operation. Must be divisible by 2 for stretched clusters.
storageThresholds This property is required. List<GetClusterAutoscalingSettingAutoscalingPolicyStorageThreshold>
Utilization thresholds pertaining to amount of consumed storage.
autoscalePolicyId This property is required. string
consumedMemoryThresholds This property is required. GetClusterAutoscalingSettingAutoscalingPolicyConsumedMemoryThreshold[]
Utilization thresholds pertaining to amount of consumed memory.
cpuThresholds This property is required. GetClusterAutoscalingSettingAutoscalingPolicyCpuThreshold[]
Utilization thresholds pertaining to CPU utilization.
nodeTypeId This property is required. string
The canonical identifier of the node type to add or remove.
scaleOutSize This property is required. number
Number of nodes to add to a cluster during a scale-out operation. Must be divisible by 2 for stretched clusters.
storageThresholds This property is required. GetClusterAutoscalingSettingAutoscalingPolicyStorageThreshold[]
Utilization thresholds pertaining to amount of consumed storage.
autoscale_policy_id This property is required. str
consumed_memory_thresholds This property is required. Sequence[GetClusterAutoscalingSettingAutoscalingPolicyConsumedMemoryThreshold]
Utilization thresholds pertaining to amount of consumed memory.
cpu_thresholds This property is required. Sequence[GetClusterAutoscalingSettingAutoscalingPolicyCpuThreshold]
Utilization thresholds pertaining to CPU utilization.
node_type_id This property is required. str
The canonical identifier of the node type to add or remove.
scale_out_size This property is required. int
Number of nodes to add to a cluster during a scale-out operation. Must be divisible by 2 for stretched clusters.
storage_thresholds This property is required. Sequence[GetClusterAutoscalingSettingAutoscalingPolicyStorageThreshold]
Utilization thresholds pertaining to amount of consumed storage.
autoscalePolicyId This property is required. String
consumedMemoryThresholds This property is required. List<Property Map>
Utilization thresholds pertaining to amount of consumed memory.
cpuThresholds This property is required. List<Property Map>
Utilization thresholds pertaining to CPU utilization.
nodeTypeId This property is required. String
The canonical identifier of the node type to add or remove.
scaleOutSize This property is required. Number
Number of nodes to add to a cluster during a scale-out operation. Must be divisible by 2 for stretched clusters.
storageThresholds This property is required. List<Property Map>
Utilization thresholds pertaining to amount of consumed storage.

GetClusterAutoscalingSettingAutoscalingPolicyConsumedMemoryThreshold

ScaleIn This property is required. int
The utilization triggering the scale-in operation in percent.
ScaleOut This property is required. int
The utilization triggering the scale-out operation in percent.
ScaleIn This property is required. int
The utilization triggering the scale-in operation in percent.
ScaleOut This property is required. int
The utilization triggering the scale-out operation in percent.
scaleIn This property is required. Integer
The utilization triggering the scale-in operation in percent.
scaleOut This property is required. Integer
The utilization triggering the scale-out operation in percent.
scaleIn This property is required. number
The utilization triggering the scale-in operation in percent.
scaleOut This property is required. number
The utilization triggering the scale-out operation in percent.
scale_in This property is required. int
The utilization triggering the scale-in operation in percent.
scale_out This property is required. int
The utilization triggering the scale-out operation in percent.
scaleIn This property is required. Number
The utilization triggering the scale-in operation in percent.
scaleOut This property is required. Number
The utilization triggering the scale-out operation in percent.

GetClusterAutoscalingSettingAutoscalingPolicyCpuThreshold

ScaleIn This property is required. int
The utilization triggering the scale-in operation in percent.
ScaleOut This property is required. int
The utilization triggering the scale-out operation in percent.
ScaleIn This property is required. int
The utilization triggering the scale-in operation in percent.
ScaleOut This property is required. int
The utilization triggering the scale-out operation in percent.
scaleIn This property is required. Integer
The utilization triggering the scale-in operation in percent.
scaleOut This property is required. Integer
The utilization triggering the scale-out operation in percent.
scaleIn This property is required. number
The utilization triggering the scale-in operation in percent.
scaleOut This property is required. number
The utilization triggering the scale-out operation in percent.
scale_in This property is required. int
The utilization triggering the scale-in operation in percent.
scale_out This property is required. int
The utilization triggering the scale-out operation in percent.
scaleIn This property is required. Number
The utilization triggering the scale-in operation in percent.
scaleOut This property is required. Number
The utilization triggering the scale-out operation in percent.

GetClusterAutoscalingSettingAutoscalingPolicyStorageThreshold

ScaleIn This property is required. int
The utilization triggering the scale-in operation in percent.
ScaleOut This property is required. int
The utilization triggering the scale-out operation in percent.
ScaleIn This property is required. int
The utilization triggering the scale-in operation in percent.
ScaleOut This property is required. int
The utilization triggering the scale-out operation in percent.
scaleIn This property is required. Integer
The utilization triggering the scale-in operation in percent.
scaleOut This property is required. Integer
The utilization triggering the scale-out operation in percent.
scaleIn This property is required. number
The utilization triggering the scale-in operation in percent.
scaleOut This property is required. number
The utilization triggering the scale-out operation in percent.
scale_in This property is required. int
The utilization triggering the scale-in operation in percent.
scale_out This property is required. int
The utilization triggering the scale-out operation in percent.
scaleIn This property is required. Number
The utilization triggering the scale-in operation in percent.
scaleOut This property is required. Number
The utilization triggering the scale-out operation in percent.

GetClusterNodeTypeConfig

CustomCoreCount This property is required. int
Customized number of cores available to each node of the type. This number must always be one of 'nodeType.availableCustomCoreCounts'. If zero is provided max value from 'nodeType.availableCustomCoreCounts' will be used. Once the customer is created then corecount cannot be changed.
NodeCount This property is required. int
The number of nodes of this type in the cluster.
NodeTypeId This property is required. string
CustomCoreCount This property is required. int
Customized number of cores available to each node of the type. This number must always be one of 'nodeType.availableCustomCoreCounts'. If zero is provided max value from 'nodeType.availableCustomCoreCounts' will be used. Once the customer is created then corecount cannot be changed.
NodeCount This property is required. int
The number of nodes of this type in the cluster.
NodeTypeId This property is required. string
customCoreCount This property is required. Integer
Customized number of cores available to each node of the type. This number must always be one of 'nodeType.availableCustomCoreCounts'. If zero is provided max value from 'nodeType.availableCustomCoreCounts' will be used. Once the customer is created then corecount cannot be changed.
nodeCount This property is required. Integer
The number of nodes of this type in the cluster.
nodeTypeId This property is required. String
customCoreCount This property is required. number
Customized number of cores available to each node of the type. This number must always be one of 'nodeType.availableCustomCoreCounts'. If zero is provided max value from 'nodeType.availableCustomCoreCounts' will be used. Once the customer is created then corecount cannot be changed.
nodeCount This property is required. number
The number of nodes of this type in the cluster.
nodeTypeId This property is required. string
custom_core_count This property is required. int
Customized number of cores available to each node of the type. This number must always be one of 'nodeType.availableCustomCoreCounts'. If zero is provided max value from 'nodeType.availableCustomCoreCounts' will be used. Once the customer is created then corecount cannot be changed.
node_count This property is required. int
The number of nodes of this type in the cluster.
node_type_id This property is required. str
customCoreCount This property is required. Number
Customized number of cores available to each node of the type. This number must always be one of 'nodeType.availableCustomCoreCounts'. If zero is provided max value from 'nodeType.availableCustomCoreCounts' will be used. Once the customer is created then corecount cannot be changed.
nodeCount This property is required. Number
The number of nodes of this type in the cluster.
nodeTypeId This property is required. String

Package Details

Repository
Google Cloud (GCP) Classic pulumi/pulumi-gcp
License
Apache-2.0
Notes
This Pulumi package is based on the google-beta Terraform Provider.
Google Cloud v8.26.0 published on Thursday, Apr 10, 2025 by Pulumi