Managed Object - ComputeResource(vim.ComputeResource)

Property of
ComputeResourceEventArgument, FailToEnableSPBM, NoActiveHostInCluster, ResourcePool
Parameter to
InstallIoFilter_Task, QueryDisksUsingFilter, QueryIoFilterInfo, QueryIoFilterIssues, UninstallIoFilter_Task, UpgradeIoFilter_Task
Returned by
Extended by
See also
ComputeResourceConfigInfo, ComputeResourceConfigSpec, ComputeResourceSummary, Datastore, EnvironmentBrowser, HostSystem, Network, ResourcePool

Managed Object Description

Represents a set of physical compute resources for a set of virtual machines.

The base type ComputeResource, when instantiated by calling AddStandaloneHost_Task, represents a single host. The subclass ClusterComputeResource represents a cluster of hosts and adds distributed management features such as availability and resource scheduling.

A ComputeResource always has a root ResourcePool associated with it. Certain types of clusters such as those with VMware DRS enabled and standalone hosts (ESX Server 3) support the creation of ResourcePool hierarchies.


Name Type Description
configManagerEnabled* Pxsd:boolean

Flag indicating whether or not desired configuration management platform is enabled on the compute resource. This property can be set only at the time of creation or through the EnableConfigurationManagement method.


Configuration of the compute resource; applies to both standalone hosts and clusters. For a cluster this property will return a ClusterConfigInfoEx object.

Since VI API 2.5
datastore* PManagedObjectReference[]
to a Datastore[]

The datastore property is the subset of datastore objects in the datacenter available in this ComputeResource.

This property is computed as the aggregate set of datastores available from all the hosts that are part of this compute resource.

environmentBrowser* PManagedObjectReference
to a EnvironmentBrowser

The environment browser object that identifies the environments that are supported on this compute resource.
host* PManagedObjectReference[]
to a HostSystem[]

List of hosts that are part of this compute resource. If the compute resource is a standalone type, then this list contains just one element.
lifecycleManaged* Pxsd:boolean

Flag indicating whether or not the lifecycle of the compute resource is managed. Once it is enabled, it cannot be disabled. This property can be set only at the time of creation or through the EnableLifecycleManagement method.

Since vSphere API 6.9.1
network* PManagedObjectReference[]
to a Network[]

The subset of network objects available in the datacenter that is available in this ComputeResource.

This property is computed as the aggregate set of networks available from all the hosts that are part of this compute resource.

resourcePool* PManagedObjectReference
to a ResourcePool

Reference to root resource pool.

Basic runtime information about a compute resource. This information is used on summary screens and in list views.
Properties inherited from ManagedEntity
alarmActionsEnabled, configIssue, configStatus, customValue, declaredAlarmState, disabledMethod, effectiveRole, name, overallStatus, parent, permission, recentTask, tag, triggeredAlarmState
Properties inherited from ExtensibleManagedObject
availableField, value
*May not be presentP Required privilege: System.View


Methods defined in this Managed Object
Methods inherited from ManagedEntity
Destroy_Task, Reload, Rename_Task
Methods inherited from ExtensibleManagedObject


Change the compute resource configuration.
Required Privileges
VI API 2.5


_thisManagedObjectReference A reference to the ComputeResource used to make the method call.
spec PComputeResourceConfigSpec

A set of configuration changes to apply to the compute resource. The specification can be a complete set of changes or a partial set of changes, applied incrementally. When invoking reconfigureEx on a cluster, this argument may be a ClusterConfigSpecEx object.

Since VI API 2.5
modify Pxsd:boolean

Flag to specify whether the specification ("spec") should be applied incrementally. If "modify" is false and the operation succeeds, then the configuration of the cluster matches the specification exactly; in this case any unset portions of the specification will result in unset or default portions of the configuration.

Since VI API 2.5
PRequired privilege - see tooltip for details

Return Value

Type Description
to a Task
This method returns a Task object with which to monitor the operation.


Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.