vSphere Web Services API


Enum - VmPlacementPolicyVmPlacementPolicyStrictness(vim.vm.VmPlacementPolicy.VmPlacementPolicyStrictness)

Since
vSphere API Release 9.1.0.0


Enum Description

Specifies the strictness of a placement policy to be enforced while placing a VM at different stages of a VM's lifecycle.

This field may not apply to all types of placement policies derived from VmPlacementPolicy.

Enum Constants

NameDescription
PreferredDuringPlacementPreferredDuringExecution A VmPlacementPolicy with this strictness is enforced on a best-effort basis whenever a VM linked with this policy (via that VM's vmPlacementPolicies or vmPlacementPolicies) needs to be placed.

Below is a detailed explanation: If an operation requires specifying a VM's VirtualMachineConfigSpec or VirtualMachineRelocateSpec and there is a VmPlacementPolicy specified in that vmPlacementPolicies or vmPlacementPolicies with this VmPlacementPolicyStrictness, then it means the following:

(1) This VmPlacementPolicy will be considered as "preferred". This means that if a VM with this VmPlacementPolicy cannot be successfully placed on any host due to this policy, then the policy will be dropped and a placement recommendation can still be generated even if it results in violating that policy. This is denoted by the "PreferredDuringPlacement" part of this strictness value.

(2) This VmPlacementPolicy will be enforced for that operation as well as beyond that when that VM is in execution. For example, when the VM needs to be relocated for putting its host into maintenance mode, then this VmPlacementPolicy will be enforced on a best-effort basis. Similarly, when the VM needs to be restarted as part of vSphere HA failover, then this VmPlacementPolicy will be enforced on a best-effort basis. This is denoted by the "PreferredDuringExecution" part of this strictness value. Note that if a VM needs to be relocated by DRS for load-balancing, then any VmPlacementPolicy is considered as "Required" and DRS load-balancing is not included in the "PreferredDuringExecution" part of this strictness value.

RequiredDuringPlacementPreferredDuringExecution A VmPlacementPolicy with this strictness is enforced on a strict basis while placing the VM for the operation where this policy has been specified via vmPlacementPolicies or vmPlacementPolicies). After that, the same policy will be enforced on a best-effort basis.

Below is a detailed explanation: If an operation requires specifying a VM's VirtualMachineConfigSpec or VirtualMachineRelocateSpec and there is a VmPlacementPolicy specified in that vmPlacementPolicies or vmPlacementPolicies with this VmPlacementPolicyStrictness, then it means the following:

(1) This VmPlacementPolicy will be considered as "required" while computing the placement for that operation. This means that if a VM with this VmPlacementPolicy cannot be successfully placed on any host due to this policy, then the policy will still be honored and no placement recommendation will be generated for that operation. The policy must be satisfied to find a successful placement target for the VM for that operation. This is denoted by the "RequiredDuringPlacement" part of this strictness value.

(2) This VmPlacementPolicy will be enforced for that operation as well as beyond that when that VM is in execution. For example, when the VM needs to be relocated for putting its host into maintenance mode, then this VmPlacementPolicy will be enforced on a best-effort basis. Similarly, when the VM needs to be restarted as part of vSphere HA failover, then this VmPlacementPolicy will be enforced on a best-effort basis. This is denoted by the "PreferredDuringExecution" part of this strictness value. Note that if a VM needs to be relocated by DRS for load-balancing, then any VmPlacementPolicy is considered as "Required" and DRS load-balancing is not included in the "PreferredDuringExecution" part of this strictness value.


Show WSDL type definition