Managed Object - HostVsanHealthSystem(vim.host.VsanHealthSystem)

See also
OptionValue, Task, VsanEncryptionHealthSummary, VsanHclFirmwareUpdateSpec, VsanHostCreateVmHealthTestResult, VsanHostEMMSummary, VsanHostHclInfo, VsanLimitHealthResult, VsanNetworkHealthResult, VsanNetworkLoadTestResult, VsanObjectOverallHealth, VsanPhysicalDiskHealthSummary, VsanProactiveRebalanceInfoEx, VsanQueryResultHostInfo, VsanRepairObjectsResult, VsanSmartStatsHostSummary, VsanVmdkLoadTestResult, VsanVmdkLoadTestSpec
Since
vSphere API 5.5


Managed Object Description

This managed object consolidates vSAN Health APIs that operate on a single ESXi host, i.e., the APIs in this Managed Object do not correlate health among multiple nodes in a vSAN cluster. Typically this level is not very useful for direct user consumption, and the cluster level APIs should be used instead. The cluster level APIs build upon the APIs in this Managed Object. All information retrieved is as seen by this host, which under network partitions is not the global view.
The ManagedEntity can be accessed with MOID of 'ha-vsan-health-system', through vSAN service at at ESXi host side.

Properties

Name Type Description
None

Methods

Methods defined in this Managed Object
VsanFlashScsiControllerFirmware_Task, VsanGetHclInfo, VsanGetProactiveRebalanceInfo, VsanHostCleanupVmdkLoadTest, VsanHostClomdLiveness, VsanHostCreateVmHealthTest, VsanHostPrepareVmdkLoadTest, VsanHostQueryAdvCfg, VsanHostQueryCheckLimits, VsanHostQueryEncryptionHealthSummary, VsanHostQueryHealthSystemVersion, VsanHostQueryHostInfoByUuids, VsanHostQueryObjectHealthSummary, VsanHostQueryPhysicalDiskHealthSummary, VsanHostQueryRunIperfClient, VsanHostQueryRunIperfServer, VsanHostQuerySmartStats, VsanHostQueryVerifyNetworkSettings, VsanHostRepairImmediateObjects, VsanHostRunVmdkLoadTest, VsanQueryHostEMMState, VsanStartProactiveRebalance, VsanStopProactiveRebalance, VsanWaitForVsanHealthGenerationIdChange

VsanFlashScsiControllerFirmware_Task(flashScsiControllerFirmware)

Perform a SCSI controller firmware upgrade. Pre-requisites:
Required Privileges
Host.Config.Storage
Since
vSAN API 6.6

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
specVsanHclFirmwareUpdateSpec

Firmware update specification.

Return Value

Type Description
ManagedObjectReference
to a Task
A task

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault

Events

Type
None

Show WSDL type definition



VsanGetHclInfo(getHclInfo)

Fetch HCL information about all devices in use by vSAN. Currently covers SCSI controllers.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
includeVendorInfo*xsd:boolean

Include vendor tool controller raw info in the result

Since vSAN API 6.6
*Need not be set

Return Value

Type Description
VsanHostHclInfo

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanGetProactiveRebalanceInfo(getProactiveRebalanceInfo)

Retrieve information of proactive rebalance on this host
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.

Return Value

Type Description
VsanProactiveRebalanceInfoExThe current proactive rebalance information

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault

Events

Type
None

Show WSDL type definition



VsanHostCleanupVmdkLoadTest(cleanupVmdkLoadTest)

Deprecated. As of vSphere API 6.7.

Cleanup the VMDK load test. It will delete the created test VMDKs during this test.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
runnamexsd:string

The name for this VMDK load test
specs*VsanVmdkLoadTestSpec[]

The VMDK load test spec list each of which includes the VMDK creation spec and IO load test spec.

Since vSphere API 5.5
*Need not be set

Return Value

Type Description
xsd:string

Faults

Type Description
NotFound
NotSupported
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostClomdLiveness(checkClomdLiveness)

Check CLOMD liveness on vSAN host. It returns True only if CLOMD is alive, otherwise it throws VsanFault. It never returns False.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.

Return Value

Type Description
xsd:boolean

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFaultwhen CLOMD is not alive.

Events

Type
None

Show WSDL type definition



VsanHostCreateVmHealthTest(createVmHealthTest)

Perform VM creation test on localhost.
Required Privileges
System.Read
Since
vSAN API 6.6

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
timeoutxsd:int

time out for the creation of VM

Return Value

Type Description
VsanHostCreateVmHealthTestResultsummarized creation vm test result on the host

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault

Events

Type
None

Show WSDL type definition



VsanHostPrepareVmdkLoadTest(prepareVmdkLoadTest)

Deprecated. As of vSphere API 6.7.

