Vsan Vc Cluster Health System Vsan Query Vc Cluster Health Summary

Vsan Vc Cluster Health System Vsan Query Vc Cluster Health Summary

Perform a cluster wide health check across all types of health checks.

It's the primary API for fetching vSAN health status. This API runs a wide variety of health checks in many different categories against the cluster and returns both API-friendly and UI-friendly data. The 'fields' parameter should be used to return what the client is really interested in to limit the big result size for performance consideration. The API can either perform a health check against the up-to-date state of the hosts in the cluster and takes several seconds to return or it can retrieve the latest cached result to return in second. It's encouraged to fetch the cached data to get the quick response unless an update is required. Note: when this API is called directly from an ESXi host, following test groups are not supported: groupId = com.vmware.vsan.health.test.hcl

Querying vSAN cluster requires System.Read privilege on the cluster. If the API is called to have pre-flight health check on a bunch of hosts, System.Read privilege on all these hosts is required.

See also VsanHealthPerspectiveEnum, VsanHealthPerspective90Enum.

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/vsan/VsanVcClusterHealthSystem/{moId}/VsanQueryVcClusterHealthSummary
COPY
Path Parameters
string
moId
Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case VsanVcClusterHealthSystem/{moId}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.


Request Body
Required
"VsanQueryVcClusterHealthSummaryRequestType Object"
cluster
Optional

The target cluster

integer As int32 As int32
vmCreateTimeout
Optional

vmCreateTimeout

array of string
objUuids
Optional

objUuids

boolean
includeObjUuids
Optional

Whether to include detailed per-object health in the result. Default to True. Set to false if this value is not of importance to save computing resources.

array of string
fields
Optional

If set, only the properties listed in the array are returned in the result data object. Normally the output of this API can be quite large so this allows clients which are only interested in a subset to save network bandwidth and deserialization effort. The possible value is the field from the VsanClusterHealthSummary class like 'objectHealth', 'networkHealth' etc If unset, following properities are included in the result. 'clusterStatus', 'timestamp', 'clusterVersions', 'objectHealth', 'vmHealth', 'networkHealth', 'limitHealth', 'advCfgSync', 'createVmHealth', 'physicalDisksHealth', 'hclInfo', 'groups', 'overallHealth', 'overallHealthDescription', 'clomdLiveness', 'diskBalance'

boolean
fetchFromCache
Optional

True to return the result from cache directly instead of running the full health check. The cache will be updated and keep the latest vSAN health summary check result either triggering from user on-demand request or the periodical vSAN health check for triggering health event/alarm. Default is False.

string
perspective
Optional

The total amount of health checks is split into multiple different perspectives. This parameter controls which health checks are performed/returned. All supported values are defined in below enumerations: VsanHealthPerspectiveEnum, VsanHealthPerspective90Enum.

array of object
hosts
Optional

Include the individual host(s) into the health check, with other hosts specified with the cluster parameter.

spec
Optional

Health summary query specification VsanClusterHealthQuerySpec.

Authentication
This operation uses the following authentication methods.
Responses
200

Returns a health summary data object.

Returns VsanClusterHealthSummary of type(s) application/json
"VsanClusterHealthSummary Object"
object
clusterStatus
Optional

Structure which aggregates vSAN Health service installation status of all ESX hosts in cluster.

string As date-time As date-time
timestamp
Optional

The timestamp for generating the health summary.

The timestamp will remain unchanged if the health summary is cached and fetched in future indicating when the health check was performed

clusterVersions
Optional

Health system version information across the cluster.

Meant for programmatic consumption.

objectHealth
Optional

Object health information across the cluster.

Meant for programmatic consumption.

vmHealth
Optional

Ignore this value.

networkHealth
Optional

Network health information across the cluster.

Meant for programmatic consumption.

limitHealth
Optional

Limits health information across the cluster.

Meant for programmatic consumption.

array of object
advCfgSync
Optional

Advanced configuration synchronization information across the cluster.

Meant for programmatic consumption.

array of object
createVmHealth
Optional

VM creation results information across the cluster.

Meant for programmatic consumption. Will only be populated if the respective test was run.

array of object
physicalDisksHealth
Optional

Physical vSAN disk information across the cluster.

Meant for programmatic consumption.

encryptionHealth
Optional

Encryption information across the cluster.

Meant for programmatic consumption.

hclInfo
Optional

HCL check information across the cluster.

Meant for programmatic consumption.

array of object
groups
Optional

Data driven structure to display all health findings for purpose of rendering a UI.

The health findings are grouped into "groups" of "tests". Each group and each test has a description, health, and optionally one or more "details" tables to display additional information about the test. Programmatic consumption of the health findings should avoid parsing this structure because it is meant for UI consumption and the content will change to improve user experience.

string
overallHealth
Required

Health Enum.

Summarizes all groups and provides a high level status across all categories of health. This Enum defines sets labels for sets of health checks.

string
overallHealthDescription
Required

