# Managed Object - HostVStorageObjectManager(vim.vslm.host.VStorageObjectManager)

Extends
  VStorageObjectManagerBase
See also
  CryptoSpec, Datastore, ID, VirtualMachineProfileSpec, VslmCloneSpec, VslmCreateSpec, vslmInfrastructureObjectPolicy, VslmRelocateSpec, VStorageObject, VStorageObjectSnapshotInfo, VStorageObjectStateInfo
Since
  vSphere API 6.5

## Managed Object Description

Interface to manage virtual storage object on an ESXi host.

Properties

Name | Type | Description
--- | --- | ---
None
Properties inherited from VStorageObjectManagerBase
None

Methods

Methods defined in this Managed Object
HostClearVStorageObjectControlFlags, HostCloneVStorageObject_Task, HostCreateDisk_Task, HostDeleteVStorageObject_Task, HostExtendDisk_Task, HostInflateDisk_Task, HostListVStorageObject, HostReconcileDatastoreInventory_Task, HostRegisterDisk, HostRelocateVStorageObject_Task, HostRenameVStorageObject, HostRetrieveVStorageInfrastructureObjectPolicy, HostRetrieveVStorageObject, HostRetrieveVStorageObjectState, HostScheduleReconcileDatastoreInventory, HostSetVStorageObjectControlFlags, HostVStorageObjectCreateDiskFromSnapshot_Task, HostVStorageObjectCreateSnapshot_Task, HostVStorageObjectDeleteSnapshot_Task, HostVStorageObjectRetrieveSnapshotInfo, HostVStorageObjectRevert_Task
Methods inherited from VStorageObjectManagerBase
None

# HostClearVStorageObjectControlFlags(clearVStorageObjectControlFlags)

Clear control flags on VStorageObject.

Requires Datastore.FileManagement privilege on both source and destination datastore.

Required Privileges
  System.View
Since
  vSphere API 6.7

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object.
datastore | ManagedObjectReference to a Datastore | The datastore where the source virtual storage object is located.
controlFlags* | xsd:string[] | control flags enum array to be cleared on the VStorageObject. All control flags not included in the array remain intact.

*Need not be set

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk. The disk may be consumed.
NotFound | Thrown if specified virtual storage object cannot be found.
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostClearVStorageObjectControlFlags" type="vsan:HostClearVStorageObjectControlFlagsRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostClearVStorageObjectControlFlagsResponse"> <complexType/> </element>

# HostCloneVStorageObject_Task(cloneVStorageObject)

Clone a virtual storage object.

Requires Datastore.FileManagement privilege on both source and destination datastore.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object.
datastore | ManagedObjectReference to a Datastore | The datastore where the source virtual storage object is located.
spec | VslmCloneSpec | The specification for cloning the virtual storage object.

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task |

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while cloning the virtual storage object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
NotFound | Thrown if specified virtual storage object cannot be found.
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

# HostCreateDisk_Task(createDisk)

Create a virtual disk, which is a storage object with disk as consumption type.

Requires Datastore.FileManagement privilege on the datastore where the virtual disk object is created.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
spec | VslmCreateSpec | The specification of the virtual storage object to be created. 2

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task | This method returns a Task object with which to monitor the operation. The info.result property in the Task contains the newly created VStorageObject upon success.

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs when creating the virtual disk.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
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

# HostDeleteVStorageObject_Task(deleteVStorageObject)

Delete a virtual storage object and its assoicated backings.

Requires Datastore.FileManagement privilege on the datastore where the virtual storage object is located.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object to be deleted.
datastore | ManagedObjectReference to a Datastore | The datastore where the virtual storage object is located.

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task | This method returns a Task object with which to monitor the operation.

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs when deleting the virtual storage object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk. The disk may be consumed and cannot be deleted.
NotFound | Thrown if the specified virtual storage object cannot be found.
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
TaskInProgress | Thrown if the virtual storage object is busy.

Events

Type
None

# HostExtendDisk_Task(extendDisk)

Expand the capacity of a virtual disk, which is a storage object with disk, to the new capacity. The extended disk region will be the same as the original disk: - For a zerothick disk, the extended disk region will be zeroedthick. - For an eagerzerothick disk, the extended disk region will be eagerzeroedthick - A thin-provisioned disk will always be extended as a thin-provisioned disk.

