Managed Object - VsanVcClusterHealthSystem(vim.cluster.VsanVcClusterHealthSystem)

See also: ClusterComputeResource, Datastore, HostSystem, Task, VsanAttachToSrOperation, VsanClusterCreateVmHealthTestResult, VsanClusterFileServiceHealthSummary, VsanClusterHclInfo, VsanClusterHealthCheckInfo, VsanClusterHealthConfigs, VsanClusterHealthQuerySpec, VsanClusterHealthSummary, VsanClusterHealthSystemVersionResult, VsanClusterNetworkLoadTestResult, VsanClusterNetworkPerfTaskSpec, VsanClusterObjectExtAttrs, VsanClusterTelemetryProxyConfig, VsanClusterVmdkLoadTestResult, VsanDiskModelInfo, VsanHclDiskConstraint, VsanHclQuerySpec, VsanHclReleaseConstraint, VsanHistoricalHealthQuerySpec, VsanHwToVcgInfoMappingSpec, VsanSmartStatsHostSummary, VsanStorageWorkloadType, VsanVmdkLoadTestSpec
Since: vSphere API Release 5.5

Managed Object Description

This managed object provides access to vSAN Health related configuration and query APIs, operating at a vSAN cluster level. It can be accessed through MOID of 'vsan-cluster-health-system', through vSAN service at vCenter server side.

Properties

Name	Type	Description
None

Methods

Methods defined in this Managed Object
SetVsanVcgMappingForHwDevices, VsanAttachVsanSupportBundleToSr, VsanClusterQueryFileServiceHealthSummary, VsanDownloadAndInstallVendorTool_Task, VsanDownloadHclFile_Task, VsanGetDiskHclConstraints, VsanGetHclConstraints, VsanGetHclInfoForEligibleDisks, VsanGetReleaseRecommendation, VsanHealthGetVsanClusterSilentChecks, VsanHealthIsRebalanceRunning, VsanHealthQueryVsanClusterHealthCheckInterval, VsanHealthQueryVsanClusterHealthConfig, VsanHealthQueryVsanProxyConfig, VsanHealthRepairClusterObjectsImmediate, VsanHealthSendVsanTelemetry, VsanHealthSetLogLevel, VsanHealthSetVsanClusterHealthCheckInterval, VsanHealthSetVsanClusterSilentChecks, VsanHealthSetVsanClusterTelemetryConfig, VsanHealthTestVsanClusterTelemetryProxy, VsanHealthUpdateDefaultDSPolicyRecommendation, VsanPurgeHclFiles, VsanQueryAllSupportedHealthChecks, VsanQueryAttachToSrHistory, VsanQueryClusterHistoricalHealth, VsanQueryVcClusterCreateVmHealthHistoryTest, VsanQueryVcClusterCreateVmHealthTest, VsanQueryVcClusterHealthSummary, VsanQueryVcClusterHealthSummaryTask, VsanQueryVcClusterNetworkPerfHistoryTest, VsanQueryVcClusterNetworkPerfTask, VsanQueryVcClusterNetworkPerfTest, VsanQueryVcClusterObjExtAttrs, VsanQueryVcClusterSmartStatsSummary, VsanQueryVcClusterVmdkLoadHistoryTest, VsanQueryVcClusterVmdkWorkloadTypes, VsanRebalanceCluster, VsanStopRebalanceCluster, VsanVcClusterGetHclInfo, VsanVcClusterQueryVerifyHealthSystemVersions, VsanVcClusterRunVmdkLoadTest, VsanVcUpdateHclDbFromWeb, VsanVcUploadHclDb

Methods defined in this Managed Object

SetVsanVcgMappingForHwDevices, VsanAttachVsanSupportBundleToSr, VsanClusterQueryFileServiceHealthSummary, VsanDownloadAndInstallVendorTool_Task, VsanDownloadHclFile_Task, VsanGetDiskHclConstraints, VsanGetHclConstraints, VsanGetHclInfoForEligibleDisks, VsanGetReleaseRecommendation, VsanHealthGetVsanClusterSilentChecks, VsanHealthIsRebalanceRunning, VsanHealthQueryVsanClusterHealthCheckInterval, VsanHealthQueryVsanClusterHealthConfig, VsanHealthQueryVsanProxyConfig, VsanHealthRepairClusterObjectsImmediate, VsanHealthSendVsanTelemetry, VsanHealthSetLogLevel, VsanHealthSetVsanClusterHealthCheckInterval, VsanHealthSetVsanClusterSilentChecks, VsanHealthSetVsanClusterTelemetryConfig, VsanHealthTestVsanClusterTelemetryProxy, VsanHealthUpdateDefaultDSPolicyRecommendation, VsanPurgeHclFiles, VsanQueryAllSupportedHealthChecks, VsanQueryAttachToSrHistory, VsanQueryClusterHistoricalHealth, VsanQueryVcClusterCreateVmHealthHistoryTest, VsanQueryVcClusterCreateVmHealthTest, VsanQueryVcClusterHealthSummary, VsanQueryVcClusterHealthSummaryTask, VsanQueryVcClusterNetworkPerfHistoryTest, VsanQueryVcClusterNetworkPerfTask, VsanQueryVcClusterNetworkPerfTest, VsanQueryVcClusterObjExtAttrs, VsanQueryVcClusterSmartStatsSummary, VsanQueryVcClusterVmdkLoadHistoryTest, VsanQueryVcClusterVmdkWorkloadTypes, VsanRebalanceCluster, VsanStopRebalanceCluster, VsanVcClusterGetHclInfo, VsanVcClusterQueryVerifyHealthSystemVersions, VsanVcClusterRunVmdkLoadTest, VsanVcUpdateHclDbFromWeb, VsanVcUploadHclDb

SetVsanVcgMappingForHwDevices(setVsanVcgMappingForHwDevices)

This API can help to build up the mapping from the hardware infomation to the vSAN VCG entry. The hardware information in the spec can be fetched by vim.cluster.VsanVcClusterHealthSystem#GetClusterHclInfo.

Required Privileges: Global.Settings
Since: vSAN API vSAN 7.0U3

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

spec

VsanHwToVcgInfoMappingSpec