A human readable, short, description of the overallHealth status.

As there may be many issues detected, the most important one is selected to be described. This should be the one getting first customer attention.

clomdLiveness
Optional

CLOMD liveness on every vSAN host.

Meant for programmatic consumption

diskBalance
Optional

Balance of disk utilization across the cluster.

genericCluster
Optional

Generic cluster configuration best practices checks.

networkConfig
Optional

Network configuration best practices checks.

vsanConfig
Optional

vSAN configuration checks.

burnInTest
Optional

Deprecated as of vSphere API 6.7.

vSAN burn in test checks.

perfsvcHealth
Optional

vSAN performance service health check result.

cluster
Optional

The target cluster

fileServiceHealth
Optional

File service health information across the cluster.

Meant for programmatic consumption. If the file service is not enabled, this field would not be set.

ditEncryptionHealth
Optional

Data-in-transit encryption information across the cluster.

Meant for programmatic consumption.

integer As int32 As int32
healthScore
Optional

The overall health score ranging from 0 to 100 based on the vSAN cluster health check result.

globalDedupHealth
Optional

The global dedup health summary across the cluster.

Meant for programmatic consumption.


500

VsanFault: If the perspective validation failed, or the API is queried from vSAN witness node, or any unexpected runtime error.

Returns VimFault of type(s) application/json
This response body class contains all of the following: InlineVimFault0
"VimFault Object"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/vsan/VsanVcClusterHealthSystem/{moId}/VsanQueryVcClusterHealthSummary
                
V San Service Api Operations
POST
Vsan Vc Cluster Health System Vsan Attach Vsan Support Bundle To Sr
POST
Vsan Vc Cluster Health System Vsan Download And Install Vendor Tool Task
Deprecated
POST
Vsan Vc Cluster Health System Vsan Download Hcl File Task
Deprecated
POST
Vsan Vc Cluster Health System Vsan Get Hcl Constraints
POST
Vsan Vc Cluster Health System Vsan Vc Cluster Get Hcl Info
POST
Vsan Vc Cluster Health System Vsan Get Release Recommendation
POST
Vsan Vc Cluster Health System Vsan Get Disk Hcl Constraints
POST
Vsan Vc Cluster Health System Vsan Get Hcl Info For Eligible Disks
POST
Vsan Vc Cluster Health System Vsan Health Get Vsan Cluster Silent Checks
POST
Vsan Vc Cluster Health System Vsan Health Is Rebalance Running
POST
Vsan Vc Cluster Health System Vsan Purge Hcl Files
Deprecated
POST
Vsan Vc Cluster Health System Vsan Query All Supported Health Checks
POST
Vsan Vc Cluster Health System Vsan Query Attach To Sr History
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Create Vm Health History Test
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Create Vm Health Test
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Health Summary
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Health Summary Task
POST
Vsan Vc Cluster Health System Vsan Query Cluster Historical Health
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Network Perf History Test
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Network Perf Task
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Network Perf Test
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Vmdk Load History Test
Deprecated
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Vmdk Workload Types
Deprecated
POST
Vsan Vc Cluster Health System Vsan Cluster Query File Service Health Summary
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Smart Stats Summary
POST
Vsan Vc Cluster Health System Vsan Vc Cluster Query Verify Health System Versions
POST
Vsan Vc Cluster Health System Vsan Health Query Vsan Cluster Health Check Interval
POST
Vsan Vc Cluster Health System Vsan Health Query Vsan Cluster Health Config
POST
Vsan Vc Cluster Health System Vsan Query Vc Cluster Obj Ext Attrs
POST
Vsan Vc Cluster Health System Vsan Health Query Vsan Proxy Config
POST
Vsan Vc Cluster Health System Vsan Rebalance Cluster
POST
Vsan Vc Cluster Health System Vsan Health Repair Cluster Objects Immediate
POST
Vsan Vc Cluster Health System Vsan Vc Cluster Run Vmdk Load Test
Deprecated
POST
Vsan Vc Cluster Health System Vsan Health Send Vsan Telemetry
POST
Vsan Vc Cluster Health System Vsan Health Set Log Level
POST
Vsan Vc Cluster Health System Vsan Health Set Vsan Cluster Health Check Interval
POST
Vsan Vc Cluster Health System Vsan Health Set Vsan Cluster Silent Checks
POST
Vsan Vc Cluster Health System Vsan Health Set Vsan Cluster Telemetry Config
POST
Vsan Vc Cluster Health System Set Vsan Vcg Mapping For Hw Devices
POST
Vsan Vc Cluster Health System Vsan Stop Rebalance Cluster
POST
Vsan Vc Cluster Health System Vsan Health Test Vsan Cluster Telemetry Proxy
POST
Vsan Vc Cluster Health System Vsan Health Update Default DS Policy Recommendation
POST
Vsan Vc Cluster Health System Vsan Vc Update Hcl Db From Web
POST
Vsan Vc Cluster Health System Vsan Vc Upload Hcl Db