Data Object Description

When mounting a NAS volume on multiple hosts, the same remoteHost and remotePath values should be used on every host, otherwise it will be treated as different datastores. For example, if one host references the remotePath of a NAS volume as "/mnt/mount1" and another references it as "/mnt/mount1/", it will not be recognized as the same datastore.

Properties

Name	Type	Description
accessMode	xsd:string	Access mode for the mount point. Mounting in read-write mode would be successful irregardless on how the mount point is exported or access permissions. For example, mounting a volume that is exported as read-only as readWrite will succeed. Hence, that a readWrite mount succeeds should not be taken as an indication that all files on a mount is writable. If a file system is mounted readOnly, the system cannot create or modify any files on the file system. This is mostly useful for storing ISO images and templates, since a virtual machine cannot be powered on from a readOnly volume. The access mode of a mounted NFS volume can be obtained at accessMode. See HostMountMode
localPath	xsd:string	The localPath refers to the name of the NAS datastore to be created using this specification. In the case of ESX Server, the datastore name is a component in the file system path at which the NAS volume can be found. For example, if localPath is set to "nas_volume" the created NAS datastore will be named "nas_volume" and it can be accessed via the file system path "/vmfs/volumes/nas_volume". In the case of VMware Server, the localPath will also be used as the datastore name, but the datastore name may not necessarily be reflected in the file system path where the NAS volume may be accessed.
password*	xsd:string	If type is CIFS, the password to use when connecting to the CIFS server. If type is NFS, this field will be ignored. *Since* VI API 2.5
remoteHost	xsd:string	The host that runs the NFS server.
remotePath	xsd:string	The remote path of the NFS mount point.
type*	xsd:string	The type of the the NAS volume (CIFS / NFS). If not specified, defaults to nfs. *Since* VI API 2.5
userName*	xsd:string	If type is CIFS, the user name to use when connecting to the CIFS server. If type is NFS, this field will be ignored. *Since* VI API 2.5
Properties inherited from DynamicData
dynamicProperty, dynamicType

Name

Type

Description

accessMode

xsd:string

Access mode for the mount point.

Mounting in read-write mode would be successful irregardless on how the mount point is exported or access permissions. For example, mounting a volume that is exported as read-only as readWrite will succeed. Hence, that a readWrite mount succeeds should not be taken as an indication that all files on a mount is writable.

If a file system is mounted readOnly, the system cannot create or modify any files on the file system. This is mostly useful for storing ISO images and templates, since a virtual machine cannot be powered on from a readOnly volume.

The access mode of a mounted NFS volume can be obtained at accessMode.

See HostMountMode

localPath

xsd:string

The localPath refers to the name of the NAS datastore to be created using this specification.

In the case of ESX Server, the datastore name is a component in the file system path at which the NAS volume can be found. For example, if localPath is set to "nas_volume" the created NAS datastore will be named "nas_volume" and it can be accessed via the file system path "/vmfs/volumes/nas_volume".

In the case of VMware Server, the localPath will also be used as the datastore name, but the datastore name may not necessarily be reflected in the file system path where the NAS volume may be accessed.

password*

xsd:string

If type is CIFS, the password to use when connecting to the CIFS server. If type is NFS, this field will be ignored.

Since VI API 2.5

remoteHost

xsd:string

The host that runs the NFS server.

remotePath

xsd:string

The remote path of the NFS mount point.

type*

xsd:string

The type of the the NAS volume (CIFS / NFS). If not specified, defaults to nfs.

Since VI API 2.5

userName*

xsd:string

If type is CIFS, the user name to use when connecting to the CIFS server. If type is NFS, this field will be ignored.

Since VI API 2.5

Properties inherited from DynamicData

dynamicProperty, dynamicType

Need not be set

Show WSDL type definition

         <complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="HostNasVolumeSpec">
            <complexContent>
               <extension base="vim25:DynamicData">
                  <sequence>
                     <element name="remoteHost" type="xsd:string"/>
                     <element name="remotePath" type="xsd:string"/>
                     <element name="localPath" type="xsd:string"/>
                     <element name="accessMode" type="xsd:string"/>
                     <element name="type" type="xsd:string" minOccurs="0"/>
                     <element name="userName" type="xsd:string" minOccurs="0"/>
                     <element name="password" type="xsd:string" minOccurs="0"/>
                  </sequence>
               </extension>
            </complexContent>
         </complexType>

Data Object - HostNasVolumeSpec

Data Object Description