Managed Object - VsanRemoteDatastoreSystem(vim.cluster.VsanRemoteDatastoreSystem)

See also: ClusterComputeResource, Datastore, Task, VcRemoteVsanServerClusterInfo, VsanDatastoreSourcePrecheckResult, VsanHciMeshDatastoreSource, VsanMountPrecheckResult, VsanRemoteVcInfo, VsanXVCDatastoreInfo, VsanXvcQueryResultSet, VsanXvcQuerySpec
Since: vSAN API vSAN 7.0U1

Managed Object Description

The managed object provides support for vSAN remote datastore management operations. It can be accessed with MOID of 'vsan-remote-datastore-system', through vSAN service at vCenter server side.

Properties

Name	Type	Description
None

Methods

Methods defined in this Managed Object
MountPrecheck, RemoteVcMountPrecheck, VsanCreateDatastoreSource, VsanDestroyDatastoreSource, VsanPrecheckDatastoreSource, VsanQueryDatastoreSource, VsanQueryHciMeshDatastores, VsanUpdateDatastoreSource

MountPrecheck(mountPrecheck)

Checks mount compatibility of a vSAN datastore with given vSAN cluster. Get mount pre-check results of a client cluster and remote vSAN datastore. Different types of checks are needed, see VsanMountPrecheckResult for details.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VsanRemoteDatastoreSystem used to make the method call.
cluster P	ManagedObjectReference to a ClusterComputeResource	Client cluster that triggers the mount precheck request. *Since* vSAN API vSAN 7.0U1
datastore	ManagedObjectReference to a Datastore	The server vSAN datastore to be checked for mount. *Since* vSAN API vSAN 7.0U1
serverClusterInfo*	VcRemoteVsanServerClusterInfo	The server cluster information of the vSAN datastore to be checked for mount. It is only needed when the server cluster is a stretched cluster. *Since* vSAN API vSAN 7.0U1

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

Return Value

Type	Description
VsanMountPrecheckResult	Pre-check results of a client cluster mounting server vSAN datastore.

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="MountPrecheck" type="vsan:MountPrecheckRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="MountPrecheckResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanMountPrecheckResult"/>
                     </sequence>
                  </complexType>
               </element>

RemoteVcMountPrecheck(remoteVcMountPrecheck)

Checks mount compatibility of a cross VC vSAN datastore with given vSAN cluster. Get mount pre-check results of a client cluster and cross VC remote vSAN datastore. Different types of checks are needed, see VsanMountPrecheckResult for details.

Required Privileges: None
Since: vSAN API 8.0.0.2

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

cluster P

ManagedObjectReference
to a ClusterComputeResource

Client cluster that trigger the mount precheck request.

Since vSAN API 8.0.0.2

xvcDatastore

VsanXVCDatastoreInfo

Since vSAN API 8.0.0.2

P Required privilege: Host.Config.Storage

Return Value

Type	Description
VsanMountPrecheckResult	Pre-check results of a client cluster mounting cross VC vSAN datastore.

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	vSAN related faults.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="RemoteVcMountPrecheck" type="vsan:RemoteVcMountPrecheckRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="RemoteVcMountPrecheckResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanMountPrecheckResult"/>
                     </sequence>
                  </complexType>
               </element>

VsanCreateDatastoreSource(createDatastoreSource)

Create a new Datastore Source.

Required Privileges: Host.Config.Storage
Since: vSAN API 8.0.0.2

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

datastoreSource

VsanHciMeshDatastoreSource

The information of the Datastore Source to be created. If the vCenter is an ELM linked vCenter, only vcHost needs to be specified. For a standalone vCenter, the user and password needs to be specified for an user credential with the privileges to create the service account.

Since vSAN API 8.0.0.2

Return Value

Type	Description
ManagedObjectReference to a Task	The task for creating Datastore Source operation.

Faults

Type	Description
AlreadyExists	Thrown if the Datastore Source being created has existed.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault	Other vSAN related faults.
VsanSslVerifyCertFault	SSL verification fault for remote vCenter such as certificate not verified.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanCreateDatastoreSource" type="vsan:VsanCreateDatastoreSourceRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanCreateDatastoreSourceResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanDestroyDatastoreSource(destroyDatastoreSource)

Destroy an existing Datastore Source configuration.

Required Privileges: Host.Config.Storage
Since: vSAN API 8.0.0.2

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

datastoreSource

VsanHciMeshDatastoreSource

The Datastore Source to be destroyed. If the vCenter is an ELM linked vCenter, only vcHost needs to be specified. For a standalone vCenter, the user and password needs to be specified for an user credential with the privileges to delete the service account.

Since vSAN API 8.0.0.2

Return Value

Type	Description
ManagedObjectReference to a Task	The task for destroying Datastore Source operation.

Faults