Refer to VsanHwToVcgInfoMappingSpec

Since vSAN API vSAN 7.0U3

Return Value

Type	Description
xsd:boolean	True to indicate the VCG product IDs are set successfully.

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault	Thrown if an unexpected error happened during the process.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="SetVsanVcgMappingForHwDevices" type="vsan:SetVsanVcgMappingForHwDevicesRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="SetVsanVcgMappingForHwDevicesResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:boolean"/>
                     </sequence>
                  </complexType>
               </element>

VsanAttachVsanSupportBundleToSr(attachVsanSupportBundleToSr)

Collect vSAN and vCenter support bundle and upload to VMware for the given SR (Service Request). The collected support bundles including vSAN health and tracing log bundle, all of ESXi host support bundle and VC support bundle The upload process will be in three stages separately with the order of bundle size to avoid possible time out, which are vCenter bundles, small high importance ESXi/vSAN manifests, vSAN traces and lower priority ESXi manifests. The network proxy for uploading is also supported by calling SetVsanClusterTelemetryConfig() in advance.

Required Privileges: Global.Diagnostics

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster

ManagedObjectReference
to a ClusterComputeResource

The vCenter cluster

Since vSphere API Release 5.5

srNumber

xsd:string

The Customer Service Request number ID

Since vSphere API Release 5.5

Return Value

Type	Description
ManagedObjectReference to a Task	task vCenter Task

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanAttachVsanSupportBundleToSr" type="vsan:VsanAttachVsanSupportBundleToSrRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanAttachVsanSupportBundleToSrResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanClusterQueryFileServiceHealthSummary(queryFileServiceHealthSummary)

Query the vSAN file service health on all the hosts in the specified cluster. Use filter fields to determine whether to include infra health or container health. It will include infra health at least.

Required Privileges: None
Since: vSAN API 7.0

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target cluster.

Since vSAN API 7.0

P Required privilege: System.Read

Return Value

Type	Description
VsanClusterFileServiceHealthSummary	The file service health summary. Return None if the file service is not enabled.

Faults

Type	Description
InvalidArgument	Exception for invalid input arguments, for example, if the cluster is not found.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanClusterQueryFileServiceHealthSummary" type="vsan:VsanClusterQueryFileServiceHealthSummaryRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanClusterQueryFileServiceHealthSummaryResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterFileServiceHealthSummary" minOccurs="0"/>
                     </sequence>
                  </complexType>
               </element>

VsanDownloadAndInstallVendorTool_Task(downloadAndInstallVendorTool)

Deprecated. As of vSphere API 8.0.

Download and install the vendor tool required for the target cluster. API iterate thru all the update items for the given cluster and download the all the vendor tools required by the cluster. Vendor tool update item is specified by vibSpecType as 'tool'. Download of vendor tool will be skipped if tool is already present on vCenter storage. Check VsanDownloadHclFile_Task for the details about download. After download vendor tools will be installed on the hosts referenced by the vibSpec of vendor tools.

Required Privileges: Global.Settings
Since: vSAN API vSAN 6.7U1

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster

ManagedObjectReference
to a ClusterComputeResource

Since vSAN API vSAN 6.7U1

Return Value

Type	Description
ManagedObjectReference to a Task

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

VsanDownloadHclFile_Task(downloadHclFile)

Deprecated. As of vSphere API 8.0.

Download driver/firmware from the URL extracted from HCL database by 'id' and 'md5sum'. The content will be save on the vCenter storage with the auto-generated filename. The checksum of content will be checked after content is saved on the disk.

Required Privileges: Global.Settings
Since: vSAN API 6.6

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

sha1sums

xsd:string[]

Since vSAN API 6.6

Return Value

Type	Description
ManagedObjectReference to a Task

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

VsanGetDiskHclConstraints(getDiskHclConstraints)

Get the vSAN HCL constraints for disk drives.

Required Privileges: System.Read
Since: vSAN API vSAN 7.0U3

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

release*

xsd:string

The target vSphere release. If not provided, HCL constraints for all the supported releases will be returned.

Since vSAN API vSAN 7.0U3

diskModels*

VsanDiskModelInfo[]

The disk models to query. If provided, the HCL constraints with matching disk model info as in the query options will be returned.

Since vSAN API vSAN 7.0U3

*Need not be set

Return Value

Type	Description
VsanHclDiskConstraint[]	The HCL constraints for all the disk drives.

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault	Thrown if unexpected error happened during the query, such as the cluster HCL info is unable to be retrieved, etc.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetDiskHclConstraints" type="vsan:VsanGetDiskHclConstraintsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetDiskHclConstraintsResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanHclDiskConstraint" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanGetHclConstraints(getClusterHclConstraints)

Get the HCL driver/firmware constraints for PCIe devices used by vSAN in the cluster.

Required Privileges: None
Since: vSAN API 7.0

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target vSAN cluster

Since vSAN API 7.0

release

xsd:string

The target vSphere release

Since vSAN API 7.0

P Required privilege: System.Read

Return Value

Type	Description
VsanHclReleaseConstraint	The HCL driver constraints for all the PCIe device used by vSAN, and current firmware versions of that device in the cluster.

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault	Thrown if unexpected error happened during the query, such as the cluster HCL info is unable to be retrieved, etc.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetHclConstraints" type="vsan:VsanGetHclConstraintsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetHclConstraintsResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanHclReleaseConstraint"/>
                     </sequence>
                  </complexType>
               </element>

VsanGetHclInfoForEligibleDisks(getHclInfoForVsanEligibleDisks)

Fetch HCL information for all vSAN ESA eligible disks of the target object which can be a vSAN cluster or a list of hosts. Check VsanHclQuerySpec for more details. Note that it only returns disk related HCL information, the fields of other hardware components like CPU, physical NIC will be unset.

Required Privileges: System.Read
Since: vSAN API 8.0.0.1

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

querySpec

VsanHclQuerySpec

Provide the capability to customize the query

Since vSAN API 8.0.0.1

Return Value

Type	Description
VsanClusterHclInfo	The HCL information for the cluster

Faults

