| Local Properties | Local Methods | |
Managed Object Types | Data Object Types | All Properties | All Methods |
Properties
Name | Type | Description |
---|---|---|
config P | VsanHostConfigInfo |
The current VSAN service configuration information for this host.
|
Methods
Methods defined in this Managed Object |
---|
AddDisks_Task, EvacuateVsanNode_Task, InitializeDisks_Task, QueryDisksForVsan, QueryHostStatus, RecommissionVsanNode_Task, RemoveDisk_Task, RemoveDiskMapping_Task, UnmountDiskMapping_Task, UpdateVsan_Task |
Mount a VsanHostDiskMapping if the specified disk belongs to the unmounted mapping and is of type ssd.
Upon successful completion of the returned Task, its
result field will be populated with a
VsanHostDiskMapResult[] and caller must inspect
VsanHostDiskMapResult[] to check result for individual
VsanHostDiskMapping.
See QueryDisksForVsan
See autoClaimStorage
See mounted
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
disk P | HostScsiDisk[] |
list of disks to add for use by the VSAN service See QueryDisksForVsan See autoClaimStorage See mounted Since vSphere API 5.5 |
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. |
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 |
The task is cancellable.
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
maintenanceSpec P | HostMaintenanceSpec |
Specifies the data evacuation mode. See HostMaintenanceSpec.
If unspecified, the default mode chosen will be
vim.vsan.host.DecommissionMode.ObjectAction#ensureObjectAccessibility.
Since vSphere API 6.0 |
timeout P | 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 vSphere API 6.0 |
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. |
Faults
Type | Description |
---|---|
InvalidState | Thrown if the host is entering maintenance mode or evacuating data. |
RequestCanceled | Thrown if the operation is canceled. |
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error. |
Timedout | Thrown if the operation timed out. |
VsanFault | Thrown if operation fails with VSAN-specific error. |
Events
Type | |
---|---|
None |
Mount a VsanHostDiskMapping if the specified VsanHostDiskMapping is not mounted in this host.
Upon successful completion of the returned Task, its
result field will be populated with a
VsanHostDiskMapResult[] and caller must inspect
VsanHostDiskMapResult[] to check result for individual
VsanHostDiskMapping.
See QueryDisksForVsan
See autoClaimStorage
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
mapping P | VsanHostDiskMapping[] |
list of disk mappings to initialize See QueryDisksForVsan See autoClaimStorage Since vSphere API 5.5 |
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. |
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 |
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
canonicalName* P | xsd:string[] |
may be set to restrict the query to the list of
HostScsiDisk objects named by the
given paths See vim.host.ScsiDisk#canonicalName Since vSphere API 5.5 |
Return Value
Type | Description |
---|---|
VsanHostDiskResult[] | A list of populated VsanHostDiskResult entries |
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 |
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
Return Value
Type | Description |
---|---|
VsanHostClusterStatus | A populated VsanHostClusterStatus entry |
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 |
Users may use this API to recommission a node that has been
evacuated in VsanHostDecommissionMode.
See EvacuateVsanNode_Task
See VsanHostDecommissionMode
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. |
Faults
Type | Description |
---|---|
InvalidState | Thrown if the host is not evacuated. See EvacuateVsanNode_Task See VsanHostDecommissionMode |
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 operation fails with VSAN-specific error. See EvacuateVsanNode_Task See VsanHostDecommissionMode |
Events
Type | |
---|---|
None |
The task is cancellable.
This method may not be used to remove the last nonSsd from any given VsanHostDiskMapping. Removal of the last nonSsd can be accomplished by using RemoveDiskMapping_Task.
Upon successful completion of the returned Task, its
result field will be populated with a
VsanHostDiskResult[]. Sets DiskIsLastRemainingNonSSD fault
in returned task if specified disk is the last
nonSsd member of
VsanHostDiskMapping.
See RemoveDiskMapping_Task
See UpdateVsan_Task
See autoClaimStorage
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
disk P | HostScsiDisk[] |
list of disks to be removed from use by the VSAN service. See RemoveDiskMapping_Task See UpdateVsan_Task See autoClaimStorage Since vSphere API 5.5 |
maintenanceSpec* P | HostMaintenanceSpec |
Any additional actions to move data out of the disk
before removing it. See HostMaintenanceSpec.
If unspecified, there is no action taken to move
data from the disk. See RemoveDiskMapping_Task See UpdateVsan_Task See autoClaimStorage Since vSphere API 5.5 |
timeout* P | 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. See RemoveDiskMapping_Task See UpdateVsan_Task See autoClaimStorage Since vSphere API 5.5 |
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. |
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 |
The task is cancellable.
Upon successful completion of the returned Task, its
result field will be populated with an empty
VsanHostDiskMapResult[]. If any errors are encountered,
the returned field will instead contain populated error information.
See RemoveDisk_Task
See UpdateVsan_Task
See autoClaimStorage
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
mapping P | VsanHostDiskMapping[] |
list of disk mappings to be removed from VSAN usage. See RemoveDisk_Task See UpdateVsan_Task See autoClaimStorage Since vSphere API 5.5 |
maintenanceSpec* P | HostMaintenanceSpec |
Any additional actions to move data out of the disk
before removing it. See HostMaintenanceSpec.
If unspecified, there is no action taken to move
data from the disk. See RemoveDisk_Task See UpdateVsan_Task See autoClaimStorage Since vSphere API 5.5 |
timeout* P | 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. See RemoveDisk_Task See UpdateVsan_Task See autoClaimStorage Since vSphere API 5.5 |
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. |
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 |
In case of shared-SAS, where diskMappings are visible to more than one VSAN hosts, Users may use this API to manually unmount and re-mount diskMappings.
Upon successful completion of the returned Task, its
result field will be populated with
VsanHostDiskMapResult[]. If any errors are encountered,
the returned field will instead contain populated error information.
See RemoveDiskMapping_Task
See AddDisks_Task
See InitializeDisks_Task
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
mapping P | VsanHostDiskMapping[] |
See RemoveDiskMapping_Task See AddDisks_Task See InitializeDisks_Task Since vSphere API 6.0 |
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. |
Faults
Type | Description |
---|---|
InvalidState | Thrown if the VsanHostDiskMapping is already unmounted. See RemoveDiskMapping_Task See AddDisks_Task See InitializeDisks_Task |
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 operation fails with VSAN-specific error. See RemoveDiskMapping_Task See AddDisks_Task See InitializeDisks_Task |
Events
Type | |
---|---|
None |
Enabling and disabling the VSAN service can be achieved by using
the enabled flag.
Host storage settings can be specified through use of
storageInfo. If this value is omitted,
changes will not be made to the existing storage configuration.
Host cluster settings can be specified through use of
clusterInfo. If this value is omitted,
changes will not be made to the existing cluster configuration.
Host network settings can be specified through use of
networkInfo. If this value is omitted,
changes will not be made to the existing network configuration.
See VsanHostConfigInfo
See storageInfo
See clusterInfo
See networkInfo
See QueryDisksForVsan
Parameters
Name | Type | Description |
---|---|---|
_this | ManagedObjectReference | A reference to the HostVsanSystem used to make the method call. |
config P | VsanHostConfigInfo |
host configuration settings to use for the VSAN service. See VsanHostConfigInfo See storageInfo See clusterInfo See networkInfo See QueryDisksForVsan Since vSphere API 5.5 |
Return Value
Type | Description |
---|---|
ManagedObjectReference
to a Task | This method returns a Task object with which to monitor the operation. |
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 |
Top of page | Local Properties | Local Methods | |
Managed Object Types | Data Object Types | All Properties | All Methods |