Prepare the VMDK load test. It will create VMDKs on the host according to the VMDK creation spec given in the specs parameter.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
runnamexsd:string

The name for this VMDK load test
specsVsanVmdkLoadTestSpec[]

The VMDK load test spec list each of which includes the VMDK creation spec and IO load test spec

Return Value

Type Description
xsd:string

Faults

Type Description
FileFault
InvalidDatastorePath
NotFound
NotSupported
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault

Events

Type
None

Show WSDL type definition



VsanHostQueryAdvCfg(queryAdvCfg)

Query advanced configuration on host
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
optionsxsd:string[]

list of path for the configuration name for example: [VSAN.VsanSparseCacheThreshold, VSAN.ClomRepairDelay, VSAN.ClomRebalanceThreshold, VSAN.DomLongOpTraceMS...]
includeAllAdvOptions*xsd:boolean

Flag to check for all possible config options. If set to True the options parameter is ignored.

Since vSAN API 6.6
nonDefaultOnly*xsd:boolean

Flag to return only options with non-default values.

Since vSAN API vSAN 6.7U1
*Need not be set

Return Value

Type Description
OptionValue[]list of key value pair of the querying options for example:<'VSAN.VsanSparseCacheThreshold':1>, <'VSAN.ClomRepairDelay':60>... Allow to return empty list.

Faults

Type Description
NotFoundthe path is not found
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQueryCheckLimits(queryCheckLimits)

Determines limit health, i.e. if any system resources (free disk space, vSAN component counts, etc.) are exhausted, or would be exhausted after simulated failures. All information is as seen by this host, which under network partitions is not the global view.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.

Return Value

Type Description
VsanLimitHealthResultSummarized limit health as seen by this host

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQueryEncryptionHealthSummary(queryEncryptionHealthSummary)

Query the encryption health summary on the host.
Required Privileges
System.Read
Since
vSAN API 6.6

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.

Return Value

Type Description
VsanEncryptionHealthSummaryThe encryption health summary result

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQueryHealthSystemVersion(queryVersion)

Return a string which represents vSAN version number for the querying host. for example: vSphere 6.0u2 host will return '6.2.0.0'
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
displayVersion*xsd:boolean

True to return vSAN display version instead of internal version. Default is False.

Since vSAN API vSAN 6.7U1
*Need not be set

Return Value

Type Description
xsd:stringThe vSAN version.

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQueryHostInfoByUuids(queryHostInfoByUuids)

Query host info by host uuid. Multiple vSAN Host UUIDs may be passed in. If a uuid can't be resolved, it is still included in the result set, but without any additional information given.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
uuidsxsd:string[]

List of vSAN Host/Node UUIDs

Return Value

Type Description
VsanQueryResultHostInfo[]The hosts information for the given vSAN host/node UUIDs

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQueryObjectHealthSummary(queryObjectHealthSummary)

Query the object health status
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
objUuids*xsd:string[]

The DOM object UUID list to be queried. None to query all of objects

Since vSphere API 5.5
includeObjUuids*xsd:boolean

True to include the object UUID list in the returned list and default is False

Since vSphere API 5.5
localHostOnly*xsd:boolean

True to only query the objects owned by the host and default is False

Since vSphere API 5.5
includeNonComplianceObjDetail*xsd:boolean

True to include all of non-compliant objects detail information. The default is False

Since vSAN API vSAN 6.7U1
*Need not be set

Return Value

Type Description
VsanObjectOverallHealthThe object health status query result

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQueryPhysicalDiskHealthSummary(queryPhysicalDiskHealthSummary)

Query the physical disks health summary on the host
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.

Return Value

Type Description
VsanPhysicalDiskHealthSummaryThe physical disks health summary result

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQueryRunIperfClient(queryRunIperfClient)

Run the network performance test client side program to act as the sender to send the packet to each of receiver.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
multicastxsd:boolean

True to test mutlicast network performance. False to test unicast network performance.
serverIpxsd:string

The server IP binding to in the test
durationSec*xsd:int

Since vSAN API vSAN 6.7U1
*Need not be set

Return Value

Type Description
VsanNetworkLoadTestResultThe network performance test result

Faults

Type Description
NotFound
NotSupported
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQueryRunIperfServer(queryRunIperfServer)

Run the network performance test server side program to act as the receiver to receive the packet from sender.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
multicastxsd:boolean

True to test mutlicast network performance. False to test unicast network performance.
serverIp*xsd:string

The server IP binding to in the test

Since vSphere API 5.5
durationSec*xsd:int

Since vSAN API vSAN 6.7U1
*Need not be set

Return Value

Type Description
VsanNetworkLoadTestResultThe network performance test result

Faults

Type Description
NotFound
NotSupported
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQuerySmartStats(querySmartStats)

Query the physical disks S.M.A.R.T. stats on the host
Required Privileges
System.Read
Since
vSAN API 6.6

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
disks*xsd:string[]

