memory-allocation


Resource limits for memory.

The following table contains the definition for the child elements of memory-allocation.

Child elements -memory-allocation

Element

Definition

Required

<expandable-reservation>

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

<reservation>

Specifies the amount of resource, in MB, 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 machine. The memory space to be reserved should be less than the memory limit specified for the virtual machine.

Default value: 0

Valid value: Any number

Conditional

Mandatory for the Create_VApp operation

<limit>

Specifies the limit of utilization, in MB, of a virtual machine resource pool

The resource pool cannot exceed this limit, even if there are available resources. This is typically used to ensure a consistent performance of virtual machines and resource pools independent of available resources.

Default value: -1 (there is no fixed limit on resource usage; the limit is bounded by available resources and shares only)

Valid value: Any number

Conditional

Mandatory for the Create_VApp operation

<shares>

Specifies the number of shares allocated

Used to determine resource allocation in case of resource contention. Only shares with custom values can be compared. There is no unit for this value. It is a relative measure based on the settings for other resource pools. This value is set only if the level element is set to custom. If level is not set to custom, this value is ignored.

Valid value: Any integer

Conditional

Mandatory for the Create_VApp operation

<level>

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 =Shares = 20 * virtual machine memory size in megabytes
  • low - Shares = 5 * virtual machine memory size in megabytes
  • normal - Shares = 10 * virtual machine memory size in megabytes
    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 memory-allocation.

XML Sample for memory-allocation

<memory-allocation>
    <expandable-reservation></expandable-reservation>
     <reservation></reservation>
     <limit></limit>
     <shares>
     <shares></shares>
     <level></level>
     </shares>
</memory-allocation>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*