Requires Datastore.FileManagement privilege on the datastore where the virtual storage object is located.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual disk to be extended.
datastore | ManagedObjectReference to a Datastore | The datastore where the virtual disk is located.
newCapacityInMB | xsd:long | The new capacity of the virtual disk in MB.

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task | This method returns a Task object with which to monitor the operation.

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while extending the virtual disk.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk. The disk may be consumed and cannot be extended.
NotFound | Thrown if the specified virtual storage object cannot be found.
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
TaskInProgress | Thrown if the virtual storage object is busy.

Events

Type
None

# HostInflateDisk_Task(inflateDisk)

Inflate a sparse or thin-provisioned virtual disk up to the full size. Additional space allocated to the disk as a result of this operation will be filled with zeroes.

Currently inflateDisk API only supports the following combinations: Valid provisioning type: THIN; Valid Datastore: VMFS, NFS. Inflating a disk is not applicable for VVol/VSAN datastore.

Requires Datastore.FileManagement privilege on the datastore where the virtual storage object is located.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual disk to be inflated.
datastore | ManagedObjectReference to a Datastore | The datastore where the virtual disk is located.

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task | This method returns a Task object with which to monitor the operation.

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while inflating the virtual disk.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk. The disk may be consumed and cannot be extended.
NotFound | Thrown if the specified virtual storage object cannot be found.
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
TaskInProgress | Thrown if the virtual storage object is busy.

Events

Type
None

# HostListVStorageObject(listVStorageObject)

List all virtual storage objects located on a datastore.

Requires Datastore.FileManagement privilege on the datastore where the virtual storage object is located.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
datastore | ManagedObjectReference to a Datastore | The datastore to query for the virtual storage objects.

Return Value

Type | Description
--- | ---
ID[] | The list of IDs of the virtual storage objects located on the datastore.

Faults

Type | Description
--- | ---
InvalidDatastore | Thrown if the operation cannot be performed on the datastore, such as datastore cannot be found or inaccessible.
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostListVStorageObject" type="vsan:HostListVStorageObjectRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostListVStorageObjectResponse"> <complexType> <sequence> <element name="returnval" type="vsan:ID" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

# HostReconcileDatastoreInventory_Task(reconcileDatastoreInventory)

Reconcile the datastore inventory info of virtual storage objects.

Requires Datastore.FileManagement privilege.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
datastore | ManagedObjectReference to a Datastore | The datastore that needs to be reconciled.

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task |

Faults

Type | Description
--- | ---
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
NotFound |
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

# HostRegisterDisk(registerDisk)

Promote a virtual disk to a First Class Disk.

Requires Datastore.FileManagement privilege on the datastore where the virtual disk resides.

See vim.vslm.BaseConfigInfo.name

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
path | xsd:string | URL or datastore path to the virtual disk. See vim.vslm.BaseConfigInfo.name
name* | xsd:string | The descriptive name of the disk object. If unset the name will be automatically determined from the path. See vim.vslm.BaseConfigInfo.name

*Need not be set

Return Value

Type | Description
--- | ---
VStorageObject | The registered virtual storage object for the disk.

Faults

Type | Description
--- | ---
AlreadyExists | Thrown if disk is already registered as a virtual storage object. See vim.vslm.BaseConfigInfo.name
FileFault | Thrown if an error occurs while registering the virtual disk. See vim.vslm.BaseConfigInfo.name
InvalidDatastore | Thrown if datastore cannot be found or the operation cannot be performed on the datastore. See vim.vslm.BaseConfigInfo.name
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRegisterDisk" type="vsan:HostRegisterDiskRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRegisterDiskResponse"> <complexType> <sequence> <element name="returnval" type="vsan:VStorageObject"/> </sequence> </complexType> </element>

# HostRelocateVStorageObject_Task(relocateVStorageObject)

Relocate a virtual storage object.

Requires Datastore.FileManagement privilege on both source and destination datastore.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object.
datastore | ManagedObjectReference to a Datastore | The datastore where the source virtual storage object is located.
spec | VslmRelocateSpec | The specification for relocation of the virtual storage object.

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task |

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while relocating the virtual storage object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk. The disk may be consumed and cannot be relocated.
NotFound | Thrown if specified virtual storage object cannot be found.
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

