VM-MIB Table View

A list of virtual machine entries.  The number of
entries is given by the value of vmNumber.

vmEntry row .1.3.6.1.2.1.236.1.4.1

An entry containing management information applicable
to a particular virtual machine.

Indexes

vmIndex

Column	Syntax	OID
vmIndex A unique value, greater than zero, identifying the virtual machine. The value assigned to a given virtual machine may not persist across re-initialization of the hypervisor. A command generator MUST use the vmUUID to …	VirtualMachineIndex Type Constraints: range: 1..2147483647	.1.3.6.1.2.1.236.1.4.1.1
vmName A textual name of the virtual machine.	OctetString Constraints: range: 0-255	.1.3.6.1.2.1.236.1.4.1.2
vmUUID The virtual machine's 128-bit Universally Unique Identifier (UUID) or the zero-length string when a UUID is not available. If set, the UUID MUST uniquely identify a virtual machine from all other virtual machines in an…	UUID-TC-MIBUUIDorZero Type Constraints: range: 0 range: 16	.1.3.6.1.2.1.236.1.4.1.3
vmOSType A textual description containing operating system information installed on the virtual machine. This value corresponds to the operating system the hypervisor assumes to be running when the virtual machine is started. …	OctetString Constraints: range: 0-255	.1.3.6.1.2.1.236.1.4.1.4
vmAdminState The administrative state of the virtual machine.	VirtualMachineAdminState Type Values: 1 running 2 suspended 3 paused 4 shutdown	.1.3.6.1.2.1.236.1.4.1.5
vmOperState The operational state of the virtual machine.	VirtualMachineOperState Type Values: 1 unknown 2 other 3 preparing 4 running 5 suspending 6 suspended 7 resuming 8 paused 9 migrating 10 shuttingdown 11 shutdown 12 crashed	.1.3.6.1.2.1.236.1.4.1.6
vmAutoStart The autostart configuration of the virtual machine. If this value is enable(2), the virtual machine automatically starts at the next initialization of the hypervisor.	VirtualMachineAutoStart Type Values: 1 unknown 2 enabled 3 disabled	.1.3.6.1.2.1.236.1.4.1.7
vmPersistent This value indicates whether the virtual machine has a persistent configuration, which means the virtual machine will still exist after its shutdown.	VirtualMachinePersistent Type Values: 1 unknown 2 persistent 3 transient	.1.3.6.1.2.1.236.1.4.1.8
vmCurCpuNumber The number of virtual CPUs currently assigned to the virtual machine.	Integer32 Constraints: range: 0-2147483647	.1.3.6.1.2.1.236.1.4.1.9
vmMinCpuNumber The minimum number of virtual CPUs that are assigned to the virtual machine when it is in a power-on state. The value -1 indicates that there is no hard boundary for the minimum number of virtual CPUs.	Integer32 Constraints: range: -1-2147483647	.1.3.6.1.2.1.236.1.4.1.10
vmMaxCpuNumber The maximum number of virtual CPUs that are assigned to the virtual machine when it is in a power-on state. The value -1 indicates that there is no limit.	Integer32 Constraints: range: -1-2147483647	.1.3.6.1.2.1.236.1.4.1.11
vmMemUnit The multiplication unit in bytes for vmCurMem, vmMinMem, and vmMaxMem. For example, when this value is 1024, the memory size unit for vmCurMem, vmMinMem, and vmMaxMem is KiB.	Integer32 Constraints: range: 1-2147483647	.1.3.6.1.2.1.236.1.4.1.12
vmCurMem The current memory size currently allocated to the virtual memory module in the unit designated by vmMemUnit.	Integer32 Constraints: range: 0-2147483647	.1.3.6.1.2.1.236.1.4.1.13
vmMinMem The minimum memory size defined to the virtual machine in the unit designated by vmMemUnit. The value -1 indicates that there is no hard boundary for the minimum memory size.	Integer32 Constraints: range: -1-2147483647	.1.3.6.1.2.1.236.1.4.1.14
vmMaxMem The maximum memory size defined to the virtual machine in the unit designated by vmMemUnit. The value -1 indicates that there is no limit.	Integer32 Constraints: range: -1-2147483647	.1.3.6.1.2.1.236.1.4.1.15
vmUpTime The time (in centiseconds) since the administrative state of the virtual machine was last changed from shutdown(4) to running(1).	SNMPv2-SMITimeTicks Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.236.1.4.1.16
vmCpuTime The total CPU time used in microseconds. If the number of virtual CPUs is larger than 1, vmCpuTime may exceed real time. Discontinuities in the value of this counter can occur at re-initialization of the…	microsecondSNMPv2-SMICounter64 Type Constraints: range: 0..18446744073709551615	.1.3.6.1.2.1.236.1.4.1.17

