ClusterFailoverResourcesAdmissionControlPolicy

ClusterFailoverResourcesAdmissionControlPolicy
ClusterFailoverResourcesAdmissionControlPolicy

The ClusterFailoverResourcesAdmissionControlPolicy reserves a specified percentage of aggregate cluster resources for failover.

With the resources failover policy in place, vSphere HA uses the following calculations to control virtual machine migration in the cluster.

  1. Calculate the total resource requirements for all powered-on virtual machines in the cluster.
  2. Calculate the total host resources available for virtual machines.
  3. Calculate the Current CPU failover capacity, memory failover capacity and optionally, persistent memory failover capacity for the cluster.
  4. Compare the current CPU failover capacity and current memory failover capacity with the configured resource percentages (cpuFailoverResourcesPercent and memoryFailoverResourcesPercent). If either current capacity is less than the corresponding configured capacity, HA does not allow the operation.

HA uses the actual reservations of the virtual machines. If a virtual machine does not have reservations, meaning that the reservation is 0, a default of 0MB memory and 256MHz CPU is applied. This is controlled by the same HA advanced options used for the failover level policy (ClusterFailoverLevelAdmissionControlPolicy).

AllOf
This class requires all of the following:
JSON Example
{
    "_typeName": "string",
    "resourceReductionToToleratePercent": 0,
    "pMemAdmissionControlEnabled": false,
    "cpuFailoverResourcesPercent": 0,
    "memoryFailoverResourcesPercent": 0,
    "failoverLevel": 0,
    "autoComputePercentages": false,
    "pMemFailoverResourcesPercent": 0,
    "autoComputePMemFailoverResourcesPercent": false
}
integer As int32 As int32
cpuFailoverResourcesPercent
Required

Percentage of CPU resources in the cluster to reserve for failover.

You can specify up to 100% of CPU resources for failover.

integer As int32 As int32
memoryFailoverResourcesPercent
Required

Percentage of memory resources in the cluster to reserve for failover.

You can specify up to 100% of memory resources for failover.

integer As int32 As int32
failoverLevel
Optional

Number of host failures that should be tolerated, still guaranteeing sufficient resources to restart virtual machines on available hosts.

If not set, we assume 1.

boolean
autoComputePercentages
Optional

Flag to enable user input values for cpuFailoverResourcesPercent and memoryFailoverResourcesPercent By default, this is true and the default calculation is using the failoverLevel hosts' resources.

If users want to override the percentage values, they must disable the auto-compute by setting this field to false.

integer As int32 As int32
pMemFailoverResourcesPercent
Optional

Percentage of persistent memory resources in the cluster to reserve for the failover.

You can specify up to 100% of persistent memory resources for failover.

Since: vSphere API Release 7.0.2.0

boolean
autoComputePMemFailoverResourcesPercent
Optional

Flag to enable user input values for pMemFailoverResourcesPercent By default, this is true and the default calculation is done using the failoverLevel hosts' resources.

If a user wants to override the percentage values, they must disable the auto-compute by setting this field to false.

Since: vSphere API Release 7.0.2.0