Type	Description
NotFound	Thrown if host could not be contacted to perform the operation.
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault	Thrown if unexpected error happened during the query, such as the cluster HCL info is unable to be retrieved, etc.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetHclInfoForEligibleDisks" type="vsan:VsanGetHclInfoForEligibleDisksRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetHclInfoForEligibleDisksResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterHclInfo"/>
                     </sequence>
                  </complexType>
               </element>

VsanGetReleaseRecommendation(getClusterReleaseRecommendation)

Get the vSAN recommendation of ESXi releases to update for a cluster, and the associated HCL device constraints to comply for those releases.

Required Privileges: None
Since: vSAN API 7.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	The target vSAN cluster *Since* vSAN API 7.0
minor	xsd:string[]	A list of minor update releases. E.g., ['ESXi 6.7 U2'] *Since* vSAN API 7.0
major	xsd:string[]	A list of major update releases. E.g., ['ESXi 6.8', 'ESXi 7.0'] *Since* vSAN API 7.0

P Required privilege: System.Read

Return Value

Type	Description
VsanHclReleaseConstraint[]	A list of VsanHclReleaseConstraint consists of: Hcl Constraints for one recommended minor release(if applicable) and Hcl Constraints for one recommended major release(if applicable). If none of the minor or major releases are prefered by vSAN, an empty list will be returned.

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault	Thrown if unexpected error happened during the query, such as the releases to query is not recognized or supported by vSAN, or vSAN is not able to retrieve the HCL info from the cluster, etc.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetReleaseRecommendation" type="vsan:VsanGetReleaseRecommendationRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetReleaseRecommendationResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanHclReleaseConstraint" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanHealthGetVsanClusterSilentChecks(getVsanClusterSilentChecks)

Get the user configured silent health check list of the cluster. This API will not return the system configured silent health check items. vSAN will automatically configure the following health check items in the following conditions:

HCL DB auto update in the air gap case.

This API only supported on vCenter.

Required Privileges: None
Since: vSAN API 6.6

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target VC cluster

Since vSAN API 6.6

P Required privilege: System.Read

Return Value

Type	Description
xsd:string[]	The list of all silent health checks testIds

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthGetVsanClusterSilentChecks" type="vsan:VsanHealthGetVsanClusterSilentChecksRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthGetVsanClusterSilentChecksResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanHealthIsRebalanceRunning(isRebalanceRunning)

Check whether the proactive rebalance is running or not against the target cluster or the hosts

Required Privileges: None

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target vCenter cluster.

Since vSphere API Release 5.5

targetHosts*

ManagedObjectReference[]
to a HostSystem[]

Leave this unset

Since vSphere API Release 5.5

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
xsd:boolean	True if any of host has running rebalance process

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthIsRebalanceRunning" type="vsan:VsanHealthIsRebalanceRunningRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthIsRebalanceRunningResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:boolean"/>
                     </sequence>
                  </complexType>
               </element>

VsanHealthQueryVsanClusterHealthCheckInterval(queryVsanClusterHealthCheckInterval)

Get the periodical vSAN health check interval (in minutes) for the cluster. The periodical vSAN health check will perform a full vSAN health check at the fix interval which can be used in refreshing the cache as well as triggering the health event and alarm as the supplement of host event based auto cache refresh mechanism

Required Privileges: None

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target vCenter cluster

Since vSphere API Release 5.5

P Required privilege: System.Read

Return Value

Type	Description
xsd:int	The periodical health check interval in minutes. Return 0 indicates the scheduled health check is disabled

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthQueryVsanClusterHealthCheckInterval" type="vsan:VsanHealthQueryVsanClusterHealthCheckIntervalRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthQueryVsanClusterHealthCheckIntervalResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:int"/>
                     </sequence>
                  </complexType>
               </element>

VsanHealthQueryVsanClusterHealthConfig(queryVsanClusterHealthConfig)

Get the vSAN cluster health system configuration for the cluster Note when the API is called directly from an ESXi host, the configuration options may differ from that of from the vCenter. It returns only ones that may be meaningful to the ESXi host and the health service itself.

Required Privileges: None

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target vCenter cluster

Since vSphere API Release 5.5

P Required privilege: System.Read

Return Value

Type	Description
VsanClusterHealthConfigs	The vSAN cluster health service configuration

Faults

Type	Description
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthQueryVsanClusterHealthConfig" type="vsan:VsanHealthQueryVsanClusterHealthConfigRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthQueryVsanClusterHealthConfigResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterHealthConfigs"/>
                     </sequence>
                  </complexType>
               </element>

VsanHealthQueryVsanProxyConfig(queryVsanProxyConfig)

Get the vSAN proxy configuration. Return the proxy configuration for vSAN. The method gets the proxy configured via UI settings or vsan config file. If no proxy is configured, the api tries to check if any system level proxy is set.

Required Privileges: System.Read
Since: vSAN API 7.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.

Return Value

Type	Description
VsanClusterTelemetryProxyConfig	The vSAN proxy configuration

Faults

Type	Description
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthQueryVsanProxyConfig" type="vsan:VsanHealthQueryVsanProxyConfigRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthQueryVsanProxyConfigResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterTelemetryProxyConfig"/>
                     </sequence>
                  </complexType>
               </element>

VsanHealthRepairClusterObjectsImmediate(repairClusterObjectsImmediate)

Repair the absent or degraded vSAN object immediately under the cluster. The task triggered by this API will be finished after putting all of the required objects into repairing queue, but it doesn't mean the repair process is done or successful. The completing time for repairing all of objects is unpredictable and depends on vSAN backend.

Required Privileges: None

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The VC cluster.

Since vSphere API Release 5.5

uuids*

xsd:string[]

The object UUIDs need to be repaired. Unset to fix all of objects under the cluster

Since vSphere API Release 5.5

*Need not be set P Required privilege: Host.Config.Storage

Return Value

Type	Description
ManagedObjectReference to a Task	task VC Task

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthRepairClusterObjectsImmediate" type="vsan:VsanHealthRepairClusterObjectsImmediateRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthRepairClusterObjectsImmediateResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanHealthSendVsanTelemetry(sendVsanTelemetry)

Collecting vSAN telemetry for the given vCenter cluster and send to VMware phonehome server.

