# Data Object - EVCMode(vim.EVCMode)

Property of
  Capability, ClusterEVCManagerEVCState
Extends
  ElementDescription
See also
  HostCpuIdInfo, HostFeatureCapability, HostFeatureMask, VirtualMachineFeatureRequirement
Since
  vSphere API 4.0

## Data Object Description

The EVCMode data object describes an Enhanced vMotion Compatibility mode. An EVC mode is associated with a set of CPU features. A vCenter Server defines the available EVC modes. You use them to establish a common set of features for compatibility between hosts in a cluster. An EVC-enabled cluster supports safe vMotion of virtual machines across a range of CPU generations. You must use the vSphere Client to configure EVC.

When you add a host to an EVC-enabled cluster, the vCenter Server determines the CPU compatibility to preserve vMotion compatibility within the cluster. If the host CPU is compatible with those already in the cluster, the Server adds the host to the cluster and configures it for compatible operation. Hosts that are not compatible are not allowed to join the cluster.

The inherited key property is a string value that uniquely identifies an EVC mode. The vCenter Server assigns the key value; the vSphere API uses the key to identify modes in summary and information objects:

- ClusterComputeResourceSummary.currentEVCModeKey
- HostListSummary.currentEVCModeKey
- HostListSummary.maxEVCModeKey
- VirtualMachineRuntimeInfo.minRequiredEVCModeKey

The inherited label and summary properties are human-readable strings.

You can use the track and vendorTier properties to determine feature-superset relationships between modes without examining the individual feature bits in guaranteedCPUFeatures. The CPU feature baseline of mode A is a superset of mode B's baseline if and only if:

- modeA.track is the same as or a superset of modeB.track
- modeA.vendorTier is equal to or greater than modeB.vendorTier

Use the track and vendorTier properties only for the purpose of feature-superset calculations as described above. Do not use them to infer the presence or absence of specific features. The property values for a given mode may change across releases as the set of available EVC modes changes, to better represent mode relationships.

Properties

Name | Type | Description
--- | --- | ---
featureCapability* | HostFeatureCapability[] | Describes the feature capability baseline associated with the EVC mode. On the cluster where a particular EVC mode is configured, these features capabilities are guaranteed, either because the host hardware naturally matches those features or because feature masks are used to mask out differences and enforce a match. Since vSphere API 5.1
featureMask* | HostFeatureMask[] | The masks (modifications to a host's feature capabilities) that limit a host's capabilities to that of the EVC mode baseline. Since vSphere API 5.1
featureRequirement* | VirtualMachineFeatureRequirement[] | The conditions that must be true of a host's feature capabilities in order for the host to meet the minimum requirements of the EVC mode baseline. Since vSphere API 5.1
guaranteedCPUFeatures* | HostCpuIdInfo[] | Deprecated. As of vSphere API 6.5 use featureCapability Describes the CPU feature baseline associated with the EVC mode. On the cluster where a particular EVC mode is configured, those CPU features are guaranteed, either because the host hardware naturally matches those features or because CPU feature override is used to mask out differences and enforce a match. Since vSphere API 4.1
track | xsd:string[] | Identifiers for feature groups that are at least partially present in the guaranteedCPUFeatures array for this mode. Use this property to compare track values from two modes. Do not use this property to determine the presence or absence of specific features. Since vSphere API 4.1
vendor | xsd:string | CPU hardware vendor required for this mode.
vendorTier | xsd:int | Index for ordering the set of modes that apply to a given CPU vendor. Use this property to compare vendor tier values from two modes. Do not use this property to determine the presence or absence of specific features.
Properties inherited from ElementDescription
key
Properties inherited from Description
label, summary
Properties inherited from DynamicData
None

*Need not be set
Show WSDL type definition
<complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:pbm="urn:pbm" name="EVCMode"> <complexContent> <extension base="pbm:ElementDescription"> <sequence> <element name="guaranteedCPUFeatures" type="pbm:HostCpuIdInfo" minOccurs="0" maxOccurs="unbounded"/> <element name="featureCapability" type="pbm:HostFeatureCapability" minOccurs="0" maxOccurs="unbounded"/> <element name="featureMask" type="pbm:HostFeatureMask" minOccurs="0" maxOccurs="unbounded"/> <element name="featureRequirement" type="pbm:VirtualMachineFeatureRequirement" minOccurs="0" maxOccurs="unbounded"/> <element name="vendor" type="xsd:string"/> <element name="track" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/> <element name="vendorTier" type="xsd:int"/> </sequence> </extension> </complexContent> </complexType>