Managed Object - VimClusterVsanVcStretchedClusterSystem(vim.cluster.VsanVcStretchedClusterSystem)

See also: ClusterComputeResource, HostSystem, Task, VimClusterVSANPreferredFaultDomainInfo, VimClusterVSANStretchedClusterCapability, VimClusterVSANStretchedClusterFaultDomainConfig, VimClusterVSANWitnessHostInfo, VsanHostDiskMapping
Since: vSphere API 6.0

Managed Object Description

Virtual SAN stretched Cluster is a specific configuration implemented in environments where disaster/downtime avoidance is a key requirement. Virtual SAN stretched Clusters with Witness Host refers to a deployment where a user sets up a Virtual SAN cluster with 2 active/active sites with numbers of ESXi hosts between the two sites. The sites are connected via a high bandwidth/low latency link. The third site hosting the Virtual SAN Witness Host is connected to both of the active/active data-sites. This connectivity can be via low bandwidth/high latency links. Each site is configured as a Virtual SAN Fault Domain. The nomenclature used to describe a Virtual SAN stretched Cluster configuration is X+Y+Z, where X is the number of ESXi hosts at data site A, Y is the number of ESXi hosts at data site B, and Z is the number of witness hosts at site C. Data sites are where virtual machines are deployed. The maximum configuration is 15+15+1 (31 nodes). Virtual SAN Remote Office / Branch Office Deployment, aka ROBO cluster, is a specific deployment of Virtual SAN stretched cluster. A two-node Virtual SAN cluster, and a vSphere Virtual SAN witness host appliance as witness, forms a Virtual SAN ROBO cluster. Copies of Virtual SAN objects that make up a virtual machine are typically stored in two physical nodes, if one of the physical nodes is offline, it is still possible for virtual machines to run using the files located on another physical node. In the case where the hosts in a two-node cluster are unable to communicate across the network, the witness serves as a "tie-breaker" to achieve a quorum and enables the cluster to restart virtual machines impacted by an outage. Details to deploy a Virtual SAN stretched cluster, please reference to API VSANVcConvertToStretchedCluster, and for ROBO cluster, please assign witness appliance to parameter 'witnessHost', and each physical host stands for a Fault Domain. VsanVcStretchedClusterSystem is used to configure and manage Virtual SAN stretched cluster. The ManagedEntity can be accessed through MOID of vsan-stretched-cluster-system, through Virtual SAN service at vCenter server side.

Properties

Name	Type	Description
None

Methods

Methods defined in this Managed Object
VSANVcConvertToStretchedCluster, VSANVcGetPreferredFaultDomain, VSANVcGetWitnessHosts, VSANVcIsWitnessHost, VSANVcRemoveWitnessHost, VSANVcRetrieveStretchedClusterVcCapability, VSANVcSetPreferredFaultDomain

VSANVcConvertToStretchedCluster(convertToStretchedCluster)

This API is used to convert a traditional Virtual SAN cluster to Virtual SAN stretched cluster. It will help to: 1. configure Virtual SAN cluster into two sites through Virtual SAN Fault Domain setting; 2. add witness host and configure unicast communication at cluster wide; 3. setup preferred Fault Domain; 4. create Virtual SAN disk group on witness host if auto-claim is not enabled on witness host; Relative to API VSANVcAddWitnessHost, it not only takes care of setting up witness host, but also help on Virtual SAN sites configuration, to guarentee the Virtual SAN cluster works in stretched mode. Virtual SAN cluster already works in stretched mode, is not supported by this API.

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VimClusterVsanVcStretchedClusterSystem used to make the method call.
cluster	ManagedObjectReference to a ClusterComputeResource	The target cluster to be converted; It is expected to enable Virtual SAN, but not a Virtual SAN stretched cluster;
faultDomainConfig	VimClusterVSANStretchedClusterFaultDomainConfig	The mapping between Fault Domain and Virtual SAN hosts reside in target cluster, to decide how to conifgure Virtual SAN cluster into two sites;
witnessHost	ManagedObjectReference to a HostSystem	The witness host to be added into Virtual SAN cluster. This host must be connected and managed by the same vCenter server, and cannot be a part of target cluster;
preferredFd	xsd:string	The name of preferred Fault Domain;
diskMapping*	VsanHostDiskMapping	The diskMapping to be created on witness host. If disk claim is configured as auto-mode on witness host, this parameter is not required. *Since* vSphere API 6.0

*Need not be set

Return Value

Type	Description
ManagedObjectReference to a Task	vim.Task

Faults

Type	Description
InvalidArgument
InvalidState
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:vim25="urn:vim25" name="VSANVcConvertToStretchedCluster" type="vim25:VSANVcConvertToStretchedClusterRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VSANVcConvertToStretchedClusterResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>

VSANVcGetPreferredFaultDomain(getPreferredFaultDomain)

Query configuration of preferred Fault Domain of specified cluster.

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VimClusterVsanVcStretchedClusterSystem used to make the method call.
cluster	ManagedObjectReference to a ClusterComputeResource	Target cluster to query.

Return Value

