Skip to search

VirtualMachinePreference

instancetype.kubevirt.io / v1beta1

apiVersion: instancetype.kubevirt.io/v1beta1 kind: VirtualMachinePreference metadata: name: example
View raw schema
apiVersion string
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind string
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata object
spec object required
Required spec describing the preferences
annotations object
Optionally defines preferred Annotations to be applied to the VirtualMachineInstance
clock object
Clock optionally defines preferences associated with the Clock attribute of a VirtualMachineInstance DomainSpec
preferredClockOffset object
ClockOffset allows specifying the UTC offset or the timezone of the guest clock.
timezone string
Timezone sets the guest clock to the specified timezone. Zone name follows the TZ environment variable format (e.g. 'America/New_York').
utc object
UTC sets the guest clock to UTC on each boot. If an offset is specified, guest changes to the clock will be kept during reboots and are not reset.
offsetSeconds integer
OffsetSeconds specifies an offset in seconds, relative to UTC. If set, guest changes to the clock will be kept during reboots and not reset.
preferredTimer object
Timer specifies whih timers are attached to the vmi.
hpet object
HPET (High Precision Event Timer) - multiple timers with periodic interrupts.
present boolean
Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.
tickPolicy string
TickPolicy determines what happens when QEMU misses a deadline for injecting a tick to the guest. One of "delay", "catchup", "merge", "discard".
hyperv object
Hyperv (Hypervclock) - lets guests read the host’s wall clock time (paravirtualized). For windows guests.
present boolean
Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.
kvm object
KVM (KVM clock) - lets guests read the host’s wall clock time (paravirtualized). For linux guests.
present boolean
Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.
pit object
PIT (Programmable Interval Timer) - a timer with periodic interrupts.
present boolean
Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.
tickPolicy string
TickPolicy determines what happens when QEMU misses a deadline for injecting a tick to the guest. One of "delay", "catchup", "discard".
rtc object
RTC (Real Time Clock) - a continuously running timer with periodic interrupts.
present boolean
Enabled set to false makes sure that the machine type or a preset can't add the timer. Defaults to true.
tickPolicy string
TickPolicy determines what happens when QEMU misses a deadline for injecting a tick to the guest. One of "delay", "catchup".
track string
Track the guest or the wall clock.
cpu object
CPU optionally defines preferences associated with the CPU attribute of a VirtualMachineInstance DomainSpec
preferredCPUFeatures []object
PreferredCPUFeatures optionally defines a slice of preferred CPU features.
name string required
Name of the CPU feature
policy string
Policy is the CPU feature attribute which can have the following attributes: force - The virtual CPU will claim the feature is supported regardless of it being supported by host CPU. require - Guest creation will fail unless the feature is supported by the host CPU or the hypervisor is able to emulate it. optional - The feature will be supported by virtual CPU if and only if it is supported by host CPU. disable - The feature will not be supported by virtual CPU. forbid - Guest creation will fail if the feature is supported by host CPU. Defaults to require
preferredCPUTopology string
PreferredCPUTopology optionally defines the preferred guest visible CPU topology, defaults to PreferSockets.
spreadOptions object
across string
Across optionally defines how to spread vCPUs across the guest visible topology. Default: SocketsCores
ratio integer
Ratio optionally defines the ratio to spread vCPUs across the guest visible topology: CoresThreads - 1:2 - Controls the ratio of cores to threads. Only a ratio of 2 is currently accepted. SocketsCores - 1:N - Controls the ratio of socket to cores. SocketsCoresThreads - 1:N:2 - Controls the ratio of socket to cores. Each core providing 2 threads. Default: 2
format: int32
devices object
Devices optionally defines preferences associated with the Devices attribute of a VirtualMachineInstance DomainSpec
preferredAutoattachGraphicsDevice boolean
PreferredAutoattachGraphicsDevice optionally defines the preferred value of AutoattachGraphicsDevice
preferredAutoattachInputDevice boolean
PreferredAutoattachInputDevice optionally defines the preferred value of AutoattachInputDevice
preferredAutoattachMemBalloon boolean
PreferredAutoattachMemBalloon optionally defines the preferred value of AutoattachMemBalloon
preferredAutoattachPodInterface boolean
PreferredAutoattachPodInterface optionally defines the preferred value of AutoattachPodInterface
preferredAutoattachSerialConsole boolean
PreferredAutoattachSerialConsole optionally defines the preferred value of AutoattachSerialConsole
preferredBlockMultiQueue boolean
PreferredBlockMultiQueue optionally enables the vhost multiqueue feature for virtio disks.
preferredCdromBus string
PreferredCdromBus optionally defines the preferred bus for Cdrom Disk devices.
preferredDisableHotplug boolean
PreferredDisableHotplug optionally defines the preferred value of DisableHotplug
preferredDiskBlockSize object
PreferredBlockSize optionally defines the block size of Disk devices.
custom object
CustomBlockSize represents the desired logical and physical block size for a VM disk.
discardGranularity integer
logical integer
physical integer
matchVolume object
Represents if a feature is enabled or disabled.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
preferredDiskBus string
PreferredDiskBus optionally defines the preferred bus for Disk Disk devices.
preferredDiskCache string
PreferredCache optionally defines the DriverCache to be used by Disk devices.
preferredDiskDedicatedIoThread boolean
PreferredDedicatedIoThread optionally enables dedicated IO threads for Disk devices using the virtio bus.
preferredDiskIO string
PreferredIo optionally defines the QEMU disk IO mode to be used by Disk devices.
preferredInputBus string
PreferredInputBus optionally defines the preferred bus for Input devices.
preferredInputType string
PreferredInputType optionally defines the preferred type for Input devices.
preferredInterfaceMasquerade object
PreferredInterfaceMasquerade optionally defines the preferred masquerade configuration to use with each network interface.
preferredInterfaceModel string
PreferredInterfaceModel optionally defines the preferred model to be used by Interface devices.
preferredLunBus string
PreferredLunBus optionally defines the preferred bus for Lun Disk devices.
preferredNetworkInterfaceMultiQueue boolean
PreferredNetworkInterfaceMultiQueue optionally enables the vhost multiqueue feature for virtio interfaces.
preferredPanicDeviceModel string
PreferredPanicDeviceModel optionally defines the preferred panic device model to use with panic devices.
preferredRng object
PreferredRng optionally defines the preferred rng device to be used.
preferredSoundModel string
PreferredSoundModel optionally defines the preferred model for Sound devices.
preferredTPM object
PreferredTPM optionally defines the preferred TPM device to be used.
enabled boolean
Enabled allows a user to explicitly disable the vTPM even when one is enabled by a preference referenced by the VirtualMachine Defaults to True
persistent boolean
Persistent indicates the state of the TPM device should be kept accross reboots Defaults to false
preferredUseVirtioTransitional boolean
PreferredUseVirtioTransitional optionally defines the preferred value of UseVirtioTransitional
preferredVirtualGPUOptions object
PreferredVirtualGPUOptions optionally defines the preferred value of VirtualGPUOptions
display object
enabled boolean
Enabled determines if a display addapter backed by a vGPU should be enabled or disabled on the guest. Defaults to true.
ramFB object
Enables a boot framebuffer, until the guest OS loads a real GPU driver Defaults to true.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
features object
Features optionally defines preferences associated with the Features attribute of a VirtualMachineInstance DomainSpec
preferredAcpi object
PreferredAcpi optionally enables the ACPI feature
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
preferredApic object
PreferredApic optionally enables and configures the APIC feature
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
endOfInterrupt boolean
EndOfInterrupt enables the end of interrupt notification in the guest. Defaults to false.
preferredHyperv object
PreferredHyperv optionally enables and configures HyperV features
evmcs object
EVMCS Speeds up L2 vmexits, but disables other virtualization features. Requires vapic. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
frequencies object
Frequencies improves the TSC clock source handling for Hyper-V on KVM. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
ipi object
IPI improves performances in overcommited environments. Requires vpindex. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
reenlightenment object
Reenlightenment enables the notifications on TSC frequency changes. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
relaxed object
Relaxed instructs the guest OS to disable watchdog timeouts. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
reset object
Reset enables Hyperv reboot/reset for the vmi. Requires synic. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
runtime object
Runtime improves the time accounting to improve scheduling in the guest. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
spinlocks object
Spinlocks allows to configure the spinlock retry attempts.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
spinlocks integer
Retries indicates the number of retries. Must be a value greater or equal 4096. Defaults to 4096.
format: int32
synic object
SyNIC enables the Synthetic Interrupt Controller. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
synictimer object
SyNICTimer enables Synthetic Interrupt Controller Timers, reducing CPU load. Defaults to the machine type setting.
direct object
Represents if a feature is enabled or disabled.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
tlbflush object
TLBFlush improves performances in overcommited environments. Requires vpindex. Defaults to the machine type setting.
direct object
Direct allows sending the TLB flush command directly to the hypervisor. It can be useful to optimize performance in nested virtualization cases, such as Windows VBS.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
extended object
Extended allows the guest to execute partial TLB flushes. It can be helpful for general purpose workloads.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
vapic object
VAPIC improves the paravirtualized handling of interrupts. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
vendorid object
VendorID allows setting the hypervisor vendor id. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
vendorid string
VendorID sets the hypervisor vendor id, visible to the vmi. String up to twelve characters.
vpindex object
VPIndex enables the Virtual Processor Index to help windows identifying virtual processors. Defaults to the machine type setting.
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
preferredKvm object
PreferredKvm optionally enables and configures KVM features
hidden boolean
Hide the KVM hypervisor from standard MSR based discovery. Defaults to false
preferredPvspinlock object
PreferredPvspinlock optionally enables the Pvspinlock feature
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
preferredSmm object
PreferredSmm optionally enables the SMM feature
enabled boolean
Enabled determines if the feature should be enabled or disabled on the guest. Defaults to true.
firmware object
Firmware optionally defines preferences associated with the Firmware attribute of a VirtualMachineInstance DomainSpec
preferredEfi object
PreferredEfi optionally enables EFI
persistent boolean
If set to true, Persistent will persist the EFI NVRAM across reboots. Defaults to false
secureBoot boolean
If set, SecureBoot will be enabled and the OVMF roms will be swapped for SecureBoot-enabled ones. Requires SMM to be enabled. Defaults to true
preferredUseBios boolean
PreferredUseBios optionally enables BIOS
preferredUseBiosSerial boolean
PreferredUseBiosSerial optionally transmitts BIOS output over the serial. Requires PreferredUseBios to be enabled.
preferredUseEfi boolean
PreferredUseEfi optionally enables EFI Deprecated: Will be removed with v1beta2 or v1
preferredUseSecureBoot boolean
PreferredUseSecureBoot optionally enables SecureBoot and the OVMF roms will be swapped for SecureBoot-enabled ones. Requires PreferredUseEfi and PreferredSmm to be enabled. Deprecated: Will be removed with v1beta2 or v1
machine object
Machine optionally defines preferences associated with the Machine attribute of a VirtualMachineInstance DomainSpec
preferredMachineType string
PreferredMachineType optionally defines the preferred machine type to use.
preferSpreadSocketToCoreRatio integer
PreferSpreadSocketToCoreRatio defines the ratio to spread vCPUs between cores and sockets, it defaults to 2.
format: int32
preferredArchitecture string
PreferredArchitecture defines a prefeerred architecture for the VirtualMachine
preferredSubdomain string
Subdomain of the VirtualMachineInstance
preferredTerminationGracePeriodSeconds integer
Grace period observed after signalling a VirtualMachineInstance to stop after which the VirtualMachineInstance is force terminated.
format: int64
requirements object
Requirements defines the minium amount of instance type defined resources required by a set of preferences
architecture string
Required Architecture of the VM referencing this preference
cpu object
Required CPU related attributes of the instancetype.
guest integer required
Minimal number of vCPUs required by the preference.
format: int32
memory object
Required Memory related attributes of the instancetype.
guest string | integer required
Minimal amount of memory required by the preference.
string pattern: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$
volumes object
Volumes optionally defines preferences associated with the Volumes attribute of a VirtualMachineInstace DomainSpec
preferredStorageClassName string
PreffereedStorageClassName optionally defines the preferred storageClass

No matches. Try .spec.clock for an exact path