Data Object - HostVmfsVolume(vim.host.VmfsVolume)

Property of
HostUnresolvedVmfsResolutionResult, VmfsDatastoreInfo
Returned by
FormatVmfs
Extends
HostFileSystemVolume
See also
HostForceMountedInfo, HostScsiDiskPartition, VmfsUnmapBandwidthSpec

Data Object Description

The VMFS file system.

Properties

Name Type Description
blockSize*xsd:int

Block size of VMFS in KB. Determines maximum file size. The maximum number of blocks is typically fixed with each specific version of VMFS. To increase the maximum size of a VMFS file, increase the block size.

The minimum block size is 1MB.

Since vSphere API 6.5
blockSizeMbxsd:intDeprecated. As of vSphere API 6.5, use blockSize instead.

Block size of VMFS. Determines maximum file size. The maximum number of blocks is typically fixed with each specific version of VMFS. To increase the maximum size of a VMFS file, increase the block size.

The minimum block size is 1MB.

extentHostScsiDiskPartition[]

The list of partition names that comprise this disk's VMFS extents.

This property can be accessed via various enclosing objects. In VirtualCenter, where it can be accessed from multiple hosts, the value of this property may differ according to the context in which it is accessed. When accessed from the VmfsDatastoreInfo object, in VirtualCenter, this property reflects the extent information of any one of the hosts visible to the datastore.

For a VirtualCenter system which manages ESX Server 2.x and ESX Server 3.x hosts, this extent information is only correlatable across hosts if the extents are exposed on the same adapter on all hosts which can access them. To find the extent names for a specific host, this same property should be accessed via the host's HostFileSystemVolume object, by correlating the uuid of the VMFS datastore in the VmfsDatastoreInfo object to the uuid in the FileSystemVolume object.

For a Virtual Center system which manages only ESX Server hosts with versions 4.0 onwards , this extent information is correlatable across hosts, irrespective of the adapters the extents are exposed on.

forceMountedInfo*HostForceMountedInfo

Information about 'forceMounted' VmfsVolume. When the system detects a copy of a VmfsVolume, it will not be auto-mounted on the host and it will be detected as 'UnresolvedVmfsVolume'. If user decides to 'forceMount' the VmfsVolume on the host, forceMountedInfo will be populated. It will not be set for automounted VMFS volumes.

Since vSphere API 4.0
local*xsd:boolean

Indicates whether the volume is backed by local disk. If unset, the information of the volume is local-disk backed is unknown.

Since vSphere API 5.5
majorVersionxsd:int

Major version number of VMFS.
maxBlocksxsd:int

Maximum number of blocks. Determines maximum file size along with blockSize. See information about the blockSize.


scsiDiskType*xsd:string

The type of disk drives. See ScsiDiskType for supported types. If unset, the default disk drive type is native512.

Since vSphere API 6.5
ssd*xsd:boolean

Indicates whether the volume is SSD backed. If unset, the information whether the volume is SSD backed is unknown.

Since vSphere API 5.0
unmapBandwidthSpec*VmfsUnmapBandwidthSpec

VMFS unmap bandwidth related specification. See VmfsUnmapBandwidthSpec for detail.

Since vSphere API 6.7
unmapGranularity*xsd:int

VMFS unmap reclaims unused storage space. This property determines the granularity of unmap operations. The unit is KB. If not specified, the default value is the same as the block size of VMFS blockSize. This property cannot be changed after a VMFS volume is created.

Since vSphere API 6.5
unmapPriority*xsd:string

VMFS unmap reclaims unused storage space. This property determines the processing rate of unmaps. See HostVmfsVolumeUnmapPriority for supported values. If not specified, the default value is low, which means unmap is processed at low rate. This property can be updated by calling UpdateVmfsUnmapPriority.

Since vSphere API 6.5
uuidxsd:string

The universally unique identifier assigned to VMFS.
versionxsd:string

Version string. Contains major and minor version numbers.
vmfsUpgradablexsd:boolean

Can the filesystem be upgraded to a newer version.
See UpgradeVmfs

Properties inherited from HostFileSystemVolume
capacity, name, type
Properties inherited from DynamicData
None
*Need not be set
Show WSDL type definition