The table of virtual CPUs provided by the hypervisor.

vmCpuEntry row .1.3.6.1.2.1.236.1.5.1

An entry for one virtual processor assigned to a
virtual machine.

Indexes

vmIndex vmCpuIndex

Column	Syntax	OID
vmCpuIndex A unique value identifying a virtual CPU assigned to the virtual machine.	VirtualMachineCpuIndex Type Constraints: range: 1..2147483647	.1.3.6.1.2.1.236.1.5.1.1
vmCpuCoreTime The total CPU time used by this virtual CPU in microseconds. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and administrative state (vmAdminS…	microsecondSNMPv2-SMICounter64 Type Constraints: range: 0..18446744073709551615	.1.3.6.1.2.1.236.1.5.1.2

A list of CPU affinity entries of a virtual CPU.

vmCpuAffinityEntry row .1.3.6.1.2.1.236.1.6.1

An entry containing CPU affinity associated with a
particular virtual machine.

Indexes

vmIndex vmCpuIndex vmCpuPhysIndex

Column	Syntax	OID
vmCpuPhysIndex A value identifying a physical CPU on the hypervisor. On systems implementing the HOST-RESOURCES-MIB, the value MUST be the same value that is used as the index in the hrProcessorTable (hrDeviceIndex).	Integer32 Constraints: range: 1-2147483647	.1.3.6.1.2.1.236.1.6.1.2
vmCpuAffinity The CPU affinity of this virtual CPU to the physical CPU represented by 'vmCpuPhysIndex'.	Enumeration Enumerated Values: 0 unknown 1 enable 2 disable	.1.3.6.1.2.1.236.1.6.1.3

The conceptual table of virtual storage devices
attached to the virtual machine.

vmStorageEntry row .1.3.6.1.2.1.236.1.7.1

An entry for one virtual storage device attached to the
virtual machine.

Indexes

vmStorageVmIndex vmStorageIndex

Column	Syntax	OID
vmStorageVmIndex This value identifies the virtual machine (guest) this storage device has been allocated to. The value zero indicates that the storage device is currently not allocated to any virtual machines.	VirtualMachineIndexOrZero Type Constraints: range: 0..2147483647	.1.3.6.1.2.1.236.1.7.1.1
vmStorageIndex A unique value identifying a virtual storage device allocated to the virtual machine.	VirtualMachineStorageIndex Type Constraints: range: 1..2147483647	.1.3.6.1.2.1.236.1.7.1.2
vmStorageParent The value of hrStorageIndex, which is the parent (i.e., physical) device of this virtual device on systems implementing the HOST-RESOURCES-MIB. The value zero denotes this virtual device is not any child represented in…	Integer32 Constraints: range: 0-2147483647	.1.3.6.1.2.1.236.1.7.1.3
vmStorageSourceType The source type of the virtual storage device.	VirtualMachineStorageSourceType Type Values: 1 unknown 2 other 3 block 4 raw 5 sparse 6 network	.1.3.6.1.2.1.236.1.7.1.4
vmStorageSourceTypeString A (detailed) textual string of the source type of the virtual storage device. For example, this represents the specific format name of the sparse file.	OctetString Constraints: range: 0-255	.1.3.6.1.2.1.236.1.7.1.5
vmStorageResourceID A textual string that represents the resource identifier of the virtual storage. For example, this contains the path to the disk image file that corresponds to the virtual storage.	OctetString Constraints: range: 0-255	.1.3.6.1.2.1.236.1.7.1.6
vmStorageAccess The access permission of the virtual storage device.	VirtualMachineStorageAccess Type Values: 1 unknown 2 readwrite 3 readonly	.1.3.6.1.2.1.236.1.7.1.7
vmStorageMediaType The media type of the virtual storage device.	IANA-STORAGE-MEDIA-TYPE-MIBIANAStorageMediaType Type Values: 1 other 2 unknown 3 hardDisk 4 opticalDisk 5 floppyDisk	.1.3.6.1.2.1.236.1.7.1.8
vmStorageMediaTypeString A (detailed) textual string of the virtual storage media. For example, this represents the specific driver name of the emulated media such as 'IDE' and 'SCSI'.	OctetString Constraints: range: 0-255	.1.3.6.1.2.1.236.1.7.1.9
vmStorageSizeUnit The multiplication unit in bytes for vmStorageDefinedSize and vmStorageAllocatedSize. For example, when this value is 1048576, the storage size unit for vmStorageDefinedSize and vmStorageAllocatedSize is MiB.	Integer32 Constraints: range: 1-2147483647	.1.3.6.1.2.1.236.1.7.1.10
vmStorageDefinedSize The defined virtual storage size defined in the unit designated by vmStorageSizeUnit. If this information is not available, this value MUST be -1.	Integer32 Constraints: range: -1-2147483647	.1.3.6.1.2.1.236.1.7.1.11
vmStorageAllocatedSize The storage size allocated to the virtual storage from a physical storage in the unit designated by vmStorageSizeUnit. When the virtual storage is block device or raw file, this value and vmStorageDefinedSize are suppo…	Integer32 Constraints: range: -1-2147483647	.1.3.6.1.2.1.236.1.7.1.12
vmStorageReadIOs The number of read I/O requests. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and administrative state (vmAdminState) changes of the virtual machine.	SNMPv2-SMICounter64 Type Constraints: range: 0..18446744073709551615	.1.3.6.1.2.1.236.1.7.1.13
vmStorageWriteIOs The number of write I/O requests. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and administrative state (vmAdminState) changes of the virtual machine.	SNMPv2-SMICounter64 Type Constraints: range: 0..18446744073709551615	.1.3.6.1.2.1.236.1.7.1.14
vmStorageReadOctets The total number of bytes read from this device. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and administrative state (vmAdminState) changes of the virtua…	SNMPv2-SMICounter64 Type Constraints: range: 0..18446744073709551615	.1.3.6.1.2.1.236.1.7.1.15
vmStorageWriteOctets The total number of bytes written to this device. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and administrative state (vmAdminState) changes of the virtu…	SNMPv2-SMICounter64 Type Constraints: range: 0..18446744073709551615	.1.3.6.1.2.1.236.1.7.1.16
vmStorageReadLatency The total number of microseconds read requests have been queued for this device. This would typically be implemented by storing the high precision system timestamp of when the request is re…	SNMPv2-SMICounter64 Type Constraints: range: 0..18446744073709551615	.1.3.6.1.2.1.236.1.7.1.17
vmStorageWriteLatency The total number of microseconds write requests have been queued for this device. This would typically be implemented by storing the high precision system timestamp of when the request is received from th…	SNMPv2-SMICounter64 Type Constraints: range: 0..18446744073709551615	.1.3.6.1.2.1.236.1.7.1.18

The conceptual table of virtual network interfaces
attached to the virtual machine.

vmNetworkEntry row .1.3.6.1.2.1.236.1.8.1

An entry for one virtual network interface attached to

the virtual machine.

Indexes

vmIndex vmNetworkIndex

Column	Syntax	OID
vmNetworkIndex A unique value identifying a virtual network interface allocated to the virtual machine.	VirtualMachineNetworkIndex Type Constraints: range: 1..2147483647	.1.3.6.1.2.1.236.1.8.1.1
vmNetworkIfIndex The value of ifIndex, which corresponds to this virtual network interface. If this device is not represented in the ifTable, then this value MUST be zero.	IF-MIBInterfaceIndexOrZero Type Constraints: range: 0..2147483647 Description: This textual convention is an extension of the InterfaceIndex convention. The latter defines a greater than zero value used to identify an interface or interface sub-layer in the managed system. This extension permits…	.1.3.6.1.2.1.236.1.8.1.2
vmNetworkParent The value of ifIndex, which corresponds to the parent (i.e., physical) device of this virtual device. The value zero denotes this virtual device is not any child represented in the ifTable.	IF-MIBInterfaceIndexOrZero Type Constraints: range: 0..2147483647 Description: This textual convention is an extension of the InterfaceIndex convention. The latter defines a greater than zero value used to identify an interface or interface sub-layer in the managed system. This extension permits…	.1.3.6.1.2.1.236.1.8.1.3
vmNetworkModel A textual string containing the (emulated) model of the virtual network interface. For example, this value is 'virtio' when the emulation driver model is virtio.	OctetString Constraints: range: 0-255	.1.3.6.1.2.1.236.1.8.1.4
vmNetworkPhysAddress The Media Access Control (MAC) address of the virtual network interface.	SNMPv2-TCPhysAddress Description: Represents media- or physical-level addresses.	.1.3.6.1.2.1.236.1.8.1.5