Managed Object - VsanSystemEx(vim.host.VsanSystemEx)

See also: HostMaintenanceSpec, Task, VsanHostAboutInfoEx, VsanHostDiskMapping, VsanHostDrsStats, VsanHostRuntimeStats, VsanHostVsanObjectSyncQueryResult, VsanWhatIfEvacResult
Since: vSphere API 6.5

Managed Object Description

This managed object provides extended APIs to enrich HostVsanSystem's functionality, operating at a single ESXi host level. HostVsanSystem is still valid and provided by vSphere Management SDK. HostVsanSystem and VsanSystemEx should be used in combination for different operations to vSAN. It can be accessed with MOID of 'vsanSystemEx' through vSAN service at ESXi host side. It can be also accessed with MOID of 'vsanSystemEx-' through vSAN service at vCenter server side, where is the ID at the end of the host's MOID: 'host-'. For example, if a host's MOID is 'host-5', then 'vsanSystemEx-5' should be used to access this host's VsanSystemEx MO.

Properties

Name	Type	Description
None

Methods

Methods defined in this Managed Object
VsanGetAboutInfoEx, VsanHostGetRuntimeStats, VsanQueryHostDrsStats, VsanQuerySyncingVsanObjects, VsanQueryWhatIfEvacuationResult, VsanUnmountDiskMappingEx

VsanGetAboutInfoEx(getAboutInfoEx)

Query system information of ESXi such as name, type, version, build type and build number.

Required Privileges: System.Read
Since: vSAN API 6.6

Parameters

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

Return Value

Type	Description
VsanHostAboutInfoEx	VsanAboutInfoEx

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="VsanGetAboutInfoEx" type="vsan:VsanGetAboutInfoExRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetAboutInfoExResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vsan:VsanHostAboutInfoEx"/>
               </sequence>
            </complexType>
         </element>

VsanHostGetRuntimeStats(getRuntimeStats)

Get vSAN runtime stats of vSAN host. This API is used to retrieve host's vSAN runtime stats. It bases on specified stats type list, to retrieve expected vSAN runtime stats.

Required Privileges: System.Read
Since: vSAN API 6.6

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

stats*

xsd:string[]

List of vSAN runtime stats type. Supported vSAN runtime stats types are declared in VsanHostStatsType. If this parameter is omitted, all supported runtime stats will be collected and returned.

Since vSAN API 6.6

*Need not be set

Return Value

Type	Description
VsanHostRuntimeStats	vim.vsan.host.RuntimeStats

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="VsanHostGetRuntimeStats" type="vsan:VsanHostGetRuntimeStatsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanHostGetRuntimeStatsResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vsan:VsanHostRuntimeStats"/>
               </sequence>
            </complexType>
         </element>

VsanQueryHostDrsStats(queryHostDrsStats)

Query vSAN DRS stats of this host and all vSAN VMs registered on this host.

Required Privileges: System.Read
Since: vSAN API VMC M5

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

hostUuids

xsd:string[]

Indicates sorted list of vSAN member host Uuid. It is used to determine the full set of vSAN member hosts and the sequence to organize vSAN VM stats.

vms*

xsd:string[]

List of VM instance UUID. If specified, only stats of given VMs will be returned, otherwise all vSAN VMs registered on this host will be involved if this parameter is omitted. By default template VM will be ignored unless it is specified by this paramter.

Since vSAN API VMC M5

*Need not be set

Return Value

Type	Description
VsanHostDrsStats	VsanHostDrsStats

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="VsanQueryHostDrsStats" type="vsan:VsanQueryHostDrsStatsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryHostDrsStatsResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vsan:VsanHostDrsStats"/>
               </sequence>
            </complexType>
         </element>

VsanQuerySyncingVsanObjects(querySyncingVsanObjects)

Query information about vSAN objects that are currently syncing data. It will retrieve information about syncing objects based on query options.

Required Privileges: System.Read
Since: vSAN API 6.7

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanSystemEx used to make the method call.
uuids*	xsd:string[]	Restricts the list of object identities to query. *Since* vSAN API 6.7
start*	xsd:int	Indicates the number of objects to be skipped when returns query results. A value less than 0 is illegal. Default: 0. *Since* vSAN API 6.7
limit*	xsd:int	Restricts the max number of objects to return. Valid value is from 0 to 200. A value less than 0 is illegal, 0 is valid only when "includeSummary" is true. Default: 100. *Since* vSAN API 6.7
includeSummary*	xsd:boolean	Indicates whether to return summary data in query result. Default: True. *Since* vSAN API 6.7

*Need not be set

Return Value

Type	Description
VsanHostVsanObjectSyncQueryResult	vim.vsan.host.VsanSyncingObjectQueryResult.

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="VsanQuerySyncingVsanObjects" type="vsan:VsanQuerySyncingVsanObjectsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQuerySyncingVsanObjectsResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vsan:VsanHostVsanObjectSyncQueryResult"/>
               </sequence>
            </complexType>
         </element>

VsanQueryWhatIfEvacuationResult(queryWhatIfEvacuationResult)

Query what it takes for an entity(disk group or host) to be evacuated in various modes. Only account for capacity usage when it determines if an entity can be evacuated in a given mode. Note that this means all other considerations such as fault domain, number of spindles or read cache are ignored and the API will only verify if the cluster has enough capacity to accommodate the affected objects in a specified mode.

Required Privileges: System.Read
Since: vSAN API 6.6

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanSystemEx used to make the method call.
evacEntityUuid	xsd:string	The entity UUID which will be evacuated. It can be an UUID of disk, disk group or host.

Return Value

Type	Description
VsanWhatIfEvacResult	WhatIfEvacResult which indicate whether the evacuation can be done in current cluster state and specified evacuation mode. If so, this API returns what objects would lose liveness or compliance. Or on the other hand, if the given entity cannot be evacuated, API returns many extra resources needed to satisfy this operation.

Faults

Type	Description
NotImplemented
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="VsanQueryWhatIfEvacuationResult" type="vsan:VsanQueryWhatIfEvacuationResultRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryWhatIfEvacuationResultResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vsan:VsanWhatIfEvacResult"/>
               </sequence>
            </complexType>
         </element>

VsanUnmountDiskMappingEx(unmountDiskMappingEx)

Unmount vSAN diskgroup, which stops using specified vSAN diskgroup for any vSAN I/O without destroying it. This API extended and deprecated UnmountDiskMapping_Task, added vSAN data migration support, to provide data protection during the process. Without data migration, for vSAN data which is not configured with redundancy (policy hostFailureToTolerate=0), or in incompliant state (data redundancy reduced when policy hostFailureToTolerate>0), its accessibility could be broken after diskgroup unmounted.

Required Privileges: Host.Config.Storage
Since: vSAN API VMC M5

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanSystemEx used to make the method call.
mappings	VsanHostDiskMapping[]	List of diskgroups to be unmounted.
maintenanceSpec*	HostMaintenanceSpec	Any additional actions to move data out of the diskgroup before unmounting it. See HostMaintenanceSpec. If unspecified, there is no action taken to move data from the diskgroup. *Since* vSAN API VMC M5
timeout*	xsd:int	Time to wait for the task to complete in seconds. If the value is less than or equal to zero, there is no timeout. The operation fails with a Timedout exception if it timed out. *Since* vSAN API VMC M5

*Need not be set

Return Value

Type	Description
ManagedObjectReference to a Task	Task to track the diskrgoup unmounting process.

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

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanUnmountDiskMappingEx" type="vsan:VsanUnmountDiskMappingExRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanUnmountDiskMappingExResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vsan:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>