# HostRenameVStorageObject(renameVStorageObject)

Rename a virtual storage object.

Requires Datastore.FileManagement privilege on the datastore where the virtual storage object is located.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object to be renamed.
datastore | ManagedObjectReference to a Datastore | The datastore where the virtual storage object is located.
name | xsd:string | The new name for the virtual storage object.

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while renaming the virtual storage object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
NotFound | Thrown if the specified virtual storage object cannot be found.
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRenameVStorageObject" type="vsan:HostRenameVStorageObjectRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRenameVStorageObjectResponse"> <complexType/> </element>

# HostRetrieveVStorageInfrastructureObjectPolicy(retrieveVStorageInfrastructureObjectPolicy)

Retrieve virtual storage infrastructure object SBPM policy on given datastore. Only support VSAN datastore.

Requires Datastore.FileManagement privilege on the datastore specified.

Required Privileges
  System.View
Since
  vSphere API 6.7

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
datastore | ManagedObjectReference to a Datastore | Datastore on which policy needs to be retrieved.

Return Value

Type | Description
--- | ---
vslmInfrastructureObjectPolicy[] | The policy object of virtual storage object.

Faults

Type | Description
--- | ---
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk.
NotFound | Thrown if specified virtual storage object cannot be found.
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRetrieveVStorageInfrastructureObjectPolicy" type="vsan:HostRetrieveVStorageInfrastructureObjectPolicyRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRetrieveVStorageInfrastructureObjectPolicyResponse"> <complexType> <sequence> <element name="returnval" type="vsan:vslmInfrastructureObjectPolicy" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

# HostRetrieveVStorageObject(retrieveVStorageObject)

Retrieve a virtual storage object.

Requires Datastore.FileManagement privilege on the datastore where the virtual storage object is located.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object to be retrieved.
datastore | ManagedObjectReference to a Datastore | The datastore where the virtual storage object is located.

Return Value

Type | Description
--- | ---
VStorageObject | The required virtual storage object.

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs when retrieving the virtual object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
NotFound | Thrown if specified virtual storage object cannot be found.
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRetrieveVStorageObject" type="vsan:HostRetrieveVStorageObjectRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRetrieveVStorageObjectResponse"> <complexType> <sequence> <element name="returnval" type="vsan:VStorageObject"/> </sequence> </complexType> </element>

# HostRetrieveVStorageObjectState(retrieveVStorageObjectState)

Retrieve a virtual storage object state.

Requires Datastore.FileManagement privilege on the datastore where the virtual storage object is located.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object the state to be retrieved.
datastore | ManagedObjectReference to a Datastore | The datastore where the virtual storage object is located.

Return Value

Type | Description
--- | ---
VStorageObjectStateInfo | The required virtual storage object state.

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs when retrieving the virtual object state.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
NotFound | Thrown if specified virtual storage object cannot be found.
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRetrieveVStorageObjectState" type="vsan:HostRetrieveVStorageObjectStateRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostRetrieveVStorageObjectStateResponse"> <complexType> <sequence> <element name="returnval" type="vsan:VStorageObjectStateInfo"/> </sequence> </complexType> </element>

# HostScheduleReconcileDatastoreInventory(scheduleReconcileDatastoreInventory)

Schedules reconcile of the datastore inventory info of virtual storage objects. This method just schedules the reconcile operation for the nearby future and returns. Note that since the reconcile operation will be executed after this method already returns the success of this method should not be considered as success of the actual reconcile operation.

Requires Datastore.FileManagement privilege.

Required Privileges
  System.View

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
datastore | ManagedObjectReference to a Datastore | The datastore that needs to be reconciled.

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
NotFound |
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostScheduleReconcileDatastoreInventory" type="vsan:HostScheduleReconcileDatastoreInventoryRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostScheduleReconcileDatastoreInventoryResponse"> <complexType/> </element>

# HostSetVStorageObjectControlFlags(setVStorageObjectControlFlags)

Set control flags on VStorageObject.

Requires Datastore.FileManagement privilege on both source and destination datastore.

Required Privileges
  System.View
Since
  vSphere API 6.7

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object.
datastore | ManagedObjectReference to a Datastore | The datastore where the source virtual storage object is located.
controlFlags* | xsd:string[] | control flags enum array to be set on the VStorageObject. All control flags not included in the array remain intact.