Type	Description
NotFound	The specified Datastore Source is not found.
ResourceInUse	The specified Datastore Source still has datastores being mounted.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault	Other vSAN related faults.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanDestroyDatastoreSource" type="vsan:VsanDestroyDatastoreSourceRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanDestroyDatastoreSourceResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>

VsanPrecheckDatastoreSource(precheckDatastoreSource)

Run prechecks for a Datastore Source. This can be used before creating, updating, destroying a Datastore Source or other places needing to verify a Datastore Source.

Required Privileges: Host.Config.Storage
Since: vSAN API 8.0.0.2

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

datastoreSource

VsanHciMeshDatastoreSource

The information of the Datastore Source to be prechecked.

Since vSAN API 8.0.0.2

operation*

xsd:string

The hint of the operation which the precheck is performed against, see PrecheckDatastoreSourceOperation.

Since vSAN API 8.0.0.2

*Need not be set

Return Value

Type	Description
VsanDatastoreSourcePrecheckResult	Pre-check results of the specified Datastore Source.

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	Other vSAN related faults.
VsanSslVerifyCertFault	SSL verification fault for remote vCenter such as certificate not verified.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanPrecheckDatastoreSource" type="vsan:VsanPrecheckDatastoreSourceRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanPrecheckDatastoreSourceResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanDatastoreSourcePrecheckResult"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryDatastoreSource(queryDatastoreSource)

Query Datastore Source information for specified remote vCenters. If no vCenter is specified, all Datastore Sources configured are returned.

Required Privileges: System.Read
Since: vSAN API 8.0.0.2

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

vcHosts*

xsd:string[]

The names (e.g. FQDNs) of the remote vCenters to be queried. Only those names configured through vim.cluster.VsanRemoteDatastoreSystem#CreateDatastoreSource are valid to be used.

Since vSAN API 8.0.0.2

*Need not be set

Return Value

Type	Description
VsanHciMeshDatastoreSource[]	The Datastore Sources information queried.

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	vSAN related faults.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryDatastoreSource" type="vsan:VsanQueryDatastoreSourceRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryDatastoreSourceResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanHciMeshDatastoreSource" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanQueryHciMeshDatastores(queryHciMeshDatastores)

This method takes a list of VsanXvcQuerySpec, then returns a list of VsanXvcQueryResultSet. Each element of returned VsanXvcQueryResultSet list maps to the query spec in the VsanXvcQuerySpec list by index. Caller can provide a proper VsanXvcQuerySpec, and specify the required properties to be returned. The full list of the properties for each kind of returned object is described in VsanXvcQueryResultSet. Optionally, user can provide a list of remote VCs' information VsanRemoteVcInfo to specify the remote VC to query. The supported objects are listed in objectModel. Each item is one datastore's info mapping to the specified properties properties in spec.

Required Privileges: System.Read
Since: vSAN API 8.0.0.2

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

querySpecs*

VsanXvcQuerySpec[]

The spec information to specify what to be queried.

Since vSAN API 8.0.0.2

extraVcInfos*

VsanRemoteVcInfo[]

The remote vCenter information for communication if caller needs to explicitly specify a remote vCenter as a provider vCenter which is not configured as a Datastore Source configuration. The user credential needs to be provided in the remote vCenter information, e.g., use VsanRemoteVcInfoStandalone.

Since vSAN API 8.0.0.2

*Need not be set

Return Value

Type	Description
VsanXvcQueryResultSet[]	The query result information per the query specs.

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	vSAN related faults.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryHciMeshDatastores" type="vsan:VsanQueryHciMeshDatastoresRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryHciMeshDatastoresResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:VsanXvcQueryResultSet" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

VsanUpdateDatastoreSource(updateDatastoreSource)

Update the configuration of an existing Datastore Source.

Required Privileges: Host.Config.Storage
Since: vSAN API 8.0.0.2

Parameters

Name

Type

Description

_this

ManagedObjectReference

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

datastoreSource

VsanHciMeshDatastoreSource

The information of the Datastore Source to be updated. The updated Datastore Source is identified by the vcHost specified in the remote vCenter info of this param. If the original or updated vCenter is a standalone vCenter, the user and password needs to be specified for an user credential with the privilege to update the service account. If both original and updated vCenters are ELM vCenters only vcHost needs to be specified.

Since vSAN API 8.0.0.2

Return Value

Type	Description
ManagedObjectReference to a Task	The task for updating Datastore Source operation.

Faults

Type	Description
NotFound	The specified Datastore Source 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.
VsanFault	Other vSAN related faults.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanUpdateDatastoreSource" type="vsan:VsanUpdateDatastoreSourceRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanUpdateDatastoreSourceResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vsan:ManagedObjectReference"/>
                     </sequence>
                  </complexType>
               </element>