# 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:sms="urn:sms" name="ResourcePoolResourceUsage"> <complexContent> <extension base="sms: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>