Managed Object - HostStorageSystem

Property of
HostConfigManager
Extends
ExtensibleManagedObject
See also
HostDiskPartitionInfo, HostDiskPartitionLayout, HostDiskPartitionSpec, HostFileSystemVolumeInfo, HostInternetScsiHbaAuthenticationProperties, HostInternetScsiHbaDiscoveryProperties, HostInternetScsiHbaIPProperties, HostInternetScsiHbaSendTarget, HostInternetScsiHbaStaticTarget, HostMultipathInfoLogicalUnitPolicy, HostScsiDiskPartition, HostStorageDeviceInfo, HostVmfsSpec, HostVmfsVolume


Managed Object Description

This managed object gets and sets configuration information about the host's storage subsystem. The properties and operations are used to configure the host to make storage available for virtual machines. This object contains properties that are specific to ESX Server and general to both the ESX Server system and the hosted architecture.

Properties

Name Type Description
fileSystemVolumeInfoHostFileSystemVolumeInfo

File system volume information for the host. See the FileSystemVolumeInfo data object type for more information.
storageDeviceInfo*HostStorageDeviceInfo

Host storage information up to the device level.
Properties inherited from ExtensibleManagedObject
availableField, value
*May not be present

Methods

Methods defined in this Managed Object
AddInternetScsiSendTargets, AddInternetScsiStaticTargets, AttachVmfsExtent, ComputeDiskPartitionInfo, DisableMultipathPath, EnableMultipathPath, FormatVmfs, RefreshStorageSystem, RemoveInternetScsiSendTargets, RemoveInternetScsiStaticTargets, RescanAllHba, RescanHba, RescanVmfs, RetrieveDiskPartitionInfo, SetMultipathLunPolicy, UpdateDiskPartitions, UpdateInternetScsiAlias, UpdateInternetScsiAuthenticationProperties, UpdateInternetScsiDiscoveryProperties, UpdateInternetScsiIPProperties, UpdateInternetScsiName, UpdateSoftwareInternetScsiEnabled, UpgradeVmfs, UpgradeVmLayout
Methods inherited from ExtensibleManagedObject
setCustomValue

AddInternetScsiSendTargets

Adds Send Target entries to the host bus adapter discovery list. The DiscoveryProperties.sendTargetsDiscoveryEnabled flag must be set to true.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
iScsiHbaDevicexsd:string

The device of the Internet SCSI HBA adapter.
targetsHostInternetScsiHbaSendTarget[]

An array of iSCSI send targets.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the discovery list could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



AddInternetScsiStaticTargets

Adds Static Target entries to the host bus adapter discovery list. The DiscoveryProperty.staticTargetDiscoveryEnabled must be set to true.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
iScsiHbaDevicexsd:string

The device of the Internet SCSI HBA adapter.
targetsHostInternetScsiHbaStaticTarget[]

An array of iSCSI static targets to add.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the host bus adaptor discovery list was not found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



AttachVmfsExtent

Extends a VMFS by attaching a disk partition as an extent.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
vmfsPathxsd:string

The path of the VMFS to extend. See FileSystemMountInfo.
extentHostScsiDiskPartition

A data object that describes the specification of a Disk partition.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
InvalidArgumentThrown if the new extent is already used by another vmfs volume, does not exist, or is of an invalid partition type.
NotFoundThrown if the VMFS cannot be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



ComputeDiskPartitionInfo

Computes the disk partition information given the desired disk layout. The server computes a new partition information object for a specific disk representing the desired layout.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
devicePathxsd:string

The name of the device path for the specific disk.
layoutHostDiskPartitionLayout

A data object that describes the disk partition layout.

Return Value

Type Description
HostDiskPartitionInfoA data object that contains information about the partitions on a disk

Faults

Type Description
HostConfigFaultThrown if unable to get the current partition information for the device.
InvalidArgumentThrown if the layout is invalid.
NotFoundThrown if the device could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



DisableMultipathPath

Disables an enabled path for a Logical Unit. Use the path name from HostMultipathInfoPath.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
pathNamexsd:string

The name of the path to disable.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the LUN could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



EnableMultipathPath

Enables a disabled path for a Logical Unit. Use the path name from HostMultipathInfoPath.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
pathNamexsd:string

The name of the path to enable.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the LUN could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



FormatVmfs

Formats a new VMFS on a disk partition.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
createSpecHostVmfsSpec

A data object that describes the VMware File System (VMFS) creation specification.

Return Value

Type Description
HostVmfsVolumeA data object that represents the VMFS file system.

Faults

Type Description
AlreadyExistsThrown if the volume name is already being used by another volume on the host.
HostConfigFaultThrown for all other configuration failures.
InvalidArgumentThrown if VMFS version specified is not 2 or 3, if blocksize, lock mode, or volume label are invalid, the partition does not exist or is of an invalid type.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



RefreshStorageSystem

Refresh the storage information and settings to pick up any changes that might have occurred.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.

