Specifies the resource limits for a CPU.
The following table contains the definition for the child elements of cpu-allocation.
Child elements - cpu-allocation
| | |
---|
| Specifies the expandable reservation in a resource poo
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 ignored for virtual machines.
Valid values: true (default), false | Conditional Mandatory for the Create_VApp operation |
| Specifies the 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 used by other running virtual machines.
The amount of CPU to be reserved should be less than the CPU limit specified for the virtual machine.
Default value: 0
Valid value: Any number | Conditional
Mandatory for the Create_VApp operation |
| Specifies the utilization of a virtual machine or a resource pool must not exceed this limit, even if there are available resources
This is typically used to ensure a consistent performance of virtual machines or resource pools independent of available resources. The unit of measurement is MHz. Default value: -1 (there is no fixed limit on resource usage and is only bounded by available resources and shares) Valid value: Any number
| Conditional Mandatory for the Create_VApp operation |
| Specifies the number of shares allocated
The value is used to determine resource allocation in the case of resource contention. There is no unit for this value. It is a relative measure based on the settings for other resource pools. This value is only set if the level is set to custom. Only shares with custom values can be compared.
Valid value: Any integer
| Conditional; required if level is set to custom |
| Specifies the allocation level
The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for shares. Valid values: - custom - Shares are specified in the shares column.
- high - Shares = 2000 * number of virtual CPUs.
- low - Shares = 500 * number of virtual CPUs.
- normal - Shares = 1000 * number of virtual CPUs.
If the shares value does not map to a predefined size, the level is set as custom.
| Conditional Mandatory for the Create_VApp operation |
The following figure shows the sample for cpu-allocation.
XML Sample for cpu-allocation
<cpu-allocation>
<expandable-reservation></expandable-reservation>
<reservation></reservation>
<limit></limit>
<shares>
<shares></shares>
<level></level>
</shares>
</cpu-allocation>