Managed Object - ComputeResource

Property of
ComputeResourceEventArgument, NoActiveHostInCluster, ResourcePool
Returned by
AddStandaloneHost_Task
Extended by
ClusterComputeResource
Extends
ManagedEntity
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.

Properties

Name Type Description
configurationExComputeResourceConfigInfo

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

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

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

ReconfigureComputeResource_Task

Change the compute resource configuration.
Required Privileges
Host.Inventory.EditCluster
Since
VI API 2.5

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the ComputeResource used to make the method call.
specComputeResourceConfigSpec

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

Return Value

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

Faults

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.