Required Privileges: Global.Settings

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster

ManagedObjectReference
to a ClusterComputeResource

The vCenter cluster for collecting vSAN telemetry data

Since vSphere API Release 5.5

Return Value

Type	Description
None

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSendVsanTelemetry" type="vsan:VsanHealthSendVsanTelemetryRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSendVsanTelemetryResponse">
                  <complexType/>
               </element>

VsanHealthSetLogLevel(setLogLevel)

Set the vSAN health log level which will be taken effect immediately. This setting will be refreshed and reverted to default INFO log level after vCenter system or health service is restarted. Setting the default log level as INFO in production because higher levels lead to too much log volume (reduced performance and too quick log rotation), while lower levels will not have enough information for troubleshooting by VMware support.

Required Privileges: Global.Settings

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

level*

xsd:string

The log level to set. Unset will set the log level to the default log level as INFO. See all log levels through VsanVcClusterHealthSystemVsanHealthLogLevelEnum

Since vSphere API Release 5.5

*Need not be set

Return Value

Type	Description
None

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSetLogLevel" type="vsan:VsanHealthSetLogLevelRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSetLogLevelResponse">
                  <complexType/>
               </element>

VsanHealthSetVsanClusterHealthCheckInterval(setVsanClusterHealthCheckInterval)

Set the periodical vSAN health check interval (in minutes) for the cluster. The periodical vSAN health check will perform a full vSAN health check at the fix interval which can be used in refreshing the cache as well as triggering the health event and alarm as the supplement of host event based auto cache refresh mechanism. Smaller value will perform the vSAN health more frequently to keep the cache to be more up-to-date but will increase the system overhead and vice versa. The default value is 1 hour.

Required Privileges: Global.Settings

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster

ManagedObjectReference
to a ClusterComputeResource

The target vCenter cluster

Since vSphere API Release 5.5

vsanClusterHealthCheckInterval

xsd:int

The vSAN cluster periodical health check interval in minutes. The value 0 will disable the periodical health check

Since vSphere API Release 5.5

Return Value

Type	Description
None

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSetVsanClusterHealthCheckInterval" type="vsan:VsanHealthSetVsanClusterHealthCheckIntervalRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSetVsanClusterHealthCheckIntervalResponse">
                  <complexType/>
               </element>

VsanHealthSetVsanClusterSilentChecks(setVsanClusterSilentChecks)

Set silent health check list of the cluster. Specify [testId/groupId] for 'addSilentChecks' to add add health checks to silent list. Specify [testId/groupId] for 'removeSilentChecks' to remove health checks from silent list. To restore the whole silent list, set 'removeSilentChecks' = ['all']. After the silent health check list is updated, it is recommended to refresh the vSAN cluster health summary to get the updated result. The health check items in the silent list should be skipped, and labeled with 'skipped' status. Note:

If groupId is added to silent list, all the checks under this group would be silent.
If groupId is removed from silent list, all the checks under this group would back to normal.
If given invalid testId/groupId, it will throw exception.
This method will do add first and then remove. So if the given health check is in both add and remove list, it would NOT be silent in the end.
This API only supported on vCenter.

Required Privileges: Global.Settings
Since: vSAN API 6.6

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster	ManagedObjectReference to a ClusterComputeResource	The target vCenter cluster *Since* vSAN API 6.6
addSilentChecks*	xsd:string[]	The health checks/groups to silent. *Since* vSAN API 6.6
removeSilentChecks*	xsd:string[]	The health checks/groups to restore. *Since* vSAN API 6.6

*Need not be set

Return Value

Type	Description
xsd:boolean	True to indicate the value being set successfully. No return otherwise.

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSetVsanClusterSilentChecks" type="vsan:VsanHealthSetVsanClusterSilentChecksRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSetVsanClusterSilentChecksResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:boolean"/>
                     </sequence>
                  </complexType>
               </element>

VsanHealthSetVsanClusterTelemetryConfig(setVsanClusterTelemetryConfig)

Set the vSAN clsuter CEIP (Customer Experience Improvement Program) configuration. The configuration includes the interval time for the periodical CEIP telemetry data collector and the network proxy for sending vSAN telemetry data as well as HCL updating and uploading vSAN support bundle. Notice this proxy will be shared across all of vCenter clusters. The default interval is 1 week.

Required Privileges: Global.Settings

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster

ManagedObjectReference
to a ClusterComputeResource

The target vCenter cluster

Since vSphere API Release 5.5

vsanClusterHealthConfig

VsanClusterHealthConfigs

The vSAN cluster CEIP configuration

Since vSphere API Release 5.5

Return Value

Type	Description
None

Faults

Type	Description
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSetVsanClusterTelemetryConfig" type="vsan:VsanHealthSetVsanClusterTelemetryConfigRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthSetVsanClusterTelemetryConfigResponse">
                  <complexType/>
               </element>

VsanHealthTestVsanClusterTelemetryProxy(testVsanClusterTelemetryProxy)

Test the vSAN proxy configuration, which is used for downloading, HCL DB, sending vSAN telemetry data and uploading support bundle. Return true if the proxy works fine. This API will take several of seconds to return if given wrong proxy.

Required Privileges: Global.Settings

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

proxyConfig

VsanClusterTelemetryProxyConfig

The proxy configuration

Since vSphere API Release 5.5

Return Value

Type	Description
xsd:boolean	True indicates the proxy test is successful

Faults

Type	Description
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthTestVsanClusterTelemetryProxy" type="vsan:VsanHealthTestVsanClusterTelemetryProxyRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthTestVsanClusterTelemetryProxyResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:boolean"/>
                     </sequence>
                  </complexType>
               </element>

VsanHealthUpdateDefaultDSPolicyRecommendation(updateDefaultDSPolicyRecommendation)

Update the cluster datastore default policy recommendation for this cluster. Setting this property will result into a task which updates the SPBM policy.

Required Privileges: None
Since: vSAN API 8.0.0.3

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The VC cluster.

Since vSAN API 8.0.0.3

P Required privilege: Global.Settings

Return Value

