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

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.
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.

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.

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.

Return Value

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


Type Description
CannotDisableDrsOnClustersWithVAppsThrown if DRS is being disabled and the cluster contains one or more vApps.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.