Files
deb-python-pyvmomi/docs/vim/host/VsanSystem.rst
2015-11-21 09:07:44 -07:00

7.3 KiB

vim.host.VsanSystem

The VsanSystem managed object type exposes VSAN configuration primitives and serves as a host-level access point for relevant VSAN data objects.

since

vSphere API 5.5

Attributes

config (vim.vsan.host.ConfigInfo):
privilege: System.Read

The current VSAN service configuration information for this host.

Methods

QueryDisksForVsan(canonicalName):

Queries disks on this host for suitability to use with the VSAN service, and returns the result.See vim.host.ScsiDisk#canonicalName

Privilege:

System.Read

Args:
canonicalName (str, optional):

may be set to restrict the query to the list of HostScsiDisk objects named by the given pathsSee vim.host.ScsiDisk#canonicalName

Returns:
[vim.vsan.host.DiskResult]:

a list of populated VsanHostDiskResult entries

AddDisks(disk):

Add the set of given disks for use by the VSAN service on this host. Users may use this API to manually add disks for use by VSAN, without specifying an explicit DiskMapping, when the VSAN service not configured to automatically claim storage. Any ineligible disk in the set of given disks and disks which would have exceeded the capacity will be ignored and will not be published in returned result .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 DiskMapping.See QueryDisksForVsan See autoClaimStorage

Privilege:

Host.Config.Storage

Args:
disk (vim.host.ScsiDisk):

list of disks to add for use by the VSAN serviceSee QueryDisksForVsan See autoClaimStorage

Returns:

vim.Task:

InitializeDisks(mapping):

Initialize and use the sets of disks in the given DiskMapping list for the VSAN service on this host. Users may use this API to specify or change disk mappings when the VSAN service is not configured to automatically claim storage. For appending new non-SSDs to an existing DiskMapping, users need to specify only the new non-SSDs with its DiskMapping#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 DiskMapping.See QueryDisksForVsan See autoClaimStorage

Privilege:

Host.Config.Storage

Args:
mapping (vim.vsan.host.DiskMapping):

list of disk mappings to initializeSee QueryDisksForVsan See autoClaimStorage

Returns:

vim.Task:

RemoveDisk(disk):

Remove the set of given disks from use by the VSAN service on this host. Users may use this API to manually remove a DiskMapping#nonSsd from a DiskMapping. This operation is only permitted if the VSAN service on this host is not configured to automatically claim storage.This method may not be used to remove the last DiskMapping#nonSsd from any given DiskMapping. Removal of the last DiskMapping#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 DiskMapping#nonSsd member of DiskMapping.See RemoveDiskMapping_Task See UpdateVsan_Task See autoClaimStorage

Privilege:

Host.Config.Storage

Args:
disk (vim.host.ScsiDisk):

list of disks to be removed from use by the VSAN service.See RemoveDiskMapping_Task See UpdateVsan_Task See autoClaimStorage

Returns:

vim.Task:

RemoveDiskMapping(mapping):

Delete given set of disk mappings from use by the VSAN service on this host. This API may be used to remove all disks in a given mapping, including its DiskMapping#ssd. This operation is only permitted if the VSAN service on this host is not configured to automatically claim storage.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

Privilege:

Host.Config.Storage

Args:
mapping (vim.vsan.host.DiskMapping):

list of disk mappings to be removed from VSAN usage.See RemoveDisk_Task See UpdateVsan_Task See autoClaimStorage

Returns:

vim.Task:

UpdateVsan_Task(config):

Update the VSAN service on this host according to the given host configuration specification.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

Privilege:

Host.Config.Storage

Args:
config (vim.vsan.host.ConfigInfo):

host configuration settings to use for the VSAN service.See VsanHostConfigInfo See storageInfo See clusterInfo See networkInfo See QueryDisksForVsan

Returns:

vim.Task:

QueryHostStatus():

Queries this host's current runtime status for the VSAN service.

Privilege:

System.Read

Args:

Returns:
vim.vsan.host.ClusterStatus:

a populated VsanHostClusterStatus entry