1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Ocvp
  5. getClusters
Oracle Cloud Infrastructure v2.31.0 published on Thursday, Apr 17, 2025 by Pulumi

oci.Ocvp.getClusters

Explore with Pulumi AI

Oracle Cloud Infrastructure v2.31.0 published on Thursday, Apr 17, 2025 by Pulumi

This data source provides the list of Clusters in Oracle Cloud Infrastructure Oracle Cloud VMware Solution service.

Lists the Clusters in the specified compartment.

Example Usage

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

const testClusters = oci.Ocvp.getClusters({
    compartmentId: compartmentId,
    displayName: clusterDisplayName,
    sddcId: testSddc.id,
    state: clusterState,
});
Copy
import pulumi
import pulumi_oci as oci

test_clusters = oci.Ocvp.get_clusters(compartment_id=compartment_id,
    display_name=cluster_display_name,
    sddc_id=test_sddc["id"],
    state=cluster_state)
Copy
package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/ocvp"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ocvp.GetClusters(ctx, &ocvp.GetClustersArgs{
			CompartmentId: pulumi.StringRef(compartmentId),
			DisplayName:   pulumi.StringRef(clusterDisplayName),
			SddcId:        pulumi.StringRef(testSddc.Id),
			State:         pulumi.StringRef(clusterState),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testClusters = Oci.Ocvp.GetClusters.Invoke(new()
    {
        CompartmentId = compartmentId,
        DisplayName = clusterDisplayName,
        SddcId = testSddc.Id,
        State = clusterState,
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Ocvp.OcvpFunctions;
import com.pulumi.oci.Ocvp.inputs.GetClustersArgs;
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 testClusters = OcvpFunctions.getClusters(GetClustersArgs.builder()
            .compartmentId(compartmentId)
            .displayName(clusterDisplayName)
            .sddcId(testSddc.id())
            .state(clusterState)
            .build());

    }
}
Copy
variables:
  testClusters:
    fn::invoke:
      function: oci:Ocvp:getClusters
      arguments:
        compartmentId: ${compartmentId}
        displayName: ${clusterDisplayName}
        sddcId: ${testSddc.id}
        state: ${clusterState}
Copy

Using getClusters

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 getClusters(args: GetClustersArgs, opts?: InvokeOptions): Promise<GetClustersResult>
function getClustersOutput(args: GetClustersOutputArgs, opts?: InvokeOptions): Output<GetClustersResult>
Copy
def get_clusters(compartment_id: Optional[str] = None,
                 display_name: Optional[str] = None,
                 filters: Optional[Sequence[_ocvp.GetClustersFilter]] = None,
                 sddc_id: Optional[str] = None,
                 state: Optional[str] = None,
                 opts: Optional[InvokeOptions] = None) -> GetClustersResult
def get_clusters_output(compartment_id: Optional[pulumi.Input[str]] = None,
                 display_name: Optional[pulumi.Input[str]] = None,
                 filters: Optional[pulumi.Input[Sequence[pulumi.Input[_ocvp.GetClustersFilterArgs]]]] = None,
                 sddc_id: Optional[pulumi.Input[str]] = None,
                 state: Optional[pulumi.Input[str]] = None,
                 opts: Optional[InvokeOptions] = None) -> Output[GetClustersResult]
Copy
func GetClusters(ctx *Context, args *GetClustersArgs, opts ...InvokeOption) (*GetClustersResult, error)
func GetClustersOutput(ctx *Context, args *GetClustersOutputArgs, opts ...InvokeOption) GetClustersResultOutput
Copy

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

