Data Object - ResourcePoolResourceUsage(vim.ResourcePool.ResourceUsage)

Property of: ResourcePoolRuntimeInfo
Extends: DynamicData
Since: 2.0

Data Object Description

Specifies the resource usage for either memory or CPU. For CPU the unit is MHz, for memory the unit is bytes.

In the typical case, where a resourcepool is in a consistent state, unreservedForVm will be equal to unreservedForPool. Hence, we can simply say talk about unreserved resources.

If the reservation on the resource pool is not expandable, then the following is true:

           reservation = reservationUsed + unreserved

If the reservation on the resource pool is expandable, then the following is true:

      reservation + parent.unreserved = reservationUsed + unreserved

Properties

Name	Type	Description
maxUsage	xsd:long	Current upper-bound on usage. The upper-bound is based on the limit configured on this resource pool, as well as limits configured on any parent resource pool.
overallUsage	xsd:long	Deprecated. as of vSphere API 6.5. Use overallCpuUsage and hostMemoryUsage. Close to real-time resource usage of all running child virtual machines, including virtual machines in child resource pools.
reservationUsed	xsd:long	Total amount of resources that have been used to satisfy the reservation requirements of all descendants of this resource pool (includes both resource pools and virtual machines).
reservationUsedForVm	xsd:long	Total amount of resources that have been used to satisfy the reservation requirements of running virtual machines in this resource pool or any of its child resource pools.
unreservedForPool	xsd:long	Total amount of resources available to satisfy a reservation for a child resource pool. In the undercommitted state, this is limited by the capacity at the root node. In the overcommitted case, this could be higher since we do not perform the dynamic capacity checks.
unreservedForVm	xsd:long	Total amount of resources available to satisfy a reservation for a child virtual machine. In general, this should be the same as unreservedForPool. However, in the overcommitted case, this is limited by the remaining available resources at the root node.
Properties inherited from DynamicData
None

Show WSDL type definition

         <complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ResourcePoolResourceUsage">
            <complexContent>
               <extension base="vim25:DynamicData">
                  <sequence>
                     <element name="reservationUsed" type="xsd:long"/>
                     <element name="reservationUsedForVm" type="xsd:long"/>
                     <element name="unreservedForPool" type="xsd:long"/>
                     <element name="unreservedForVm" type="xsd:long"/>
                     <element name="overallUsage" type="xsd:long"/>
                     <element name="maxUsage" type="xsd:long"/>
                  </sequence>
               </extension>
            </complexContent>
         </complexType>

vSphere Web Services API

Data Object - ResourcePoolResourceUsage(vim.ResourcePool.ResourceUsage)

Data Object Description