Type	Description
VimClusterVSANPreferredFaultDomainInfo	VSANPreferredFaultDomainInfo which contains preferred Fault Domain's user friendly name and UUID. If specified cluster is not Virtual SAN stretched cluster, both fields will be unset.

Faults

Type	Description
InvalidState
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:vim25="urn:vim25" name="VSANVcGetPreferredFaultDomain" type="vim25:VSANVcGetPreferredFaultDomainRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VSANVcGetPreferredFaultDomainResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:VimClusterVSANPreferredFaultDomainInfo" minOccurs="0"/>
               </sequence>
            </complexType>
         </element>

VSANVcGetWitnessHosts(getWitnessHosts)

Query witness host configuration of specified cluster.

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VimClusterVsanVcStretchedClusterSystem used to make the method call.
cluster	ManagedObjectReference to a ClusterComputeResource	The target cluster to query;

Return Value

Type	Description
VimClusterVSANWitnessHostInfo[]	VSANWitnessHostInfo[] which contains witness host's UUID, ManagedEntity instance, preferred Fault Domain's user friendly name and UUID, IP address of unicast agent, and name of the Fault Domain that witness host resides in. If specified cluster in Virtual SAN stretched cluster, all fields above will be set to actual setting, otherwise all fields will be unset.

Faults

Type	Description
InvalidState
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:vim25="urn:vim25" name="VSANVcGetWitnessHosts" type="vim25:VSANVcGetWitnessHostsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VSANVcGetWitnessHostsResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:VimClusterVSANWitnessHostInfo" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

VSANVcIsWitnessHost(isWitnessHost)

Check whether specified host is a witness host.

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VimClusterVsanVcStretchedClusterSystem used to make the method call.
host	ManagedObjectReference to a HostSystem	The target host to check.

Return Value

Type	Description
xsd:boolean	true is host is a witness host, false is host is not a witness host.

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:vim25="urn:vim25" name="VSANVcIsWitnessHost" type="vim25:VSANVcIsWitnessHostRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VSANVcIsWitnessHostResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="xsd:boolean"/>
               </sequence>
            </complexType>
         </element>

VSANVcRemoveWitnessHost(removeWitnessHost)

Remove witness host from the Virtual SAN stretched cluster to disable Virtual SAN stretched cluster. Detailed changes will happen on target cluster: 1. Virtual SAN on witness host will be disabled; 2. Unicast agent setting will be removed from all data hosts in specified Virtual SAN stretched cluster; Original Fault Domains for both two sites will be kept, and Virtual SAN is still enabled on all data hosts.

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VimClusterVsanVcStretchedClusterSystem used to make the method call.
cluster	ManagedObjectReference to a ClusterComputeResource	The target cluster to disable;
witnessHost*	ManagedObjectReference to a HostSystem	*Since* vSphere API 6.0
witnessAddress*	xsd:string	*Since* vSphere API 6.0

*Need not be set

Return Value

Type	Description
ManagedObjectReference to a Task	vim.Task

Faults

Type	Description
InvalidArgument
InvalidState
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:vim25="urn:vim25" name="VSANVcRemoveWitnessHost" type="vim25:VSANVcRemoveWitnessHostRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VSANVcRemoveWitnessHostResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>

VSANVcRetrieveStretchedClusterVcCapability(retrieveStretchedClusterVcCapability)

Query hosts' capabilities of supporting Virtual SAN stretched cluster, which reside in specified cluster, to decide whether specified cluster supports Virtual SAN stretched cluster feature. It could be used for any cluster, but only when all hosts reside in target cluster can support Virtual SAN stretched cluster, it can be converted to Virtual SAN stretched cluster.

Required Privileges: System.Read

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

cluster

ManagedObjectReference
to a ClusterComputeResource

The target cluster to query;

verifyAllConnected*

xsd:boolean

Since vSphere API 6.0

*Need not be set

Return Value

Type	Description
VimClusterVSANStretchedClusterCapability[]	List of VSANStretchedClusterCapability, to present whether each host can support Virtual SAN stretched cluster.

Faults

Type	Description
InvalidState
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:vim25="urn:vim25" name="VSANVcRetrieveStretchedClusterVcCapability" type="vim25:VSANVcRetrieveStretchedClusterVcCapabilityRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VSANVcRetrieveStretchedClusterVcCapabilityResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:VimClusterVSANStretchedClusterCapability" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

VSANVcSetPreferredFaultDomain(setPreferredFaultDomain)

Set preferred Fault Domain for a Virtual SAN stretched cluster. This API could set/reconfigure preferred Fault Domain setting.

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VimClusterVsanVcStretchedClusterSystem used to make the method call.
cluster	ManagedObjectReference to a ClusterComputeResource	Target Virtual SAN stretched cluster;
preferredFd	xsd:string	The user friendly name of preferred Fault Domain;
witnessHost*	ManagedObjectReference to a HostSystem	*Since* vSphere API 6.0

*Need not be set

Return Value

Type	Description
ManagedObjectReference to a Task	vim.Task

Faults

Type	Description
InvalidState
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:vim25="urn:vim25" name="VSANVcSetPreferredFaultDomain" type="vim25:VSANVcSetPreferredFaultDomainRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VSANVcSetPreferredFaultDomainResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>