Type	Description
ManagedObjectReference to a Task	task VC Task

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthUpdateDefaultDSPolicyRecommendation" type="vsan:VsanHealthUpdateDefaultDSPolicyRecommendationRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHealthUpdateDefaultDSPolicyRecommendationResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanPurgeHclFiles(purgeHclFiles)

Deprecated. As of vSphere API 8.0.

Purge driver/firmware that was previously put on vCenter (either via download from URL or upload to vCenter).

Required Privileges: Global.Settings
Since: vSAN API 6.6

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

sha1sums

xsd:string[]

Since vSAN API 6.6

Return Value

Type	Description
None

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanPurgeHclFiles" type="vsan:VsanPurgeHclFilesRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanPurgeHclFilesResponse">
                  <complexType/>
               </element>

VsanQueryAllSupportedHealthChecks(queryAllSupportedHealthChecks)

Query basic info of all supported health checks

Required Privileges: System.Read
Since: vSAN API 6.6

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.

Return Value

Type	Description
VsanClusterHealthCheckInfo[]	A list of health check info constructed by testId, testName, groupId and groupName

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryAllSupportedHealthChecks" type="vsan:VsanQueryAllSupportedHealthChecksRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryAllSupportedHealthChecksResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterHealthCheckInfo" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryAttachToSrHistory(queryAttachToSrHistory)

Query the historical attach to SR operation result for the vCenter cluster. The historical data is only saved into memory and will disappear after the service is restart or shut down.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	The vCenter cluster *Since* vSphere API Release 5.5
count*	xsd:int	Collect the last test data for the given number at most. Default to get the latest one historical data. *Since* vSphere API Release 5.5
taskId*	xsd:string	The task Id which run the attach to SR operation.Default is None The count parameter will be ignored when the taskId is not None *Since* vSphere API Release 5.5

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
VsanAttachToSrOperation[]	The attach to SR operation results

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryAttachToSrHistory" type="vsan:VsanQueryAttachToSrHistoryRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryAttachToSrHistoryResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanAttachToSrOperation" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryClusterHistoricalHealth(queryClusterHistoricalHealth)

It queries vSAN cluster historical health information based on the query spec.

Query general historical health summary. If no groupId and testId specified in the query spec, it aggregates all the historical vSAN cluster health status for the given time range. Then returns a general health summary with only overallHealth, test group IDs, group healths, test IDs and test healths.
Query health status history for a certain health check. If groupId and testId are specified, and start time doesn't equal to end time, the result will only contain the historical testHealths for the given time range of the target health check.
Query a snapshot detail for a certain health check. If groupId and testId are specified, and start time equals to end time, the result will contain a full testDetail for the certain timestamp of the target health check.

Required Privileges: System.Read
Since: vSAN API vSAN 7.0U2

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

spec

VsanHistoricalHealthQuerySpec

The query spec.

Since vSAN API vSAN 7.0U2

Return Value

Type	Description
VsanClusterHealthSummary[]	vSAN cluster health summary with historical infomation.

Faults

Type	Description
InvalidArgument	Exception for invalid input arguments. For example, if given time range is more than one month. Or end time is smaller than the start time.
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryClusterHistoricalHealth" type="vsan:VsanQueryClusterHistoricalHealthRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryClusterHistoricalHealthResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterHealthSummary" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterCreateVmHealthHistoryTest(queryClusterCreateVmHealthHistoryTest)

Query the historical create VM test result for the vCenter cluster. The historical data is only saved into memory and will disappear after the service is restart or shut down.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	The vCenter cluster *Since* vSphere API Release 5.5
count*	xsd:int	Collect the last test data for the given number at most. Default to get the latest one historical data *Since* vSphere API Release 5.5
datastore*	ManagedObjectReference to a Datastore	The datastore where the create vm test has been run. It could be the local datastore or the remote datastore that is mounted to the cluster. By default it will run with local vSAN datastore. *Since* vSphere API Release 5.5

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
VsanClusterCreateVmHealthTestResult[]	The VM creation test results.

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterCreateVmHealthHistoryTest" type="vsan:VsanQueryVcClusterCreateVmHealthHistoryTestRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterCreateVmHealthHistoryTestResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterCreateVmHealthTestResult" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterCreateVmHealthTest(queryClusterCreateVmHealthTest)

Executes VM creation test and checks if a tiny VM can be created on each of host of the vSAN cluster

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	The target cluster *Since* vSphere API Release 5.5
timeout	xsd:int	The timeout in seconds for the VM creation test. The suggested value could be 2 mintues *Since* vSphere API Release 5.5
datastore*	ManagedObjectReference to a Datastore	The datastore where the VM creation test will be run. It could be the local datastore or the remote datastore that is mounted to the cluster. By default it will run with local vSAN datastore. *Since* vSphere API Release 5.5

*Need not be set P Required privilege: VirtualMachine.Inventory.Create VirtualMachine.Inventory.Delete

Return Value

Type	Description
VsanClusterCreateVmHealthTestResult	The vSAN cluster VM creation test result

Faults

Type	Description
InvalidArgument
NotFound
NotSupported
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterCreateVmHealthTest" type="vsan:VsanQueryVcClusterCreateVmHealthTestRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterCreateVmHealthTestResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterCreateVmHealthTestResult"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterHealthSummary(queryClusterHealthSummary)

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.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster*	ManagedObjectReference to a ClusterComputeResource	The target cluster *Since* vSphere API Release 5.5
vmCreateTimeout*	xsd:int	*Since* vSphere API Release 5.5
objUuids*	xsd:string[]	*Since* vSphere API Release 5.5
includeObjUuids*	xsd:boolean	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. *Since* vSphere API Release 5.5
fields*	xsd:string[]	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' *Since* vSphere API Release 5.5
fetchFromCache*	xsd:boolean	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. *Since* vSphere API Release 5.5
perspective*	xsd:string	The total amount of health checks is split into multiple different perspectives. This parameter controls which health checks are performed/returned. Please refer to VsanHealthPerspective for all of possible values *Since* vSphere API Release 5.5
hosts*	ManagedObjectReference[] to a HostSystem[]	Include the individual host(s) into the health check, with other hosts specified with the cluster parameter. *Since* vSphere API Release 5.5
spec*	VsanClusterHealthQuerySpec	Health summary query specification VsanClusterHealthQuerySpec. *Since* vSphere API Release 5.5