public static class GetClusters 
{
    public static Task<GetClustersResult> InvokeAsync(GetClustersArgs args, InvokeOptions? opts = null)
    public static Output<GetClustersResult> Invoke(GetClustersInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetClustersResult> getClusters(GetClustersArgs args, InvokeOptions options)
public static Output<GetClustersResult> getClusters(GetClustersArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: oci:Ocvp/getClusters:getClusters
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

CompartmentId string
The OCID of the compartment as optional parameter.
DisplayName string
A filter to return only resources that match the given display name exactly.
Filters Changes to this property will trigger replacement. List<GetClustersFilter>
SddcId string
The OCID of the SDDC.
State string
The lifecycle state of the resource.
CompartmentId string
The OCID of the compartment as optional parameter.
DisplayName string
A filter to return only resources that match the given display name exactly.
Filters Changes to this property will trigger replacement. []GetClustersFilter
SddcId string
The OCID of the SDDC.
State string
The lifecycle state of the resource.
compartmentId String
The OCID of the compartment as optional parameter.
displayName String
A filter to return only resources that match the given display name exactly.
filters Changes to this property will trigger replacement. List<GetClustersFilter>
sddcId String
The OCID of the SDDC.
state String
The lifecycle state of the resource.
compartmentId string
The OCID of the compartment as optional parameter.
displayName string
A filter to return only resources that match the given display name exactly.
filters Changes to this property will trigger replacement. GetClustersFilter[]
sddcId string
The OCID of the SDDC.
state string
The lifecycle state of the resource.
compartment_id str
The OCID of the compartment as optional parameter.
display_name str
A filter to return only resources that match the given display name exactly.
filters Changes to this property will trigger replacement. Sequence[ocvp.GetClustersFilter]
sddc_id str
The OCID of the SDDC.
state str
The lifecycle state of the resource.
compartmentId String
The OCID of the compartment as optional parameter.
displayName String
A filter to return only resources that match the given display name exactly.
filters Changes to this property will trigger replacement. List<Property Map>
sddcId String
The OCID of the SDDC.
state String
The lifecycle state of the resource.

getClusters Result

The following output properties are available:

ClusterCollections List<GetClustersClusterCollection>
The list of cluster_collection.
Id string
The provider-assigned unique ID for this managed resource.
CompartmentId string
The OCID of the compartment that contains the Cluster.
DisplayName string
A descriptive name for the Cluster. It must be unique, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information.
Filters List<GetClustersFilter>
SddcId string
The OCID of the SDDC that the Cluster belongs to.
State string
The current state of the Cluster.
ClusterCollections []GetClustersClusterCollection
The list of cluster_collection.
Id string
The provider-assigned unique ID for this managed resource.
CompartmentId string
The OCID of the compartment that contains the Cluster.
DisplayName string
A descriptive name for the Cluster. It must be unique, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information.
Filters []GetClustersFilter
SddcId string
The OCID of the SDDC that the Cluster belongs to.
State string
The current state of the Cluster.
clusterCollections List<GetClustersClusterCollection>
The list of cluster_collection.
id String
The provider-assigned unique ID for this managed resource.
compartmentId String
The OCID of the compartment that contains the Cluster.
displayName String
A descriptive name for the Cluster. It must be unique, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information.
filters List<GetClustersFilter>
sddcId String
The OCID of the SDDC that the Cluster belongs to.
state String
The current state of the Cluster.
clusterCollections GetClustersClusterCollection[]
The list of cluster_collection.
id string
The provider-assigned unique ID for this managed resource.
compartmentId string
The OCID of the compartment that contains the Cluster.
displayName string
A descriptive name for the Cluster. It must be unique, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information.
filters GetClustersFilter[]
sddcId string
The OCID of the SDDC that the Cluster belongs to.
state string
The current state of the Cluster.
cluster_collections Sequence[ocvp.GetClustersClusterCollection]
The list of cluster_collection.
id str
The provider-assigned unique ID for this managed resource.
compartment_id str
The OCID of the compartment that contains the Cluster.
display_name str
A descriptive name for the Cluster. It must be unique, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information.
filters Sequence[ocvp.GetClustersFilter]
sddc_id str
The OCID of the SDDC that the Cluster belongs to.
state str
The current state of the Cluster.
clusterCollections List<Property Map>
The list of cluster_collection.
id String
The provider-assigned unique ID for this managed resource.
compartmentId String
The OCID of the compartment that contains the Cluster.
displayName String
A descriptive name for the Cluster. It must be unique, start with a letter, and contain only letters, digits, whitespaces, dashes and underscores. Avoid entering confidential information.
filters List<Property Map>
sddcId String
The OCID of the SDDC that the Cluster belongs to.
state String
The current state of the Cluster.

Supporting Types

GetClustersClusterCollection

Items This property is required. []GetClustersClusterCollectionItem
items This property is required. GetClustersClusterCollectionItem[]
items This property is required. List<Property Map>

GetClustersClusterCollectionItem

ActualEsxiHostsCount This property is required. int
CapacityReservationId This property is required. string
The OCID of the Capacity Reservation.
CompartmentId This property is required. string
The OCID of the compartment as optional parameter.
ComputeAvailabilityDomain This property is required. string
The availability domain the ESXi hosts are running in. For Multi-AD Cluster, it is multi-AD. Example: Uocm:PHX-AD-1, multi-AD
Datastores This property is required. List<GetClustersClusterCollectionItemDatastore>
Datastores used for the Cluster.
DefinedTags This property is required. Dictionary<string, string>
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
DisplayName This property is required. string
A filter to return only resources that match the given display name exactly.
EsxiHostsCount This property is required. int
The number of ESXi hosts in the Cluster.
EsxiSoftwareVersion This property is required. string
In general, this is a specific version of bundled ESXi software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
FreeformTags This property is required. Dictionary<string, string>
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Id This property is required. string
The OCID of the Cluster.
InitialCommitment This property is required. string
The billing option selected during Cluster creation. ListSupportedCommitments.
InitialHostOcpuCount This property is required. double
The initial OCPU count of the Cluster's ESXi hosts.
InitialHostShapeName This property is required. string
The initial compute shape of the Cluster's ESXi hosts. ListSupportedHostShapes.
InstanceDisplayNamePrefix This property is required. string
A prefix used in the name of each ESXi host and Compute instance in the Cluster. If this isn't set, the Cluster's displayName is used as the prefix.
IsShieldedInstanceEnabled This property is required. bool
Indicates whether shielded instance is enabled at the Cluster level.
NetworkConfigurations This property is required. List<GetClustersClusterCollectionItemNetworkConfiguration>
The network configurations used by Cluster, including OCIDs of the management subnet and VLANs.
SddcId This property is required. string
The OCID of the SDDC.
State This property is required. string
The lifecycle state of the resource.
TimeCreated This property is required. string
The date and time the Cluster was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
TimeUpdated This property is required. string
The date and time the Cluster was updated, in the format defined by RFC3339.
UpgradeLicenses This property is required. List<GetClustersClusterCollectionItemUpgradeLicense>
The vSphere licenses to use when upgrading the Cluster.
VmwareSoftwareVersion This property is required. string
In general, this is a specific version of bundled VMware software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
VsphereType This property is required. string
vSphere Cluster types.
VsphereUpgradeObjects This property is required. List<GetClustersClusterCollectionItemVsphereUpgradeObject>
The links to binary objects needed to upgrade vSphere.
WorkloadNetworkCidr This property is required. string
The CIDR block for the IP addresses that VMware VMs in the SDDC use to run application workloads.
ActualEsxiHostsCount This property is required. int
CapacityReservationId This property is required. string
The OCID of the Capacity Reservation.
CompartmentId This property is required. string
The OCID of the compartment as optional parameter.
ComputeAvailabilityDomain This property is required. string
The availability domain the ESXi hosts are running in. For Multi-AD Cluster, it is multi-AD. Example: Uocm:PHX-AD-1, multi-AD
Datastores This property is required. []GetClustersClusterCollectionItemDatastore
Datastores used for the Cluster.
DefinedTags This property is required. map[string]string
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
DisplayName This property is required. string
A filter to return only resources that match the given display name exactly.
EsxiHostsCount This property is required. int
The number of ESXi hosts in the Cluster.
EsxiSoftwareVersion This property is required. string
In general, this is a specific version of bundled ESXi software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
FreeformTags This property is required. map[string]string
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Id This property is required. string
The OCID of the Cluster.
InitialCommitment This property is required. string
The billing option selected during Cluster creation. ListSupportedCommitments.
InitialHostOcpuCount This property is required. float64
The initial OCPU count of the Cluster's ESXi hosts.
InitialHostShapeName This property is required. string
The initial compute shape of the Cluster's ESXi hosts. ListSupportedHostShapes.
InstanceDisplayNamePrefix This property is required. string
A prefix used in the name of each ESXi host and Compute instance in the Cluster. If this isn't set, the Cluster's displayName is used as the prefix.
IsShieldedInstanceEnabled This property is required. bool
Indicates whether shielded instance is enabled at the Cluster level.
NetworkConfigurations This property is required. []GetClustersClusterCollectionItemNetworkConfiguration
The network configurations used by Cluster, including OCIDs of the management subnet and VLANs.
SddcId This property is required. string
The OCID of the SDDC.
State This property is required. string
The lifecycle state of the resource.
TimeCreated This property is required. string
The date and time the Cluster was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
TimeUpdated This property is required. string
The date and time the Cluster was updated, in the format defined by RFC3339.
UpgradeLicenses This property is required. []GetClustersClusterCollectionItemUpgradeLicense
The vSphere licenses to use when upgrading the Cluster.
VmwareSoftwareVersion This property is required. string
In general, this is a specific version of bundled VMware software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
VsphereType This property is required. string
vSphere Cluster types.
VsphereUpgradeObjects This property is required. []GetClustersClusterCollectionItemVsphereUpgradeObject
The links to binary objects needed to upgrade vSphere.
WorkloadNetworkCidr This property is required. string
The CIDR block for the IP addresses that VMware VMs in the SDDC use to run application workloads.
actualEsxiHostsCount This property is required. Integer
capacityReservationId This property is required. String
The OCID of the Capacity Reservation.
compartmentId This property is required. String
The OCID of the compartment as optional parameter.
computeAvailabilityDomain This property is required. String
The availability domain the ESXi hosts are running in. For Multi-AD Cluster, it is multi-AD. Example: Uocm:PHX-AD-1, multi-AD
datastores This property is required. List<GetClustersClusterCollectionItemDatastore>
Datastores used for the Cluster.
definedTags This property is required. Map<String,String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
displayName This property is required. String
A filter to return only resources that match the given display name exactly.
esxiHostsCount This property is required. Integer
The number of ESXi hosts in the Cluster.
esxiSoftwareVersion This property is required. String
In general, this is a specific version of bundled ESXi software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
freeformTags This property is required. Map<String,String>
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id This property is required. String
The OCID of the Cluster.
initialCommitment This property is required. String
The billing option selected during Cluster creation. ListSupportedCommitments.
initialHostOcpuCount This property is required. Double
The initial OCPU count of the Cluster's ESXi hosts.
initialHostShapeName This property is required. String
The initial compute shape of the Cluster's ESXi hosts. ListSupportedHostShapes.
instanceDisplayNamePrefix This property is required. String
A prefix used in the name of each ESXi host and Compute instance in the Cluster. If this isn't set, the Cluster's displayName is used as the prefix.
isShieldedInstanceEnabled This property is required. Boolean
Indicates whether shielded instance is enabled at the Cluster level.
networkConfigurations This property is required. List<GetClustersClusterCollectionItemNetworkConfiguration>
The network configurations used by Cluster, including OCIDs of the management subnet and VLANs.
sddcId This property is required. String
The OCID of the SDDC.
state This property is required. String
The lifecycle state of the resource.
timeCreated This property is required. String
The date and time the Cluster was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
timeUpdated This property is required. String
The date and time the Cluster was updated, in the format defined by RFC3339.
upgradeLicenses This property is required. List<GetClustersClusterCollectionItemUpgradeLicense>
The vSphere licenses to use when upgrading the Cluster.
vmwareSoftwareVersion This property is required. String
In general, this is a specific version of bundled VMware software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
vsphereType This property is required. String
vSphere Cluster types.
vsphereUpgradeObjects This property is required. List<GetClustersClusterCollectionItemVsphereUpgradeObject>
The links to binary objects needed to upgrade vSphere.
workloadNetworkCidr This property is required. String
The CIDR block for the IP addresses that VMware VMs in the SDDC use to run application workloads.
actualEsxiHostsCount This property is required. number
capacityReservationId This property is required. string
The OCID of the Capacity Reservation.
compartmentId This property is required. string
The OCID of the compartment as optional parameter.
computeAvailabilityDomain This property is required. string
The availability domain the ESXi hosts are running in. For Multi-AD Cluster, it is multi-AD. Example: Uocm:PHX-AD-1, multi-AD
datastores This property is required. GetClustersClusterCollectionItemDatastore[]
Datastores used for the Cluster.
definedTags This property is required. {[key: string]: string}
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
displayName This property is required. string
A filter to return only resources that match the given display name exactly.
esxiHostsCount This property is required. number
The number of ESXi hosts in the Cluster.
esxiSoftwareVersion This property is required. string
In general, this is a specific version of bundled ESXi software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
freeformTags This property is required. {[key: string]: string}
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id This property is required. string
The OCID of the Cluster.
initialCommitment This property is required. string
The billing option selected during Cluster creation. ListSupportedCommitments.
initialHostOcpuCount This property is required. number
The initial OCPU count of the Cluster's ESXi hosts.
initialHostShapeName This property is required. string
The initial compute shape of the Cluster's ESXi hosts. ListSupportedHostShapes.
instanceDisplayNamePrefix This property is required. string
A prefix used in the name of each ESXi host and Compute instance in the Cluster. If this isn't set, the Cluster's displayName is used as the prefix.
isShieldedInstanceEnabled This property is required. boolean
Indicates whether shielded instance is enabled at the Cluster level.
networkConfigurations This property is required. GetClustersClusterCollectionItemNetworkConfiguration[]
The network configurations used by Cluster, including OCIDs of the management subnet and VLANs.
sddcId This property is required. string
The OCID of the SDDC.
state This property is required. string
The lifecycle state of the resource.
timeCreated This property is required. string
The date and time the Cluster was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
timeUpdated This property is required. string
The date and time the Cluster was updated, in the format defined by RFC3339.
upgradeLicenses This property is required. GetClustersClusterCollectionItemUpgradeLicense[]
The vSphere licenses to use when upgrading the Cluster.
vmwareSoftwareVersion This property is required. string
In general, this is a specific version of bundled VMware software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
vsphereType This property is required. string
vSphere Cluster types.
vsphereUpgradeObjects This property is required. GetClustersClusterCollectionItemVsphereUpgradeObject[]
The links to binary objects needed to upgrade vSphere.
workloadNetworkCidr This property is required. string
The CIDR block for the IP addresses that VMware VMs in the SDDC use to run application workloads.
actual_esxi_hosts_count This property is required. int
capacity_reservation_id This property is required. str
The OCID of the Capacity Reservation.
compartment_id This property is required. str
The OCID of the compartment as optional parameter.
compute_availability_domain This property is required. str
The availability domain the ESXi hosts are running in. For Multi-AD Cluster, it is multi-AD. Example: Uocm:PHX-AD-1, multi-AD
datastores This property is required. Sequence[ocvp.GetClustersClusterCollectionItemDatastore]
Datastores used for the Cluster.
defined_tags This property is required. Mapping[str, str]
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
display_name This property is required. str
A filter to return only resources that match the given display name exactly.
esxi_hosts_count This property is required. int
The number of ESXi hosts in the Cluster.
esxi_software_version This property is required. str
In general, this is a specific version of bundled ESXi software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
freeform_tags This property is required. Mapping[str, str]
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id This property is required. str
The OCID of the Cluster.
initial_commitment This property is required. str
The billing option selected during Cluster creation. ListSupportedCommitments.
initial_host_ocpu_count This property is required. float
The initial OCPU count of the Cluster's ESXi hosts.
initial_host_shape_name This property is required. str
The initial compute shape of the Cluster's ESXi hosts. ListSupportedHostShapes.
instance_display_name_prefix This property is required. str
A prefix used in the name of each ESXi host and Compute instance in the Cluster. If this isn't set, the Cluster's displayName is used as the prefix.
is_shielded_instance_enabled This property is required. bool
Indicates whether shielded instance is enabled at the Cluster level.
network_configurations This property is required. Sequence[ocvp.GetClustersClusterCollectionItemNetworkConfiguration]
The network configurations used by Cluster, including OCIDs of the management subnet and VLANs.
sddc_id This property is required. str
The OCID of the SDDC.
state This property is required. str
The lifecycle state of the resource.
time_created This property is required. str
The date and time the Cluster was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
time_updated This property is required. str
The date and time the Cluster was updated, in the format defined by RFC3339.
upgrade_licenses This property is required. Sequence[ocvp.GetClustersClusterCollectionItemUpgradeLicense]
The vSphere licenses to use when upgrading the Cluster.
vmware_software_version This property is required. str
In general, this is a specific version of bundled VMware software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
vsphere_type This property is required. str
vSphere Cluster types.
vsphere_upgrade_objects This property is required. Sequence[ocvp.GetClustersClusterCollectionItemVsphereUpgradeObject]
The links to binary objects needed to upgrade vSphere.
workload_network_cidr This property is required. str
The CIDR block for the IP addresses that VMware VMs in the SDDC use to run application workloads.
actualEsxiHostsCount This property is required. Number
capacityReservationId This property is required. String
The OCID of the Capacity Reservation.
compartmentId This property is required. String
The OCID of the compartment as optional parameter.
computeAvailabilityDomain This property is required. String
The availability domain the ESXi hosts are running in. For Multi-AD Cluster, it is multi-AD. Example: Uocm:PHX-AD-1, multi-AD
datastores This property is required. List<Property Map>
Datastores used for the Cluster.
definedTags This property is required. Map<String>
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
displayName This property is required. String
A filter to return only resources that match the given display name exactly.
esxiHostsCount This property is required. Number
The number of ESXi hosts in the Cluster.
esxiSoftwareVersion This property is required. String
In general, this is a specific version of bundled ESXi software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
freeformTags This property is required. Map<String>
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id This property is required. String
The OCID of the Cluster.
initialCommitment This property is required. String
The billing option selected during Cluster creation. ListSupportedCommitments.
initialHostOcpuCount This property is required. Number
The initial OCPU count of the Cluster's ESXi hosts.
initialHostShapeName This property is required. String
The initial compute shape of the Cluster's ESXi hosts. ListSupportedHostShapes.
instanceDisplayNamePrefix This property is required. String
A prefix used in the name of each ESXi host and Compute instance in the Cluster. If this isn't set, the Cluster's displayName is used as the prefix.
isShieldedInstanceEnabled This property is required. Boolean
Indicates whether shielded instance is enabled at the Cluster level.
networkConfigurations This property is required. List<Property Map>
The network configurations used by Cluster, including OCIDs of the management subnet and VLANs.
sddcId This property is required. String
The OCID of the SDDC.
state This property is required. String
The lifecycle state of the resource.
timeCreated This property is required. String
The date and time the Cluster was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
timeUpdated This property is required. String
The date and time the Cluster was updated, in the format defined by RFC3339.
upgradeLicenses This property is required. List<Property Map>
The vSphere licenses to use when upgrading the Cluster.
vmwareSoftwareVersion This property is required. String
In general, this is a specific version of bundled VMware software supported by Oracle Cloud VMware Solution (see ListSupportedVmwareSoftwareVersions).
vsphereType This property is required. String
vSphere Cluster types.
vsphereUpgradeObjects This property is required. List<Property Map>
The links to binary objects needed to upgrade vSphere.
workloadNetworkCidr This property is required. String
The CIDR block for the IP addresses that VMware VMs in the SDDC use to run application workloads.

GetClustersClusterCollectionItemDatastore

BlockVolumeIds This property is required. List<string>
A list of OCIDs of Block Storage Volumes.
Capacity This property is required. double
Size of the Block Storage Volume in GB.
DatastoreType This property is required. string
Type of the datastore.
BlockVolumeIds This property is required. []string
A list of OCIDs of Block Storage Volumes.
Capacity This property is required. float64
Size of the Block Storage Volume in GB.
DatastoreType This property is required. string
Type of the datastore.
blockVolumeIds This property is required. List<String>
A list of OCIDs of Block Storage Volumes.
capacity This property is required. Double
Size of the Block Storage Volume in GB.
datastoreType This property is required. String
Type of the datastore.
blockVolumeIds This property is required. string[]
A list of OCIDs of Block Storage Volumes.
capacity This property is required. number
Size of the Block Storage Volume in GB.
datastoreType This property is required. string
Type of the datastore.
block_volume_ids This property is required. Sequence[str]
A list of OCIDs of Block Storage Volumes.
capacity This property is required. float
Size of the Block Storage Volume in GB.
datastore_type This property is required. str
Type of the datastore.
blockVolumeIds This property is required. List<String>
A list of OCIDs of Block Storage Volumes.
capacity This property is required. Number
Size of the Block Storage Volume in GB.
datastoreType This property is required. String
Type of the datastore.

GetClustersClusterCollectionItemNetworkConfiguration

HcxVlanId This property is required. string
The OCID of the VLAN used by the SDDC for the HCX component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster when HCX is enabled.
NsxEdgeUplink1vlanId This property is required. string
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 1 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
NsxEdgeUplink2vlanId This property is required. string
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 2 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
NsxEdgeVtepVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the NSX Edge VTEP component of the VMware environment.
NsxVtepVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the NSX VTEP component of the VMware environment.
ProvisioningSubnetId This property is required. string
The OCID of the management subnet used to provision the Cluster.
ProvisioningVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the Provisioning component of the VMware environment.
ReplicationVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the vSphere Replication component of the VMware environment.
VmotionVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the vMotion component of the VMware environment.
VsanVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the vSAN component of the VMware environment.
VsphereVlanId This property is required. string
The OCID of the VLAN used by the SDDC for the vSphere component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
HcxVlanId This property is required. string
The OCID of the VLAN used by the SDDC for the HCX component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster when HCX is enabled.
NsxEdgeUplink1vlanId This property is required. string
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 1 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
NsxEdgeUplink2vlanId This property is required. string
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 2 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
NsxEdgeVtepVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the NSX Edge VTEP component of the VMware environment.
NsxVtepVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the NSX VTEP component of the VMware environment.
ProvisioningSubnetId This property is required. string
The OCID of the management subnet used to provision the Cluster.
ProvisioningVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the Provisioning component of the VMware environment.
ReplicationVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the vSphere Replication component of the VMware environment.
VmotionVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the vMotion component of the VMware environment.
VsanVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the vSAN component of the VMware environment.
VsphereVlanId This property is required. string
The OCID of the VLAN used by the SDDC for the vSphere component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
hcxVlanId This property is required. String
The OCID of the VLAN used by the SDDC for the HCX component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster when HCX is enabled.
nsxEdgeUplink1vlanId This property is required. String
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 1 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
nsxEdgeUplink2vlanId This property is required. String
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 2 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
nsxEdgeVtepVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the NSX Edge VTEP component of the VMware environment.
nsxVtepVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the NSX VTEP component of the VMware environment.
provisioningSubnetId This property is required. String
The OCID of the management subnet used to provision the Cluster.
provisioningVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the Provisioning component of the VMware environment.
replicationVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the vSphere Replication component of the VMware environment.
vmotionVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the vMotion component of the VMware environment.
vsanVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the vSAN component of the VMware environment.
vsphereVlanId This property is required. String
The OCID of the VLAN used by the SDDC for the vSphere component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
hcxVlanId This property is required. string
The OCID of the VLAN used by the SDDC for the HCX component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster when HCX is enabled.
nsxEdgeUplink1vlanId This property is required. string
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 1 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
nsxEdgeUplink2vlanId This property is required. string
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 2 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
nsxEdgeVtepVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the NSX Edge VTEP component of the VMware environment.
nsxVtepVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the NSX VTEP component of the VMware environment.
provisioningSubnetId This property is required. string
The OCID of the management subnet used to provision the Cluster.
provisioningVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the Provisioning component of the VMware environment.
replicationVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the vSphere Replication component of the VMware environment.
vmotionVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the vMotion component of the VMware environment.
vsanVlanId This property is required. string
The OCID of the VLAN used by the Cluster for the vSAN component of the VMware environment.
vsphereVlanId This property is required. string
The OCID of the VLAN used by the SDDC for the vSphere component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
hcx_vlan_id This property is required. str
The OCID of the VLAN used by the SDDC for the HCX component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster when HCX is enabled.
nsx_edge_uplink1vlan_id This property is required. str
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 1 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
nsx_edge_uplink2vlan_id This property is required. str
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 2 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
nsx_edge_vtep_vlan_id This property is required. str
The OCID of the VLAN used by the Cluster for the NSX Edge VTEP component of the VMware environment.
nsx_vtep_vlan_id This property is required. str
The OCID of the VLAN used by the Cluster for the NSX VTEP component of the VMware environment.
provisioning_subnet_id This property is required. str
The OCID of the management subnet used to provision the Cluster.
provisioning_vlan_id This property is required. str
The OCID of the VLAN used by the Cluster for the Provisioning component of the VMware environment.
replication_vlan_id This property is required. str
The OCID of the VLAN used by the Cluster for the vSphere Replication component of the VMware environment.
vmotion_vlan_id This property is required. str
The OCID of the VLAN used by the Cluster for the vMotion component of the VMware environment.
vsan_vlan_id This property is required. str
The OCID of the VLAN used by the Cluster for the vSAN component of the VMware environment.
vsphere_vlan_id This property is required. str
The OCID of the VLAN used by the SDDC for the vSphere component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
hcxVlanId This property is required. String
The OCID of the VLAN used by the SDDC for the HCX component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster when HCX is enabled.
nsxEdgeUplink1vlanId This property is required. String
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 1 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
nsxEdgeUplink2vlanId This property is required. String
The OCID of the VLAN used by the SDDC for the NSX Edge Uplink 2 component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.
nsxEdgeVtepVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the NSX Edge VTEP component of the VMware environment.
nsxVtepVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the NSX VTEP component of the VMware environment.
provisioningSubnetId This property is required. String
The OCID of the management subnet used to provision the Cluster.
provisioningVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the Provisioning component of the VMware environment.
replicationVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the vSphere Replication component of the VMware environment.
vmotionVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the vMotion component of the VMware environment.
vsanVlanId This property is required. String
The OCID of the VLAN used by the Cluster for the vSAN component of the VMware environment.
vsphereVlanId This property is required. String
The OCID of the VLAN used by the SDDC for the vSphere component of the VMware environment. This VLAN is a mandatory attribute for Management Cluster.

GetClustersClusterCollectionItemUpgradeLicense

LicenseKey This property is required. string
vSphere license key value.
LicenseType This property is required. string
vSphere license type.
LicenseKey This property is required. string
vSphere license key value.
LicenseType This property is required. string
vSphere license type.
licenseKey This property is required. String
vSphere license key value.
licenseType This property is required. String
vSphere license type.
licenseKey This property is required. string
vSphere license key value.
licenseType This property is required. string
vSphere license type.
license_key This property is required. str
vSphere license key value.
license_type This property is required. str
vSphere license type.
licenseKey This property is required. String
vSphere license key value.
licenseType This property is required. String
vSphere license type.

GetClustersClusterCollectionItemVsphereUpgradeObject

DownloadLink This property is required. string
Binary object download link.
LinkDescription This property is required. string
Binary object description.
DownloadLink This property is required. string
Binary object download link.
LinkDescription This property is required. string
Binary object description.
downloadLink This property is required. String
Binary object download link.
linkDescription This property is required. String
Binary object description.
downloadLink This property is required. string
Binary object download link.
linkDescription This property is required. string
Binary object description.
download_link This property is required. str
Binary object download link.
link_description This property is required. str
Binary object description.
downloadLink This property is required. String
Binary object download link.
linkDescription This property is required. String
Binary object description.

GetClustersFilter

Name This property is required. string
Values This property is required. List<string>
Regex bool
Name This property is required. string
Values This property is required. []string
Regex bool
name This property is required. String
values This property is required. List<String>
regex Boolean
name This property is required. string
values This property is required. string[]
regex boolean
name This property is required. str
values This property is required. Sequence[str]
regex bool
name This property is required. String
values This property is required. List<String>
regex Boolean

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes
This Pulumi package is based on the oci Terraform Provider.
Oracle Cloud Infrastructure v2.31.0 published on Thursday, Apr 17, 2025 by Pulumi