VirtualHardwareOption
The VirtualHardwareOption data object contains the options available for all virtual devices.
{
"_typeName": "string",
"hwVersion": 0,
"virtualDeviceOption": [
{
"_typeName": "string",
"type": "string",
"connectOption": {
"_typeName": "string",
"startConnected": {
"_typeName": "string",
"valueIsReadonly": false,
"supported": false,
"defaultValue": false
},
"allowGuestControl": {
"_typeName": "string",
"valueIsReadonly": false,
"supported": false,
"defaultValue": false
}
},
"busSlotOption": {
"_typeName": "string",
"type": "string"
},
"controllerType": "string",
"autoAssignController": {
"_typeName": "string",
"valueIsReadonly": false,
"supported": false,
"defaultValue": false
},
"backingOption": [
{
"_typeName": "string",
"type": "string"
}
],
"defaultBackingOptionIndex": 0,
"licensingLimit": [
"string"
],
"deprecated": false,
"plugAndPlay": false,
"hotRemoveSupported": false,
"numaSupported": false
}
],
"deviceListReadonly": false,
"numCPU": [
0
],
"numCoresPerSocket": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"autoCoresPerSocket": {
"_typeName": "string",
"valueIsReadonly": false,
"supported": false,
"defaultValue": false
},
"numCpuReadonly": false,
"memoryMB": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numPCIControllers": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numIDEControllers": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numUSBControllers": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numUSBXHCIControllers": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numSIOControllers": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numPS2Controllers": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"licensingLimit": [
"string"
],
"numSupportedWwnPorts": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numSupportedWwnNodes": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"resourceConfigOption": {
"_typeName": "string",
"cpuAllocationOption": {
"_typeName": "string",
"sharesOption": {
"_typeName": "string",
"sharesOption": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"defaultLevel": "string"
}
},
"memoryAllocationOption": {
"_typeName": "string",
"sharesOption": {
"_typeName": "string",
"sharesOption": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"defaultLevel": "string"
}
}
},
"numNVDIMMControllers": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numTPMDevices": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numWDTDevices": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numPrecisionClockDevices": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"epcMemoryMB": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"acpiHostBridgesFirmware": [
"string"
],
"numCpuSimultaneousThreads": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numNumaNodes": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"numDeviceGroups": {
"_typeName": "string",
"valueIsReadonly": false,
"min": 0,
"max": 0,
"defaultValue": 0
},
"deviceGroupTypes": [
"string"
]
}
The virtual hardware version.
Array of virtual device options valid for this virtual machine configuration.
The list is unordered.
Whether the set of virtual devices can be changed, e.g., can devices be added or removed.
This does not preclude changing devices.
List of acceptable values for the number of CPUs supported by this ConfigOption.
This is usually superceded by the information available in the guest operating system descriptors. The guest operating system descriptor describes a maximum CPU count, but the acceptable values are still constrained to the set specified here. The default value is stored at index 0 in the list.
The minimum, maximum and default number of cores per socket that can be used when distributing virtual CPUs.
Whether auto cores per socket is supported.
Since: vSphere API Release 8.0.0.1
Can the number of virtual CPUs be changed
The minimum, maximum, and default memory options, in MB, per virtual machine, for this VirtualHardwareOption.
These values are typically overruled by the supported and recommended values specified in the GuestOsDescriptor class.
The minimum, maximum, and default number of PCI controllers for this virtual machine configuration.
The minimum, maximum, and default number of IDE controllers for this virtual machine configuration.
Note: SCSI controllers sit on the PCI controller so their options (minimum, maximum, and default values) are contained inside the VirtualPCIControllerOption class.
The minimum, maximum, and default number of USB controllers for this virtual machine configuration.
The minimum, maximum, and default number of XHCI (USB 3.0) controllers for this virtual machine configuration.
The minimum, maximum, and default number of SIO controllers for this virtual machine configuration.
The minimum, maximum, and default number of PS2 controllers for this virtual machine configuration.
List of propery names which limits are given be a licensing restriction of the underlying product, e.g., a limit that is not derived based on the product or hardware features.
For example, the property name "numCPU"
The minimum, maximum and default number of NPIV WorldWideNode names supported for this virtual machine configuration.
The minimum, maximum and default number of NPIV WorldWidePort names supported for this virtual machine configuration.
The minimum, maximum and default number of virtual NVDIMM controllers for this virtual machine configuration.
The minimum, maximum, and default number of virtual TPMs.
The minimum, maximum, and default number of virtual watchdog timers.
The minimum, maximum and default number of PrecisionClock devices.
The minimum, maximum and default value of Intel's Secure Guard Extensions Enclave Page Cache (EPC) memory.
Empty for HWv17 & older, ["efi"] for HWv18.
Since: vSphere API Release 8.0.0.1
The minimum, maximum and default number of CPU simultaneous threads.
Since: vSphere API Release 8.0.0.1
The minimum, maximum and default number of NUMA nodes.
Since: vSphere API Release 8.0.0.1
Maximum number of device groups.
Since: vSphere API Release 8.0.0.1
Supported device group types.
Since: vSphere API Release 8.0.0.1