*Need not be set

Return Value

Type	Description
VsanClusterHealthSummary	Returns a health summary data object.

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterHealthSummary" type="vsan:VsanQueryVcClusterHealthSummaryRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterHealthSummaryResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterHealthSummary"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterHealthSummaryTask(queryClusterHealthSummaryTask)

An asynchronous API to perform all of cluster wide health checks including the online health checks if CEIP is enabled and returns the task. After the task is finished, all of health check result will be kept in the cache and can be fetched from the synchronous API vim.cluster.VsanVcClusterHealthSystem#QueryClusterHealthSummary by setting the parameter fetchFromCache as True, the perspective as 'defaultView' or unset and the parameter hosts should keep the same while leaving the other parameters as unset. If a new task is triggered while there's running task for same cluster, the new triggered task will be pending and return immediatelly once the running task is completed. The new triggered task will share the same health summary result as the running one.

Required Privileges: None
Since: vSAN API vSAN 6.7U1

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	The target cluster *Since* vSAN API vSAN 6.7U1
hosts*	ManagedObjectReference[] to a HostSystem[]	Include the individual host(s) into the health check, with other hosts specified with the cluster parameter *Since* vSAN API vSAN 6.7U1
includeDataProtectionHealth*	xsd:boolean	This parameter is not used, and no data protection health will be collected. *Since* vSAN API vSAN 6.7U1
includeOnlineHealth*	xsd:boolean	True to trigger vSAN online health. The default is True. *Since* vSAN API vSAN 6.7U1

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
ManagedObjectReference to a Task	task VC Task

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterHealthSummaryTask" type="vsan:VsanQueryVcClusterHealthSummaryTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterHealthSummaryTaskResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterNetworkPerfHistoryTest(queryClusterNetworkPerfHistoryTest)

Query the historical network performance test result for the vCenter cluster. The historical data is only saved into memory and will disappear after the service is restart or shut down.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	The vCenter cluster *Since* vSphere API Release 5.5
count*	xsd:int	Collect the last test data for the given number at most. Default to get the latest one historical data. *Since* vSphere API Release 5.5
spec*	VsanClusterNetworkPerfTaskSpec	The additional query spec for query network performance health test history. *Since* vSphere API Release 5.5

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
VsanClusterNetworkLoadTestResult[]	The vSAN cluster network performance test results.

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterNetworkPerfHistoryTest" type="vsan:VsanQueryVcClusterNetworkPerfHistoryTestRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterNetworkPerfHistoryTestResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterNetworkLoadTestResult" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterNetworkPerfTask(queryClusterNetworkPerfTask)

Asynchronous implementation of network performance test API vim.cluster.VsanVcClusterHealthSystem#QueryClusterNetworkPerfTest This returns task to monitor progress on success result is cached which can be retrieved using API using API vim.cluster.VsanVcClusterHealthSystem#QueryClusterNetworkPerfHistoryTest with the same datastore in query spec.

Required Privileges: None
Since: vSAN API vSAN 7.0U1

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target cluster

Since vSAN API vSAN 7.0U1

spec*

VsanClusterNetworkPerfTaskSpec

The additional query spec for network performance health

Since vSAN API vSAN 7.0U1

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
ManagedObjectReference to a Task	The VC task.

Faults

Type	Description
InvalidArgument
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterNetworkPerfTask" type="vsan:VsanQueryVcClusterNetworkPerfTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterNetworkPerfTaskResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterNetworkPerfTest(queryClusterNetworkPerfTest)

Query the vSAN network performance and checks if it meets the bandwidth requirements. For multicast performance, the test is done by picking one host as the sender, and having all other hosts be receivers. For unicast performance, the test is done by having all hosts form a circular list, and every host in the list will be sending packets to the next host, while receiving packets from the previous host at the same time. For multicast test, the status in test result will be:

red if the speed is less than 20 MB/s
yellow if the speed is between 20MB/s and 50MB/s
green if the speed is larger than 50MB/s

For unicast test, the status in test result will be:

red if the speed is 0 Mb/s
yellow if the speed is less than 850 Mb/s
green if the speed is larger than or equal to 850 Mb/s

Note: Calling this API requires vCenter and all the connected hosts to support the same network performance testing capability(multicast or unicast). As vSAN is moving from multicast to unicast, only the unicast test method is supported since vSphere 6.7 Update 1 release. This API will return "Not Supported" in case the test method is not currently supported by this cluster. User could query VsanGetCapabilities() API to check whether the cluster supports the unicast network performance test. The test is supported if the 'netperftest' capability can be found on the vCenter and all the hosts in this cluster. This API is intended for network bandwidth diagnostics in the environment with no production workloads. It is not designed for network bandwidth monitoring with production workloads as it might impact the actual network utilization during the test.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	The target cluster *Since* vSphere API Release 5.5
multicast	xsd:boolean	True to test vSAN multicast network performance. False to test vSAN unicast network performance. *Since* vSphere API Release 5.5
durationSec*	xsd:int	The duration of the Network Performance test. Default is 15 seconds if not set. *Since* vSphere API Release 5.5

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
VsanClusterNetworkLoadTestResult	The vSAN cluster network performance test result

Faults

Type	Description
NotFound
NotSupported
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterNetworkPerfTest" type="vsan:VsanQueryVcClusterNetworkPerfTestRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterNetworkPerfTestResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterNetworkLoadTestResult"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterObjExtAttrs(queryVsanObjExtAttrs)

Query the extended attributes for vSAN cluster objects.

Required Privileges: None
Since: vSAN API 6.7

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target cluster

Since vSAN API 6.7

uuids

xsd:string[]

List of object UUIDs.

Since vSAN API 6.7

P Required privilege: System.Read

Return Value

Type	Description
VsanClusterObjectExtAttrs[]	A list of vSAN cluster object extended attributes of given objects

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterObjExtAttrs" type="vsan:VsanQueryVcClusterObjExtAttrsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterObjExtAttrsResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterObjectExtAttrs" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterSmartStatsSummary(querySmartStatsSummary)

