Virtual Machine Apply Evc Mode VM Task

Virtual Machine Apply Evc Mode VM Task

Applies the EVC mode masks to the virtual machine.

Existing masks will be replaced by the input masks. If the mask parameter is not set, then the masks on the virtual machine are removed. See featureMask for the list of masks to provide. These can be retrieved from supportedEVCMode, which is accessible in capability.

This operation is only supported if perVmEvcSupported is true.

Required privileges: VirtualMachine.Config.Settings

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/VirtualMachine/{moId}/ApplyEvcModeVM_Task

COPY

Path Parameters

string

moId

Required

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

string

release

Required

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

Request Body

ApplyEvcModeVMRequestType of type(s) application/json

Required

{
    "mask": [
        {
            "_typeName": "string",
            "key": "string",
            "featureName": "string",
            "value": "string"
        }
    ],
    "completeMasks": false
}

array of HostFeatureMask

mask

Optional

The feature masks to apply to the virtual machine. An empty set of masks will clear EVC settings.

boolean

completeMasks

Optional

Defaults to true if not set. A true value implies that any unspecified feature will not be exposed to the guest. A false value will expose any unspecified feature to the guest with the value of the host.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

OK

Returns MoRefTask of type(s) application/json

This response body class contains all of the following: MoRefExtensibleManagedObject

{
    "_typeName": "string",
    "type": "string",
    "value": "string"
}

500

InvalidPowerState: if the power state is not poweredOff.

Returns InvalidState of type(s) application/json

This response body class contains all of the following: VimFault

{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}

On This Page

Request

Path Parameters

200 Response Body

Errors

Virtual Machine Operations

Virtual Machine Acquire Mks Ticket

Virtual Machine Acquire Ticket

Virtual Machine Answer VM

Virtual Machine Apply Evc Mode VM Task

Virtual Machine Attach Disk Task

Virtual Machine Check Customization Spec

Virtual Machine Clone VM Task

Virtual Machine Consolidate VM Disks Task

Virtual Machine Create Screenshot Task

Virtual Machine Create Secondary VM Task

Virtual Machine Create Secondary VM Ex Task

Virtual Machine Create Snapshot Task

Virtual Machine Create Snapshot Ex Task

Virtual Machine Crypto Unlock Task

Virtual Machine Customize VM Task

Virtual Machine Defragment All Disks

Virtual Machine Destroy Task

Virtual Machine Detach Disk Task

Virtual Machine Disable Secondary VM Task

Virtual Machine Drop Connections

Virtual Machine Enable Secondary VM Task

Virtual Machine Estimate Storage For Consolidate Snapshots Task

Virtual Machine Export Vm

Virtual Machine Extract Ovf Environment

Virtual Machine Get Alarm Actions Enabled

Virtual Machine Get Available Field

Virtual Machine Get Capability

Virtual Machine Get Config

Virtual Machine Get Config Issue

Virtual Machine Get Config Status

Virtual Machine Get Custom Value

Virtual Machine Get Datastore

Virtual Machine Get Declared Alarm State

Virtual Machine Get Disabled Method

Virtual Machine Get Effective Role

Virtual Machine Get Environment Browser

Virtual Machine Get Guest

Virtual Machine Get Guest Heartbeat Status

Virtual Machine Get Layout

Virtual Machine Get Layout Ex

Virtual Machine Get Name

Virtual Machine Get Network

Virtual Machine Get Overall Status

Virtual Machine Get Parent

Virtual Machine Get Parent V App

Virtual Machine Get Permission

Virtual Machine Get Recent Task

Virtual Machine Get Resource Config

Virtual Machine Get Resource Pool

Virtual Machine Get Root Snapshot

Virtual Machine Get Runtime

Virtual Machine Get Snapshot

Virtual Machine Get Storage

Virtual Machine Get Summary

Virtual Machine Get Tag

Virtual Machine Get Triggered Alarm State

Virtual Machine Get Value

Virtual Machine Instant Clone Task

Virtual Machine Make Primary VM Task

Virtual Machine Mark As Template

Virtual Machine Mark As Virtual Machine

Virtual Machine Migrate VM Task

Virtual Machine Mount Tools Installer

Virtual Machine Power Off VM Task

Virtual Machine Power On VM Task

Virtual Machine Promote Disks Task

Virtual Machine Put Usb Scan Codes

Virtual Machine Query Changed Disk Areas

Virtual Machine Query Connections

Virtual Machine Query Fault Tolerance Compatibility

Virtual Machine Query Fault Tolerance Compatibility Ex

Virtual Machine Query Unowned Files

Virtual Machine Reboot Guest

Virtual Machine Reconfig VM Task

Virtual Machine Refresh Storage Info

Virtual Machine Reload

Virtual Machine Reload Virtual Machine From Path Task

Virtual Machine Relocate VM Task

Virtual Machine Remove All Snapshots Task

Virtual Machine Rename Task

Virtual Machine Reset Guest Information

Virtual Machine Reset VM Task

Virtual Machine Revert To Current Snapshot Task

Virtual Machine Send NMI

Virtual Machine Set Custom Value

Virtual Machine Set Display Topology

Virtual Machine Set Screen Resolution

Virtual Machine Shutdown Guest

Virtual Machine Standby Guest

Virtual Machine Start Recording Task

Virtual Machine Start Replaying Task

Virtual Machine Stop Recording Task

Virtual Machine Stop Replaying Task

Virtual Machine Suspend VM Task

Virtual Machine Terminate Fault Tolerant VM Task

Virtual Machine Terminate VM

Virtual Machine Turn Off Fault Tolerance For VM Task

Virtual Machine Unmount Tools Installer

Virtual Machine Unregister VM

Virtual Machine Upgrade Tools Task

Virtual Machine Upgrade VM Task