ResourceAllocationInfo

ResourceAllocationInfo
ResourceAllocationInfo

The ResourceAllocationInfo data object specifies the reserved resource requirement as well as the limit (maximum allowed usage) for a given kind of resource.

This is specified for both memory allocation (specified in MB) and CPU allocation (specified in MHz).

For a ResourcePool, the ResourceAllocationInfo object describes both the guaranteed amount of the resource (reservation) and whether or not it is expandable (expandableReservation). If expandableReservation is true, then the resource pool can grow its reservation dynamically by borrowing unreserved resources from its parent resource pool. For the methods CreateResourcePool, CreateVApp and ImportVApp, you must provide values for all properties except overheadLimit; they are not optional. (Currently, overheadLimit is for vCenter Server use only.)

If the limit is configured, it must be greater than or equal to the reservation.

AllOf
This class requires all of the following:
JSON Example
{
    "_typeName": "string",
    "reservation": 0,
    "expandableReservation": false,
    "limit": 0,
    "shares": {
        "_typeName": "string",
        "shares": 0,
        "level": "string"
    },
    "overheadLimit": 0
}
integer As int64 As int64
reservation
Optional

Amount of resource that is guaranteed available to the virtual machine or resource pool.

Reserved resources are not wasted if they are not used. If the utilization is less than the reservation, the resources can be utilized by other running virtual machines. Units are MB for memory, MHz for CPU.

boolean
expandableReservation
Optional

In a resource pool with an expandable reservation, the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has unreserved resources.

A non-expandable reservation is called a fixed reservation. This property is invalid for virtual machines.

integer As int64 As int64
limit
Optional

The utilization of a virtual machine/resource pool will not exceed this limit, even if there are available resources.

This is typically used to ensure a consistent performance of virtual machines / resource pools independent of available resources. If set to -1, then there is no fixed limit on resource usage (only bounded by available resources and shares). Units are MB for memory, MHz for CPU.

shares
Optional

Specification of shares.

Shares are used to determine relative allocation between resource consumers. In general, a consumer with more shares gets proportionally more of the resource, subject to certain other constraints.

integer As int64 As int64
overheadLimit
Optional

The maximum allowed overhead memory.

For a powered on virtual machine, the overhead memory reservation cannot be larger than its overheadLimit. This property is only applicable to powered on virtual machines and is not persisted across reboots. This property is not applicable for resource pools. If set to -1, then there is no limit on reservation. Units are MB.

Note: For vCenter Server use only. Not available for other clients at this time. The server will throw an exception if you attempt to set this property.