Query vSAN physical disks S.M.A.R.T. stats across all hosts in the target cluster.

Required Privileges: None
Since: vSAN API 6.6

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target cluster

Since vSAN API 6.6

P Required privilege: System.Read

Return Value

Type	Description
VsanSmartStatsHostSummary[]	The vSAN physical disks S.M.A.R.T. stats

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterSmartStatsSummary" type="vsan:VsanQueryVcClusterSmartStatsSummaryRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterSmartStatsSummaryResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanSmartStatsHostSummary" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterVmdkLoadHistoryTest(queryClusterVmdkLoadHistoryTest)

Deprecated. As of vSphere API 6.7.

Query the historical vSAN storage test result for the vCenter cluster. The historical data is only saved into memory and will disappear after the service is restart or shut down.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	The vCenter cluster *Since* vSphere API Release 5.5
count*	xsd:int	Collect the last test data for the given number at most. Default to get the latest one historical data. *Since* vSphere API Release 5.5
taskId*	xsd:string	The task Id which run the VMDK performance test. Default is None The count parameter will be ignored when the taskId is not None *Since* vSphere API Release 5.5

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
VsanClusterVmdkLoadTestResult[]	The vSAN storage load test results.

Faults

Type	Description
NotFound
NotSupported
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterVmdkLoadHistoryTest" type="vsan:VsanQueryVcClusterVmdkLoadHistoryTestRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterVmdkLoadHistoryTestResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterVmdkLoadTestResult" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryVcClusterVmdkWorkloadTypes(queryClusterVmdkWorkloadTypes)

Deprecated. As of vSphere API 6.7.

Query the pre-defined workload types for the VMDK performance test.

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.

Return Value

Type	Description
VsanStorageWorkloadType[]	The vSAN cluster VMDK workload type

Faults

Type	Description
NotFound
NotSupported
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterVmdkWorkloadTypes" type="vsan:VsanQueryVcClusterVmdkWorkloadTypesRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryVcClusterVmdkWorkloadTypesResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanStorageWorkloadType" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanRebalanceCluster(rebalanceCluster)

Proactive rebalance the vSAN objects on the cluster hosts based on the vSAN disks usage when the disks are in imbalance status. The typical use case will be adding new host/disk into the vSAN cluster. Users should be aware that rebalancing causes additional background IO requires for data movements

Required Privileges: None

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The vCenter cluster

Since vSphere API Release 5.5

targetHosts*

ManagedObjectReference[]
to a HostSystem[]

Leave this unset

Since vSphere API Release 5.5

*Need not be set P Required privilege: Host.Config.Storage

Return Value

Type	Description
ManagedObjectReference to a Task	task vCenter Task to track the rebalance process on the hosts. The task will be completed if all of hosts complete the rebalance

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanRebalanceCluster" type="vsan:VsanRebalanceClusterRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanRebalanceClusterResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanStopRebalanceCluster(stopRebalanceCluster)

Stop proactive rebalance the vSAN objects on the cluster hosts

Required Privileges: None

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The vCenter cluster

Since vSphere API Release 5.5

targetHosts*

ManagedObjectReference[]
to a HostSystem[]

Leave this unset

Since vSphere API Release 5.5

*Need not be set P Required privilege: Host.Config.Storage

Return Value

Type	Description
ManagedObjectReference to a Task	task vCenter Task to track the rebalance stop process. The task will be completed if all of hosts have stopped the rebalance

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanStopRebalanceCluster" type="vsan:VsanStopRebalanceClusterRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanStopRebalanceClusterResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanVcClusterGetHclInfo(getClusterHclInfo)

Fetch HCL information including the HCL DB status in general and all devices used by vSAN on all hosts in the cluster(if any).

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster* P	ManagedObjectReference to a ClusterComputeResource	The target vCenter cluster. Set to NULL if only intent to get the HCL DB status in general *Since* vSphere API Release 5.5
includeHostsResult*	xsd:boolean	True to include the HCL information for each of host in the cluster. *Since* vSphere API Release 5.5
includeVendorInfo*	xsd:boolean	Include the vendor tool information in the result *Since* vSphere API Release 5.5
esxRelease*	xsd:string	The ESXi release version which HCL is computed against *Since* vSphere API Release 5.5
querySpec*	VsanHclQuerySpec	*Since* vSphere API Release 5.5

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
VsanClusterHclInfo	The HCL information for the cluster

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcClusterGetHclInfo" type="vsan:VsanVcClusterGetHclInfoRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcClusterGetHclInfoResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterHclInfo"/>
                     </sequence>
                  </complexType>
               </element>

VsanVcClusterQueryVerifyHealthSystemVersions(queryVerifyClusterHealthSystemVersions)

Querying version information of vSAN health service installed on all the hosts in the cluster requested and vCenter Server. It will verify the consistency of the version numbers.

Required Privileges: None

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

cluster P

ManagedObjectReference
to a ClusterComputeResource

The target cluster

Since vSphere API Release 5.5

P Required privilege: System.Read

Return Value

Type	Description
VsanClusterHealthSystemVersionResult	The vSAN health service version

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcClusterQueryVerifyHealthSystemVersions" type="vsan:VsanVcClusterQueryVerifyHealthSystemVersionsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcClusterQueryVerifyHealthSystemVersionsResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanClusterHealthSystemVersionResult"/>
                     </sequence>
                  </complexType>
               </element>

VsanVcClusterRunVmdkLoadTest(runVmdkLoadTest)

Deprecated. As of vSphere API 6.7.

Run VMDK load test for the given duration second with the IO workload test parameter specifying in spec. The test includes three steps. Firstly, it will create VMDKs on each of cluster host, and then run the IO work test, at last, it will clean up the all of created VMDKs on each of host.Each of step can be run separately by specifying the parameter action. The default action "fullrun" will run all of three steps together Note: if this API is called directly on ESXi host, for any element of specs' vmdkCreateSpec.profile should be either unset or empty as SPBM is not available on ESXi host for profile conversion.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanVcClusterHealthSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	The target vCenter cluster. *Since* vSphere API Release 5.5
runname	xsd:string	The name for this test. *Since* vSphere API Release 5.5
durationSec*	xsd:int	The duration time for each of VMDK load test. *Since* vSphere API Release 5.5
specs*	VsanVmdkLoadTestSpec[]	*Since* vSphere API Release 5.5
action*	xsd:string	The possible actions are "prepare", "run" and "cleanup" and "fullrun". Default is "fullrun". *Since* vSphere API Release 5.5

