Cluster EVC Manager Get Evc State

EVC-related state of the managed cluster.

Request

URI

GET

https://{vcenter-host}/sdk/vim25/{release}/ClusterEVCManager/{moId}/evcState

COPY

Path Parameters

string

moId

Required

The unique identifier for the managed object to which the property attaches; the serialized managed object reference for a request has the form moType/moId, in this case ClusterEVCManager/{moId}.

string

release

Required

The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

Returns ClusterEVCManagerEVCState of type(s) application/json

This response body class contains all of the following: DataObject

{
    "_typeName": "string",
    "supportedEVCMode": [
        {
            "_typeName": "string",
            "label": "string",
            "summary": "string",
            "key": "string",
            "guaranteedCPUFeatures": [
                {
                    "_typeName": "string",
                    "level": 0,
                    "vendor": "string",
                    "eax": "string",
                    "ebx": "string",
                    "ecx": "string",
                    "edx": "string"
                }
            ],
            "featureCapability": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "featureName": "string",
                    "value": "string"
                }
            ],
            "featureMask": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "featureName": "string",
                    "value": "string"
                }
            ],
            "featureRequirement": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "featureName": "string",
                    "value": "string"
                }
            ],
            "vendor": "string",
            "track": [
                "string"
            ],
            "vendorTier": 0
        }
    ],
    "currentEVCModeKey": "string",
    "guaranteedCPUFeatures": [
        {
            "_typeName": "string",
            "level": 0,
            "vendor": "string",
            "eax": "string",
            "ebx": "string",
            "ecx": "string",
            "edx": "string"
        }
    ],
    "featureCapability": [
        {
            "_typeName": "string",
            "key": "string",
            "featureName": "string",
            "value": "string"
        }
    ],
    "featureMask": [
        {
            "_typeName": "string",
            "key": "string",
            "featureName": "string",
            "value": "string"
        }
    ],
    "featureRequirement": [
        {
            "_typeName": "string",
            "key": "string",
            "featureName": "string",
            "value": "string"
        }
    ]
}

array of EVCMode

supportedEVCMode

Required

All supported EVC modes.

Identical to Capability.supportedEVCMode.

string

currentEVCModeKey

Optional

If unset, then EVC is disabled.

If set, then EVC is enabled, and the value references an EVC mode described in one of the elements of the ClusterEVCManagerEVCState.supportedEVCMode array property. The EVC mode determines the set of guaranteed clusterwide CPU features. While EVC is enabled, CPU compatibility issues will not block any VMotion within the cluster (unless some VM is specifically configured to do different CPUID overrides).

array of HostCpuIdInfo

guaranteedCPUFeatures

Optional

Deprecated as of vSphere API 6.5 use ClusterEVCManagerEVCState.featureCapability.

When EVC is enabled, this array contains the CPU feature bits that are guaranteed (by EVC) to be the same among all hosts in the cluster.

This property has the same value as the guaranteedCPUFeatures property of the configured EVC mode. On any host in the EVC cluster, the CPU features either naturally match these values because of the CPU hardware, or else CPU feature override is used to mask out differences and enforce a match. This array is empty when EVC is disabled.

array of HostFeatureCapability

featureCapability

Optional

When EVC is enabled, this array contains the feature capabilities that are guaranteed (by EVC) to be the same among all hosts in the cluster.

This property has the same value as the featureCapability property of the configured EVC mode. On any host in the EVC cluster, the feature capabilities either naturally match these values because of the CPU hardware, or else feature masks are used to mask out differences and enforce a match. This array is empty when EVC is disabled.

array of HostFeatureMask

featureMask

Optional

The masks (modifications to a host's feature capabilities) that limit a host's capabilities to that of the EVC mode baseline.

array of VirtualMachineFeatureRequirement

featureRequirement

Optional

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.

On This Page

Description

Request

Path Parameters