*Need not be set

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk. The disk may be consumed.
NotFound | Thrown if specified virtual storage object cannot be found.
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostSetVStorageObjectControlFlags" type="vsan:HostSetVStorageObjectControlFlagsRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostSetVStorageObjectControlFlagsResponse"> <complexType/> </element>

# HostVStorageObjectCreateDiskFromSnapshot_Task(createDiskFromSnapshot)

Creates a new Disk from given snapshot of a VStorageObject.

Required Privileges
  System.View
Since
  vSphere API 6.7

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object.
datastore | ManagedObjectReference to a Datastore | The datastore where the source virtual storage object is located.
snapshotId | ID | The ID of the snapshot of the virtual storage object.
name | xsd:string | A user friendly name to be associated with the new disk.
profile* | VirtualMachineProfileSpec[] | SPBM Profile requirement on the new virtual storage object. If not specified datastore default policy would be assigned.
crypto* | CryptoSpec | Crypto information of the new disk.
path* | xsd:string | Relative location in the specified datastore where disk needs to be created. If not specified disk gets created at defualt VStorageObject location on the specified datastore

*Need not be set

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task |

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while snapshotting the virtual storage object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk.
NotFound | Thrown if specified virtual storage object cannot be found.
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

# HostVStorageObjectCreateSnapshot_Task(createSnapshot)

Creates a snapshot of a given VStorageObject.

Required Privileges
  System.View
Since
  vSphere API 6.7

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object.
datastore | ManagedObjectReference to a Datastore | The datastore where the source virtual storage object is located.
description | xsd:string | A short description to be associated with the snapshot.

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task |

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while snapshotting the virtual storage object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk.
NotFound | Thrown if specified virtual storage object cannot be found.
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

# HostVStorageObjectDeleteSnapshot_Task(deleteSnapshot)

Deletes a given snapshot of a VStorageObject.

Required Privileges
  System.View
Since
  vSphere API 6.7

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object.
datastore | ManagedObjectReference to a Datastore | The datastore where the source virtual storage object is located.
snapshotId | ID | The ID of the snapshot of a virtual storage object.

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task |

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while snapshotting the virtual storage object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk.
NotFound | Thrown if specified virtual storage object cannot be found.
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

# HostVStorageObjectRetrieveSnapshotInfo(retrieveSnapshotInfo)

Retrieves snapshot information of a given VStorageObject.

Required Privileges
  System.View
Since
  vSphere API 6.7

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object.
datastore | ManagedObjectReference to a Datastore | The datastore where the source virtual storage object is located.

Return Value

Type | Description
--- | ---
VStorageObjectSnapshotInfo |

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while snapshotting the virtual storage object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk.
NotFound | Thrown if specified virtual storage object cannot be found.
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

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostVStorageObjectRetrieveSnapshotInfo" type="vsan:HostVStorageObjectRetrieveSnapshotInfoRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostVStorageObjectRetrieveSnapshotInfoResponse"> <complexType> <sequence> <element name="returnval" type="vsan:VStorageObjectSnapshotInfo"/> </sequence> </complexType> </element>

# HostVStorageObjectRevert_Task(RevertVStorageObject)

Reverts to a given snapshot of a VStorageObject. This operation is supported on detached VirtualDisks During revert all the snapshots which were taken after the specified snapshot would get deleted.

E.g. Consider Disk with 4 snapshots

BaseDisk -> Snap-2 -> Snap-3 -> Snap-4 -> Running-Point

If user chooses to revert to snap-2 then snap-4 and snap-3 would also be deleted. After revert operation disk would have below configuration:

BaseDisk -> Snap-2 -> Running-Point

Required Privileges
  System.View
Since
  vSphere API 6.7

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostVStorageObjectManager used to make the method call.
id | ID | The ID of the virtual storage object.
datastore | ManagedObjectReference to a Datastore | The datastore where the source virtual storage object is located.
snapshotId | ID | The ID of the snapshot of a virtual storage object.

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task |

Faults

Type | Description
--- | ---
FileFault | Thrown if an error occurs while snapshotting the virtual storage object.
InvalidDatastore | Thrown if the operation cannot be performed on the datastore.
InvalidState | Thrown if the operation cannot be performed on the disk.
NotFound | Thrown if specified virtual storage object cannot be found.
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