*Need not be set P Required privilege: System.Read

Return Value

Type	Description
ManagedObjectReference to a Task	task VC Task.

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcClusterRunVmdkLoadTest" type="vsan:VsanVcClusterRunVmdkLoadTestRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcClusterRunVmdkLoadTestResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanVcUpdateHclDbFromWeb(updateHclDbFromWeb)

Downloads the HCL database from the VMware official website http://partnerweb.vmware.com/service/vsan/all.json. The DB will replace any existing DB, even if the existing DB may appear newer. Caller can supply a custom URL. If not provided, DB is downloaded from its standard location on vmware.com.

Required Privileges: Global.Settings

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

url*

xsd:string

The URL for downloading the HCL DB. Unset to use the official standard location on vmware.com

Since vSphere API Release 5.5

*Need not be set

Return Value

Type	Description
xsd:boolean	Always return True, or throw exception. False is never returned.

Faults

Type	Description
NotFound
NotSupported	Thrown if run directly on an ESX Server host.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcUpdateHclDbFromWeb" type="vsan:VsanVcUpdateHclDbFromWebRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcUpdateHclDbFromWebResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:boolean"/>
                     </sequence>
                  </complexType>
               </element>

VsanVcUploadHclDb(uploadHclDb)

Upload a DB file in JSON format. The DB will replace any existing DB, even if the existing DB may appear newer. The API at host level is for internal use.

Required Privileges: Global.Settings

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VsanVcClusterHealthSystem used to make the method call.

xsd:string

The new DB, in base64 encoded, gzipped JSON format

Since vSphere API Release 5.5

Return Value

Type	Description
xsd:boolean	Always return True, or throw exception. False is never returned.

Faults

Type	Description
NotFound
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcUploadHclDb" type="vsan:VsanVcUploadHclDbRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanVcUploadHclDbResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:boolean"/>
                     </sequence>
                  </complexType>
               </element>

vSAN Management API

Managed Object - VsanVcClusterHealthSystem(vim.cluster.VsanVcClusterHealthSystem)

Managed Object Description

SetVsanVcgMappingForHwDevices(setVsanVcgMappingForHwDevices)

VsanAttachVsanSupportBundleToSr(attachVsanSupportBundleToSr)

VsanClusterQueryFileServiceHealthSummary(queryFileServiceHealthSummary)

VsanDownloadAndInstallVendorTool_Task(downloadAndInstallVendorTool)

VsanDownloadHclFile_Task(downloadHclFile)

VsanGetDiskHclConstraints(getDiskHclConstraints)

VsanGetHclConstraints(getClusterHclConstraints)

VsanGetHclInfoForEligibleDisks(getHclInfoForVsanEligibleDisks)

VsanGetReleaseRecommendation(getClusterReleaseRecommendation)

VsanHealthGetVsanClusterSilentChecks(getVsanClusterSilentChecks)

VsanHealthIsRebalanceRunning(isRebalanceRunning)

VsanHealthQueryVsanClusterHealthCheckInterval(queryVsanClusterHealthCheckInterval)

VsanHealthQueryVsanClusterHealthConfig(queryVsanClusterHealthConfig)

VsanHealthQueryVsanProxyConfig(queryVsanProxyConfig)

VsanHealthRepairClusterObjectsImmediate(repairClusterObjectsImmediate)

VsanHealthSendVsanTelemetry(sendVsanTelemetry)

VsanHealthSetLogLevel(setLogLevel)

VsanHealthSetVsanClusterHealthCheckInterval(setVsanClusterHealthCheckInterval)

VsanHealthSetVsanClusterSilentChecks(setVsanClusterSilentChecks)

VsanHealthSetVsanClusterTelemetryConfig(setVsanClusterTelemetryConfig)

VsanHealthTestVsanClusterTelemetryProxy(testVsanClusterTelemetryProxy)

VsanHealthUpdateDefaultDSPolicyRecommendation(updateDefaultDSPolicyRecommendation)

VsanPurgeHclFiles(purgeHclFiles)

VsanQueryAllSupportedHealthChecks(queryAllSupportedHealthChecks)

VsanQueryAttachToSrHistory(queryAttachToSrHistory)

VsanQueryClusterHistoricalHealth(queryClusterHistoricalHealth)

VsanQueryVcClusterCreateVmHealthHistoryTest(queryClusterCreateVmHealthHistoryTest)

VsanQueryVcClusterCreateVmHealthTest(queryClusterCreateVmHealthTest)

VsanQueryVcClusterHealthSummary(queryClusterHealthSummary)

VsanQueryVcClusterHealthSummaryTask(queryClusterHealthSummaryTask)

VsanQueryVcClusterNetworkPerfHistoryTest(queryClusterNetworkPerfHistoryTest)

VsanQueryVcClusterNetworkPerfTask(queryClusterNetworkPerfTask)

VsanQueryVcClusterNetworkPerfTest(queryClusterNetworkPerfTest)

VsanQueryVcClusterObjExtAttrs(queryVsanObjExtAttrs)

VsanQueryVcClusterSmartStatsSummary(querySmartStatsSummary)

VsanQueryVcClusterVmdkLoadHistoryTest(queryClusterVmdkLoadHistoryTest)

VsanQueryVcClusterVmdkWorkloadTypes(queryClusterVmdkWorkloadTypes)

VsanRebalanceCluster(rebalanceCluster)

VsanStopRebalanceCluster(stopRebalanceCluster)

VsanVcClusterGetHclInfo(getClusterHclInfo)

VsanVcClusterQueryVerifyHealthSystemVersions(queryVerifyClusterHealthSystemVersions)

VsanVcClusterRunVmdkLoadTest(runVmdkLoadTest)

VsanVcUpdateHclDbFromWeb(updateHclDbFromWeb)

VsanVcUploadHclDb(uploadHclDb)