Since vSAN API 6.6
includeAllDisks*xsd:boolean

Since vSAN API 6.6
*Need not be set

Return Value

Type Description
VsanSmartStatsHostSummaryThe physical disks S.M.A.R.T. stats

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostQueryVerifyNetworkSettings(queryVerifyNetworkSettings)

Queries all network settings required to perform a cluster wide network health check. In addition, for all specified peers connectivity checks are performed, providing network health from the perspective of this ESXi host.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
peers*xsd:string[]

List of IP addresses of other hosts in the vSAN cluster. Used to perform connectivity checks.

Since vSphere API 5.5
ROBOStretchedClusterWitnesses*xsd:string[]

List of ROBO witness IPs. Used to info host that during the network connectivity check, the time out threshold should be different.

Since vSphere API 5.5
vMotionPeers*xsd:string[]

List of IP addresses of vMotion traffic enabled NICs excludes this host. Used to perform vMotion connectivity checks.

Since vSAN API 6.6
*Need not be set

Return Value

Type Description
VsanNetworkHealthResultSummarized network health related information from the perspective of this host.

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostRepairImmediateObjects(repairImmediateObjects)

When the health check for vSAN object health test detects issues, this API can be used to repair the objects immediately. the result would return objects in three lists the queuing repairing list: contains objects which are queuing for repairing the failed repaired list: contains objects which fails to repaired the not in queue list: contains objects which are not in repairing queue due to out of slot even though the objects are in the queuing repairing list, it does not mean the repair process is done. The completing time for repairing all of objects is unpredictable and depends on vSAN backend.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
uuids*xsd:string[]

UUID list of the objects to be fixed

Since vSphere API 5.5
repairType*xsd:string

Type of repair, can be 'fix-object-immediate' (default) or 'crawler'

Since vSphere API 5.5
*Need not be set

Return Value

Type Description
VsanRepairObjectsResult

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanHostRunVmdkLoadTest(runVmdkLoadTest)

Deprecated. As of vSphere API 6.7.

Run the VMDK load test according to the IO load test spec. It cannot be run before the test VMDK is created by invoking QueryPrepareVmdkLoadTest() API.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
runnamexsd:string

The name for this VMDK load test
durationSecxsd:int

The duration time for each of VMDK load test
specsVsanVmdkLoadTestSpec[]

The VMDK load test spec list each of which includes the VMDK creation spec and IO load test spec

Return Value

Type Description
VsanVmdkLoadTestResult[]

Faults

Type Description
NotFound
NotSupported
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



VsanQueryHostEMMState(queryHostEMMState)

Query the host's maintenance mode and vSAN node decommission state.
Required Privileges
System.Read
Since
vSAN API 6.7

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.

Return Value

Type Description
VsanHostEMMSummaryThe summary including if host is in MM and node decommission state on this host.

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault

Events

Type
None

Show WSDL type definition



VsanStartProactiveRebalance(startProactiveRebalance)

Initiate proactive rebalance on target host
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
timeSpan*xsd:int

Determines how long this proactive rebalance operation lasts in seconds, default 86400.

Since vSphere API 5.5
varianceThreshold*xsd:float

Only if the disk's fullness (defined as used_capacity/disk_capacity) is above mean fullness and exceeds the lowest-usage disk in the cluster than this threshold, this disk is qualified for proactive rebalancing, default 0.3.

Since vSphere API 5.5
timeThreshold*xsd:int

Only if the variance threshold has been continuously exceeded for this amount of time (in sec), the proactive rebalance operation will be applied to this disk, default 1800.

Since vSphere API 5.5
rateThreshold*xsd:int

Determines how many bytes CLOMD on this node can move out per hour (MB/hr) for proactive rebalancing, default 51200.

Since vSphere API 5.5
*Need not be set

Return Value

Type Description
xsd:booleanTrue if the proactive rebalance has been triggered successfully but doesn't mean the proactive rebalance has been finished

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault

Events

Type
None

Show WSDL type definition



VsanStopProactiveRebalance(stopProactiveRebalance)

Stop proactive rebalance on target host
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.

Return Value

Type Description
xsd:booleanTrue if triggering stopping proactive rebalance successfully but doesn't mean the proactive rebalance has been stopped

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault

Events

Type
None

Show WSDL type definition



VsanWaitForVsanHealthGenerationIdChange(waitForVsanHealthGenerationIdChange)

Waiting until the change of current vSAN health generation ID or timed out. The change of generation ID indicates there are potential vSAN health status changes in the host
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostVsanHealthSystem used to make the method call.
timeoutxsd:int

The timeout in seconds. The recommended timeout is 10s

Return Value

Type Description
xsd:booleanTrue indicates there is generation ID change

Faults

Type Description
NotFound
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition