1. Types
  2. esx
  3. health
  4. hosts

esx health hosts: check spec

Defines the context for a host-level health query. This structure was added in vSphere API 7.0.1.0.

Representation:

{
    "exclude_checks" : [
        "obj-103",
        "obj-103"
    ],
    "target_spec" : {
        "state_changes" : {
            "obj-103" : "INSTALL"
        }
    },
    "perspective" : "BEFORE_ENTER_MAINTENANCE",
    "maintenance_mode_type" : "string"
}
{
    "exclude_checks" : [
        "obj-103",
        "obj-103"
    ],
    "target_spec" : {
        "state_changes" : [
            {
                "value" : "INSTALL",
                "key" : "obj-103"
            }
        ]
    },
    "perspective" : "BEFORE_ENTER_MAINTENANCE",
    "maintenance_mode_type" : "string"
}

Attributes:

Name Type Description
Required
-.perspective string The host-level perspective for the health query. This attribute was added in vSphere API 7.0.1.0.

The available host-level health perspectives. A perspective represents specific state transitions in the host's lifecycle. Health checks that are part of a given perspective should evaluate whether the host can proceed to the next state in its lifecycle without this resulting in service health degradation. Typically, a host goes through the following steps during its lifecycle: - The host is hosting workloads, for example there are powered-on VMs and the host is an active vSAN node. - The host is entered into maintenance mode. - The host is remediated. - The host exits maintenance mode. - The host starts hosting workloads again. This enumeration was added in vSphere API 7.0.1.0. Value is one of:
BEFORE_ENTER_MAINTENANCE: A health perspective related to the host being ready to be put into maintenance mode. Checking the health status for this perspective when the host is already in maintenance mode always returns @{link Status#OK}. This constant was added in vSphere API 7.0.1.0.
BEFORE_MODIFICATION: Health perspective for before modification of the desired state on the host is started. Health checks for this perspective should be about whether the host can safely transition from its current state to its target state. This constant was added in vSphere API 7.0.1.0.
AFTER_MODIFICATION: Health perspective for after modification of the desired state on the host has completed. Health checks for this perspective should check the host health after the state changes to make sure that the new state does not degrade service health. This constant was added in vSphere API 7.0.1.0.
BEFORE_EXIT_MAINTENANCE: A health perspective for the host being ready to exit maintenance mode. Checking the health status for this perspective when the host is not in maintenance mode always returns @{link Status#OK}. This constant was added in vSphere API 7.0.1.0.
FINALIZE: A health perspective for final checks before it is considered that the host has reached its desired state successfully. This constant was added in vSphere API 7.0.1.0.
-.target_spec.state_changes object The software state change for each solution. Captures the overall changes to the software of a HOST. If a SOLUTION is not present in the mapping, its software will not be changed in the current remediation. This attribute was added in vSphere API 7.0.1.0.

When clients pass a value of this structure as a parameter, the key in the field key/value pairs must be an identifier for the resource type: com.vmware.esx.health.solution. When operations return a value of this structure as a result, the key in the field key/value pairs will be an identifier for the resource type: com.vmware.esx.health.solution.Object with element values of type string.
-.target_spec.state_changes.* string The action that will be taken on a solution's software as part of the on-going remediation. This enumeration was added in vSphere API 7.0.1.0. Value is one of:
INSTALL: The software of the Solution is being installed. This constant was added in vSphere API 7.0.1.0.
UPGRADE: The software of the Solution is being upgraded. This constant was added in vSphere API 7.0.1.0.
DELETE: The Solution is being deleted. This constant was added in vSphere API 7.0.1.0.
-.exclude_checks string[] The set of IDs of the health checks that should not be considered in the overall health status. This attribute was added in vSphere API 7.0.1.0.

When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: com.vmware.esx.health.check. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: com.vmware.esx.health.check.
Optional
-.target_spec target_spec The target desired specification. This attribute was added in vSphere API 7.0.1.0.

Optional. If unset no desired specification changes will occur.
-.maintenance_mode_type string The maintenance mode type that the host is about to enter or exit. The supported values are defined in the vmodl1 definition of vim.host.ServiceModeId. This parameter is valid only for the BEFORE_ENTER_MAINTENANCE and BEFORE_EXIT_MAINTENANCE perspectives. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Optional. It is only relevant when perspective has value [BEFORE_ENTER_MAINTENANCE, BEFORE_EXIT_MAINTENANCE]. if unset, full maintenance mode is assumed.