Return Value

Type Description
None

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



RemoveInternetScsiSendTargets

Removes Send Target entries from the host bus adapter discovery list. The DiscoveryProperty.sendTargetsDiscoveryEnabled must be set to true. If any of the targets provided as parameters are not found in the existing list, the other targets are removed and an exception is thrown.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
iScsiHbaDevicexsd:string

The device of the Internet SCSI HBA adapter.
targetsHostInternetScsiHbaSendTarget[]

An array of iSCSI send targets to remove.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if at least one target was not found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



RemoveInternetScsiStaticTargets

Removes static target entries from the host bus adapter discovery list. The DiscoveryProperty.staticTargetDiscoveryEnabled must be set to true. If any of the targets provided as parameters are not found in the existing list, the other targets are removed and an exception is thrown.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
iScsiHbaDevicexsd:string

The device of the Internet SCSI HBA adapter.
targetsHostInternetScsiHbaStaticTarget[]

An array of iSCSI static targets to remove.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if at least one target was not found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



RescanAllHba

Issues a request to rescan all virtual machine host bus adapters for new storage devices.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown if rescan failed.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



RescanHba

Issues a request to rescan a specific virtual machine host bus adapter for new storage devices.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
hbaDevicexsd:string

The device of the host bus adapter.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the host bus adapter cannot be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



RescanVmfs

Rescans for new VMFSs that might have been added.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown if configuration fails.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



RetrieveDiskPartitionInfo

Gets the partition information for the disks named by the device names.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
devicePathxsd:string[]

An array of device path names that identify disks. See ScsiDisk.

Return Value

Type Description
HostDiskPartitionInfo[]An array of information about the partitions.

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



SetMultipathLunPolicy

Sets the multipath policy for a Logical Unit. Use the LUN uuid from HostMultipathInfoLogicalUnit.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
lunIdxsd:string

The logical unit ID
policyHostMultipathInfoLogicalUnitPolicy

A data object that describes a multipathing policy for the logical unit.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
InvalidArgumentThrown if the policy is invalid.
NotFoundThrown if the LUN could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



UpdateDiskPartitions

Changes the partitions on the disk by supplying a partition specification and the device name.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
devicePathxsd:string

The name of the device path for the specific disk.
specHostDiskPartitionSpec

A data object that describes the disk partition table specification used to configure the partitions on a disk.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
InvalidArgumentThrown if the spec is invalid.
NotFoundThrown if the device could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



UpdateInternetScsiAlias

Updates the alias of an iSCSI host bus adapter.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
iScsiHbaDevicexsd:string

The device of the Internet SCSI HBA adapter.
iScsiAliasxsd:string

The new value for the alias of the adapter.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the host bus adapter could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



UpdateInternetScsiAuthenticationProperties

Updates the authentication properties for an iSCSI host bus adapter.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
iScsiHbaDevicexsd:string

The device of the Internet SCSI HBA adapter.
authenticationPropertiesHostInternetScsiHbaAuthenticationProperties

The data object that represents the authentication settings for this host bus adapter.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the host bus adapter could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



UpdateInternetScsiDiscoveryProperties

Updates the Discovery properties for an iSCSI host bus adapter.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
iScsiHbaDevicexsd:string

The device of the Internet SCSI HBA adapter.
discoveryPropertiesHostInternetScsiHbaDiscoveryProperties

The discovery settings for this host bus adapter.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the host bus adapter could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



UpdateInternetScsiIPProperties

Updates the IP properties for an iSCSI host bus adapter.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
iScsiHbaDevicexsd:string

The device of the Internet SCSI HBA adapter.
ipPropertiesHostInternetScsiHbaIPProperties

A data object representing the IP properties for the host bus adapter

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the host bus adapter could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



UpdateInternetScsiName

Updates the name of an iSCSI host bus adapter.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
iScsiHbaDevicexsd:string

The current name of the Internet SCSI HBA adapter.
iScsiNamexsd:string

The new name for the Internet SCSI HBA adapter

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the host bus adapter could not be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



UpdateSoftwareInternetScsiEnabled

Enables or disables Software iSCSI.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
enabledxsd:boolean

True to enable the iSCSI; false to disable it

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for any configuration failure.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



UpgradeVmfs

Upgrades the VMFS to the current VMFS version.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.
vmfsPathxsd:string

The path of the VMFS.

Return Value

Type Description
None

Faults

Type Description
HostConfigFaultThrown for all other configuration failures.
NotFoundThrown if the VMFS cannot be found.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition



UpgradeVmLayout

Iterates over all registered virtual machines. For each VM which .vmx file is located on the service console and all disks are available on VMFS3 or NAS, it will relocate the disks into directories if stored in the ROOT, and relocate the VMX file into the directory too. Events are logged for each virtual machine that is relocated.
Required Privileges
Host.Config.Storage

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the HostStorageSystem used to make the method call.

Return Value

Type Description
None

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition