HypervisorSummaryDto
A hypervisor host with its inventory, enrollment and agent state. The vCenter managed-object reference of the host (hostMoRef) is not returned; identify a host by id, hostname or hardwareUuid. parentLocator, the cluster locator, is still returned and is the value of the cluster filter.
{
"id": "string",
"vcenterId": "string",
"hostname": "string",
"parentLocator": "string",
"connectionState": "string",
"inMaintenanceMode": false,
"esxiVersion": "string",
"esxiBuild": "string",
"inventoryState": "string",
"stale": false,
"observedAt": "string",
"firstObservedAt": "string",
"agentCorrelationState": "string",
"vcenterConnectionId": "string",
"vcenterInstanceUuid": "string",
"hardwareUuid": "string",
"vcenterDisplayName": "string",
"agentId": "string",
"enrollmentStatus": "string",
"enrolledAt": "string",
"enrollmentError": "string",
"agentVibStatus": "string",
"agentVibIdentifier": "string",
"agentVibVersion": "string",
"agentVibDisplayName": "string",
"enrollmentStage": "string",
"agentCommStatus": "string",
"lastHeartbeatAt": "string",
"clusterName": "string",
"managementType": "string",
"autoEnrollSuppressedAt": "string",
"authUsername": "string",
"hardwareIdentityConflict": false,
"agentVibConfirmedAt": "string",
"agentVibLastAttemptAt": "string",
"agentVibLastAttemptResult": "string",
"recoveryRequired": false,
"recoveryReason": "string"
}
Hypervisor key
Identifier of the vCenter connection that owns the host, the same value as vcenterConnectionId (kept as an alias for older clients); null once the host is registered as a standalone host
Hostname of the host as reported by vCenter, or the hostname or IP address given when a standalone host was registered
Locator of the host's parent inventory object as reported by vCenter, for example a cluster identifier such as domain-c76; null when none was reported
Connection state of the host as reported by vCenter at the last observation; UNKNOWN until one is reported
Whether vCenter reported the host to be in maintenance mode at the last observation
ESXi version of the host as last reported by vCenter or by the standalone host probe; null when none was reported
ESXi build of the host as last reported by vCenter or by the standalone host probe; null when none was reported
Whether the latest inventory still reports the host: ACTIVE while it is reported, STALE after vCenter reported it leaving or its vCenter connection is no longer an active source; the row is kept in both cases
Whether the host was last observed longer ago than the freshness threshold (setting vtp.discovery.freshness-threshold-minutes, 15 minutes by default); evaluated when the list is read and independent of inventoryState
Time of the last discovery observation of the host
Time the host was first observed, set once when its row was created
Whether the host is correlated with an agent.
NOT_CORRELATED: The host has no Agent identity, or its enrollment status is neither ENROLLED, ENROLLING nor FAILEDCORRELATED: The host has an Agent identity and its enrollment status is ENROLLEDPENDING: The host has an Agent identity and its enrollment status is ENROLLINGFAILED: The host has an Agent identity and its enrollment status is FAILED
Identifier of the vCenter connection that owns the host, the same value as vcenterId; null once the host is registered as a standalone host
Instance UUID of the vCenter server that reported the host; null for a standalone host or when vCenter did not report one
Hardware UUID of the host (vCenter summary.hardware.uuid), the candidate durable identity of the host; null when none was reported
Display name of the vCenter connection that owns the host; falls back to the vCenter identifier when the connection has no display name, and to Standalone ESXi for a standalone host without either
Identifier of the Agent bound to the host, as a decimal string (a 64-bit value, sent as a string because browsers cannot hold it exactly as a number); null while no Agent identity is bound
Agent enrollment status of a hypervisor host.
NOT_ENROLLED: No enrollment: the initial value of every host and the value after an enrollment reset or unenrollENROLLING: An Agent identity was allocated and the enrollment commands were sent; the host awaits the Agent's first heartbeatENROLLED: The Agent's first heartbeat after enrollment promoted the host from ENROLLINGFAILED: An enrollment step failed, the enrollment deadline passed while ENROLLING, or an unenroll could not be completed remotely (stage RECOVERY_REQUIRED)UNENROLLED: No behaviour is documented for this value. No producing site in the current server code
Time the host became ENROLLED; null unless enrollmentStatus is ENROLLED
Error text of the last enrollment failure, including the timeout error reported when an ENROLLING host passed its enrollment deadline; null when there is none
State of the agent VIB on a hypervisor host.
INSTALLED: The vCenter software inventory lists the VTP Agent VIB component on the hostNOT_INSTALLED: The software inventory succeeded and the VIB is absent; the Agent of such a host is reported OFFLINEUNKNOWN: The software inventory is unavailable, for example it was not queried or the host does not support it (the initial value); previously stored VIB facts are keptQUERY_FAILED: The vCenter query returned an error, timed out or could not connect; previously stored VIB facts are kept
Identifier of the Agent VIB package taken from the vCenter software inventory; null when the inventory has not reported one
Version of the Agent VIB package taken from the vCenter software inventory; null when the inventory has not reported one
Display name of the Agent VIB package taken from the vCenter software inventory; null when the inventory has not reported one
Stage of the agent enrollment of a hypervisor host.
NONE: No enrollment step has run; the initial value and the value after an enrollment resetAUTHORIZING: The Console is authenticating to the ESXi host to obtain a bearer tokenCSR_REQUESTED: The Console asked the host's Agent to start enrollment and awaits its certificate signing request (CSR)CSR_RECEIVED: The Agent returned a certificate signing requestCERT_SIGNED: The Console signed the Agent's certificate signing requestCERT_DELIVERED: The signed certificate was delivered to the AgentAWAITING_HEARTBEAT: The certificate delivery was recorded and the host awaits the Agent's first heartbeatENROLLED: The Agent's first heartbeat promoted the host; set together with status ENROLLEDRECOVERY_REQUIRED: An unenroll could not be completed remotely and was not forced; the host keeps status FAILED and its Agent binding until the enrollment is reset with force=trueFAILED: An enrollment step failed or the enrollment deadline passed while ENROLLING
Whether the Agent on this host is ONLINE or OFFLINE; OFFLINE is also reported when the Agent VIB is NOT_INSTALLED or when an ONLINE host has not sent a heartbeat within the freshness threshold (setting vtp.agent.heartbeat-freshness-threshold-seconds, 900 seconds by default: three missed heartbeats at the 300-second interval). The liveness sweep marks an Agent OFFLINE after three missed heartbeats of its group's interval and records AGENT_HEARTBEAT_MISSED and AGENT_OFFLINE in the audit log; null when the host has no Agent state
Time of the last heartbeat received from the Agent; null when the host has no Agent state or no heartbeat was recorded
Cluster name resolved from parentLocator by the cluster name resolver; null when no resolver is configured, the host has no parentLocator or no name is found
How the host is managed.
VCENTER_MANAGED: The host is discovered through a vCenter connection (the default)STANDALONE: The host was registered directly with the Console as a standalone ESXi host; vCenter discovery does not write to it
Time Auto-Enroll was suppressed for this host (an operator Unenroll, or an unconfirmed Force Remove); null when it is not suppressed. While set, the Console does not enroll the host automatically; an operator Enroll clears it. Marks written by earlier releases cannot be told apart from an operator's decision.
User name of the account stored for direct (standalone) management of this host, shown so an operator can see which account the Console uses for the VIB check and the host connection; null for vCenter-managed hosts and for hosts with no stored account. Never a password.
True while discovery has seen a hardware identity different from the one this record's Agent or enrollment is bound to, in any enrollment state. Enrollment of the host cannot change until identity verification clears it (a verified unenrollment clears it). The observed identity itself is never returned.
Time a verification last confirmed agentVibStatus (INSTALLED or NOT_INSTALLED). A failed or inconclusive attempt never changes it, so a status with an old confirmation time is retained evidence, not a fresh check; null when the status was never confirmed (including rows that predate this field)
Time of the most recent verification attempt, successful or not; null when none has run
OK when the latest attempt confirmed the VIB state, otherwise a diagnostic reason code for why it confirmed nothing (never raw host or vCenter text); null when no attempt has run
True when the host record itself shows that Reset and Recover is needed: the recovery stage, or a forced reset that left the Agent's state unconfirmed. Independent of enrollmentStage. Ownership recorded only in the lifecycle history is not computed per list row; enrollment still refuses it with RECOVERY_REQUIRED
Why recoveryRequired is true: RECOVERY_STAGE (a remote unenroll failed and the host is waiting for Recover) FORCED_RESET_UNCONFIRMED (a forced reset retired the Console's trust without remote confirmation, so an Agent may still hold the host), OWNERSHIP_UNCONFIRMED (lifecycle history ends in an unconfirmed release) or HISTORY_UNAVAILABLE (the history could not be read: unknown, not clear; Enroll must not be offered); null when recoveryRequired is false