| Local Properties | ||
Managed Object Types | Data Object Types | All Properties | All Methods |
Note: DRS rules are different than an individual host's CPU affinity rules (VirtualMachineAffinityInfo).
The Server uses DRS rule objects to describe the current rule configuration (ClusterConfigInfoEx.rule). Your client application uses rule objects to configure the affinity and anti-affinity rules (ClusterConfigSpecEx.rulesSpec).
You can create the following types of rules:
Rule configuration is a dynamic process. When you create or modify a DRS rule, the Server applies the rule to the cluster. If the existing cluster configuration violates the rule, the Server attempts to correct the situation. If that is not possible, the Server generates a fault and produces a log event. DRS rules do not have precedence; all rules are applied equally. DRS does not validate one rule against another. If you create conflicting rules, the older rule takes precedence and DRS disables the newer rule.
Improperly used, DRS rules can fragment the cluster and inhibit the proper functioning of DRS, HA, and DPM services. vSphere services never take any actions that would result in the violation of mandatory DRS rules. An operation that violates a mandatory rule would produce the following consequences.
To avoid these situations, exercise caution when creating more than one mandatory rule, or consider using only optional rules. Make sure that the number of hosts with which a virtual machine is related by affinity rule is large enough that losing a host does not prevent the virtual machine from running.
For manual and partially automated DRS clusters, the Server produces migration recommendations to satisfy the DRS rules. You are not required to act on the recommendations, but the Server maintains the recommendations until the rules are satisfied.
Properties
Name | Type | Description |
---|---|---|
enabled* | xsd:boolean |
Flag to indicate whether or not the rule is enabled. Set this property
when you configure the rule. The default value is false (disabled).
If there is a rule conflict, the Server can override the setting to disable
a rule.
|
inCompliance* | xsd:boolean |
Flag to indicate whether or not the placement of Virtual Machines is currently
in compliance with this rule. The Server does not currently use this property.
Since vSphere API 4.1 |
key* | xsd:int |
Unique ID for rules. When adding a new rule, do not specify this property.
The Server will assign the key.
|
mandatory* | xsd:boolean |
Flag to indicate whether compliance with this rule is mandatory or optional.
The default value is false (optional).
|
name* | xsd:string |
Name of the rule.
|
ruleUuid* | xsd:string |
UUID for the rule. When adding a new rule, do not specify this
property. The Server will assign the key.
Since vSphere API 6.0 |
status* | ManagedEntityStatus |
Flag to indicate whether or not the rule is currently satisfied.
|
userCreated* | xsd:boolean |
Flag to indicate whether the rule is created by the user or the system.
Since vSphere API 4.1 |
Properties inherited from DynamicData | ||
None |
Top of page | Local Properties | ||
Managed Object Types | Data Object Types | All Properties | All Methods |