Managed Object - VcenterVStorageObjectManager(vim.vslm.vcenter.VStorageObjectManager)

Extends: VStorageObjectManagerBase
See also: CryptoSpec, Datacenter, Datastore, DiskChangeInfo, DiskCryptoSpec, ID, KeyValue, RetrieveVStorageObjSpec, VirtualMachineProfileSpec, VslmCloneSpec, VslmCreateSpec, vslmInfrastructureObjectPolicy, vslmInfrastructureObjectPolicySpec, VslmRelocateSpec, VslmTagEntry, vslmVClockInfo, VStorageObject, VStorageObjectAssociations, VStorageObjectSnapshotDetails, VStorageObjectSnapshotInfo, VStorageObjectStateInfo
Since: vSphere API Release 6.5

Managed Object Description

Interface to manage virtual storage object on a vCenter. VStorageObjectManager and SPBM policy support: All of the VStorageObjectManager APIs requiring ESXi host uses "Programatically selected" host to perform the actual operation. If the selected host is of 6.5 version then policy would not be passed down to host. In that case, user operation would succeed but if user checks SPBM Entity Compliance, it will show "Mismatch" / "Non Compliant" as a compliance result.

Properties

Name	Type	Description
None
Properties inherited from VStorageObjectManagerBase
None

Methods

Methods defined in this Managed Object
AttachTagToVStorageObject, ClearVStorageObjectControlFlags, CloneVStorageObject_Task, CreateDisk_Task, CreateDiskFromSnapshot_Task, DeleteSnapshot_Task, DeleteVStorageObject_Task, DeleteVStorageObjectEx_Task, DetachTagFromVStorageObject, ExtendDisk_Task, InflateDisk_Task, ListTagsAttachedToVStorageObject, ListVStorageObject, ListVStorageObjectsAttachedToTag, QueryVirtualDiskUuidEx, ReconcileDatastoreInventory_Task, RegisterDisk, RelocateVStorageObject_Task, RenameVStorageObject, RetrieveSnapshotDetails, RetrieveSnapshotInfo, RetrieveVStorageInfrastructureObjectPolicy, RetrieveVStorageObject, RetrieveVStorageObjectAssociations, RetrieveVStorageObjectState, RevertVStorageObject_Task, ScheduleReconcileDatastoreInventory, SetVirtualDiskUuidEx_Task, SetVStorageObjectControlFlags, UpdateVStorageInfrastructureObjectPolicy_Task, UpdateVStorageObjectCrypto_Task, UpdateVStorageObjectPolicy_Task, VCenterUpdateVStorageObjectMetadataEx_Task, VStorageObjectCreateSnapshot_Task, VstorageObjectVCenterQueryChangedDiskAreas
Methods inherited from VStorageObjectManagerBase
RenameVStorageObjectEx, RevertVStorageObjectEx_Task, VStorageObjectCreateSnapshotEx_Task, VStorageObjectDeleteSnapshotEx_Task, VStorageObjectExtendDiskEx_Task

AttachTagToVStorageObject(attachTagToVStorageObject)

Attach a tag to a virtual storage object.

Requires privilege InventoryService.Tagging.AttachTag on root folder

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The identifier(ID) of the virtual storage object. *Since* vSphere API Release 6.5
category	xsd:string	The category to which the tag belongs. *Since* vSphere API Release 6.5
tag	xsd:string	The tag which has to be associated with the virtual storage object. *Since* vSphere API Release 6.5

Return Value

Type	Description
None

Faults

Type	Description
NotFound	Thrown if the specified category or tag 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:vim25="urn:vim25" name="AttachTagToVStorageObject" type="vim25:AttachTagToVStorageObjectRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="AttachTagToVStorageObjectResponse">
                  <complexType/>
               </element>

ClearVStorageObjectControlFlags(clearVStorageObjectControlFlags)

Clear control flags on VStorageObject. The control flags are defined in vslmVStorageObjectControlFlag.

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

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

*Need not be set P Required privilege: Datastore.FileManagement

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:vim25="urn:vim25" name="ClearVStorageObjectControlFlags" type="vim25:ClearVStorageObjectControlFlagsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ClearVStorageObjectControlFlagsResponse">
                  <complexType/>
               </element>

CloneVStorageObject_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 VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 6.5
datastore	ManagedObjectReference to a Datastore	The datastore where the source virtual storage object is located. *Since* vSphere API Release 6.5
spec	VslmCloneSpec	The specification for cloning the virtual storage object. *Since* vSphere API Release 6.5

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

CreateDisk_Task(createDisk)

Create a virtual disk, which is a storage object with vim.vslm.VStorageObject.ConsumptionType#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 VcenterVStorageObjectManager used to make the method call.

spec

VslmCreateSpec

The specification of the virtual storage object to be created.

Since vSphere API Release 6.5

Return Value

Type	Description
ManagedObjectReference to a Task	This method returns a Task object with which to monitor monitor the operation. The 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

CreateDiskFromSnapshot_Task(createDiskFromSnapshot)

Creates a new Disk from given snapshot of a VStorageObject.

Requires Datastore.FileManagement privilege.

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 6.7
datastore	ManagedObjectReference to a Datastore	The datastore where the source virtual storage object is located. *Since* vSphere API Release 6.7
snapshotId	ID	The ID of the snapshot of the virtual storage object. *Since* vSphere API Release 6.7
name	xsd:string	A user friendly name to be associated with the new disk. *Since* vSphere API Release 6.7
profile*	VirtualMachineProfileSpec[]	SPBM Profile requirement on the new virtual storage object. If not specified datastore default policy would be assigned. *Since* vSphere API Release 6.7
crypto*	CryptoSpec	Crypto information of the new disk. If unset and if profile contains an encryption iofilter and if snapshto is unencrypted, then cyrpto will be of type CryptoSpecEncrypt, and filled with keyId that is automatically generated and keyProviderId that is the default kms cluster. If unset and if profile is a default policy and if snapshot is unenrypted, then crypto is treated as CryptoSpecNoOp. If unset and if profile contains an encryption iofilter and if snapshot is encrypted, then cyrpto is treated as CryptoSpecNoOp. If unset and if profile is a default policy and if snapshot is encrypted, then cyrpto is treated as CryptoSpecDecrypt. To recrypt the disk during creating disk, crypto has to be present. *Since* vSphere API Release 6.7
path*	xsd:string	Relative location in the specified datastore where disk needs to be created. If not specified disk gets created at the defualt VStorageObject location on the specified datastore. *Since* vSphere API Release 6.7

*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

DeleteSnapshot_Task(deleteSnapshot)

Deletes a given snapshot of a VStorageObject.

Requires Datastore.FileManagement privilege.

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 6.7
datastore	ManagedObjectReference to a Datastore	The datastore where the source virtual storage object is located. *Since* vSphere API Release 6.7
snapshotId	ID	The ID of the snapshot of a virtual storage object. *Since* vSphere API Release 6.7

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

DeleteVStorageObject_Task(deleteVStorageObject)

Delete a virtual storage object and its associated 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 VcenterVStorageObjectManager used to make the method call.

The ID of the virtual storage object to be deleted.

Since vSphere API Release 6.5

datastore

ManagedObjectReference
to a Datastore

The datastore where the virtual storage object is located.

Since vSphere API Release 6.5

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

DeleteVStorageObjectEx_Task(deleteVStorageObjectEx)

Delete a virtual storage object and its associated backings. Returns the corresponding vclock upon succeess.

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

Required Privileges: System.View
Since: vSphere API Release 7.0.2.0

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VcenterVStorageObjectManager used to make the method call.

The ID of the virtual storage object to be deleted.

Since vSphere API Release 7.0.2.0

datastore

ManagedObjectReference
to a Datastore

The datastore where the virtual storage object is located.

Since vSphere API Release 7.0.2.0

Return Value

Type	Description
ManagedObjectReference to a Task

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

DetachTagFromVStorageObject(detachTagFromVStorageObject)

Detach a tag from a virtual storage object.

Requires privilege InventoryService.Tagging.AttachTag on root folder

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The identifier(ID) of the virtual storage object. *Since* vSphere API Release 6.5
category	xsd:string	The category to which the tag belongs. *Since* vSphere API Release 6.5
tag	xsd:string	The tag which has to be disassociated with the virtual storage object. *Since* vSphere API Release 6.5

Return Value

Type	Description
None

Faults

Type	Description
NotFound	Thrown if the specified category or tag 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:vim25="urn:vim25" name="DetachTagFromVStorageObject" type="vim25:DetachTagFromVStorageObjectRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="DetachTagFromVStorageObjectResponse">
                  <complexType/>
               </element>

ExtendDisk_Task(extendDisk)

Expand the capacity of a virtual disk, which is a storage object with vim.vslm.VStorageObject.ConsumptionType#disk, to the new capacity. If new capacity is smaller than current disk capacity, then operation fails due to invalid capacity. If new capacity is greater than current disk capacity, then operation proceeds. If new capacity is equal to current disk ccapcity, then operation succeeds without any actual extension. 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.

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual disk to be extended. *Since* vSphere API Release 6.5
datastore	ManagedObjectReference to a Datastore	The datastore where the virtual disk is located. *Since* vSphere API Release 6.5
newCapacityInMB	xsd:long	The new capacity of the virtual disk in MB. *Since* vSphere API Release 6.5

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

InflateDisk_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 zeros.

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 VcenterVStorageObjectManager used to make the method call.

The ID of the virtual disk to be inflated.

Since vSphere API Release 6.5

datastore

ManagedObjectReference
to a Datastore

The datastore where the virtual disk is located.

Since vSphere API Release 6.5

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

ListTagsAttachedToVStorageObject(listTagsAttachedToVStorageObject)

Lists all tags attached to virtual storage object.

Required Privileges: System.Read

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VcenterVStorageObjectManager used to make the method call.

The ID of the virtual storage object.

Since vSphere API Release 6.5

Return Value

Type	Description
VslmTagEntry[]	The list of Tag-association tuples associated with the virtual storage object.

Faults

Type	Description
NotFound	Thrown if the specified category or tag 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:vim25="urn:vim25" name="ListTagsAttachedToVStorageObject" type="vim25:ListTagsAttachedToVStorageObjectRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ListTagsAttachedToVStorageObjectResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:VslmTagEntry" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

ListVStorageObject(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 VcenterVStorageObjectManager used to make the method call.

datastore

ManagedObjectReference
to a Datastore

The datastore to query for the virtual storage objects.

Since vSphere API Release 6.5

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 is 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:vim25="urn:vim25" name="ListVStorageObject" type="vim25:ListVStorageObjectRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ListVStorageObjectResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:ID" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

ListVStorageObjectsAttachedToTag(listVStorageObjectsAttachedToTag)

Lists all virtual storage objects attached to the tag.

Required Privileges: System.Read

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VcenterVStorageObjectManager used to make the method call.

category

xsd:string

The category to which the tag belongs.

Since vSphere API Release 6.5

tag

xsd:string

The tag to be queried.

Since vSphere API Release 6.5

Return Value

Type	Description
ID[]	The list of IDs of the virtual storage objects.

Faults

Type	Description
NotFound	Thrown if the specified category or tag 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:vim25="urn:vim25" name="ListVStorageObjectsAttachedToTag" type="vim25:ListVStorageObjectsAttachedToTagRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ListVStorageObjectsAttachedToTagResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:ID" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

QueryVirtualDiskUuidEx(queryVirtualDiskUuidEx)

Get the virtual disk UUID.

The datacenter parameter may be omitted if a URL is used to name the disk. A URL has the form

scheme://authority/folder/path?dcPath=dcPath&dsName=dsName

where

scheme is http or https.
authority specifies the hostname or IP address of the VirtualCenter or ESX server and optionally the port.
dcPath is the inventory path to the Datacenter containing the Datastore.
dsName is the name of the Datastore.
path is a slash-delimited path from the root of the datastore.

Required Privileges: System.View
Since: vSphere API Release 8.0.3.0

Parameters

Name Type Description

_this ManagedObjectReference A reference to the VcenterVStorageObjectManager used to make the method call.

name

xsd:string

The name of the disk, either a datastore path or a URL referring to the virtual disk whose uuid for the DDB entry needs to be queried. A datastore path has the form

[datastore] path

where

datastore is the datastore name.
path is a slash-delimited path from the root of the datastore.

An example datastore path is "[storage] path/to/file.extension".

Since vSphere API Release 8.0.3.0

datacenter*

ManagedObjectReference
to a Datacenter

If name is a datastore path, the datacenter for that datastore path is mandatory. Not needed when invoked directly on ESX. If not specified on a call from VirtualCenter, name must be a URL.

Since vSphere API Release 8.0.3.0

*Need not be set

Return Value

Type	Description
xsd:string	The hex representation of the unique ID for this virtual disk.

Faults

Type	Description
FileFault	Thrown if an error occurs reading 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

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryVirtualDiskUuidEx" type="vim25:QueryVirtualDiskUuidExRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="QueryVirtualDiskUuidExResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="xsd:string"/>
                     </sequence>
                  </complexType>
               </element>

ReconcileDatastoreInventory_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 VcenterVStorageObjectManager used to make the method call.

datastore

ManagedObjectReference
to a Datastore

The datastore that needs to be reconciled.

Since vSphere API Release 6.5

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

RegisterDisk(registerDisk)

Promote a virtual disk to a First Class Disk.

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

See name

Required Privileges: System.View

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VcenterVStorageObjectManager used to make the method call.

path

xsd:string

URL path to the virtual disk.
See name

Since vSphere API Release 6.5

name*

xsd:string

The descriptive name of the disk object. If unset the name will be automatically determined from the path.
See name

Since vSphere API Release 6.5

*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 name
FileFault	Thrown if an error occurs while registering the virtual disk. See name
InvalidDatastore	Thrown if datastore cannot be found or the operation cannot be performed on the datastore. See 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:vim25="urn:vim25" name="RegisterDisk" type="vim25:RegisterDiskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RegisterDiskResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:VStorageObject"/>
                     </sequence>
                  </complexType>
               </element>

RelocateVStorageObject_Task(relocateVStorageObject)

Relocate a virtual storage object.

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

If there is no host that has access to both source and destination datastore, then limited number of concurrent relocations are supported. This number is set to 10.

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 6.5
datastore	ManagedObjectReference to a Datastore	The datastore where the source virtual storage object is located. *Since* vSphere API Release 6.5
spec	VslmRelocateSpec	The specification for relocation of the virtual storage object. *Since* vSphere API Release 6.5

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

RenameVStorageObject(renameVStorageObject)

Rename a virtual storage object.

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object to be renamed. *Since* vSphere API Release 6.5
datastore	ManagedObjectReference to a Datastore	The datastore where the virtual storage object is located. *Since* vSphere API Release 6.5
name	xsd:string	The new name for the virtual storage object. *Since* vSphere API Release 6.5

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:vim25="urn:vim25" name="RenameVStorageObject" type="vim25:RenameVStorageObjectRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RenameVStorageObjectResponse">
                  <complexType/>
               </element>

RetrieveSnapshotDetails(retrieveSnapshotDetails)

Retrieves snapshot disk details of a given snapshot.

Required Privileges: System.View
Since: vSphere API Release 7.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 6.7
datastore	ManagedObjectReference to a Datastore	The datastore where the source virtual storage object is located. *Since* vSphere API Release 6.7
snapshotId	ID	The ID of the snapshot of a virtual storage object. *Since* vSphere API Release 6.7

Return Value

Type	Description
VStorageObjectSnapshotDetails

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:vim25="urn:vim25" name="RetrieveSnapshotDetails" type="vim25:RetrieveSnapshotDetailsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveSnapshotDetailsResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:VStorageObjectSnapshotDetails"/>
                     </sequence>
                  </complexType>
               </element>

RetrieveSnapshotInfo(retrieveSnapshotInfo)

Retrieves snapshot information of a given VStorageObject.

Requires Datastore.FileManagement privilege.

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VcenterVStorageObjectManager used to make the method call.

The ID of the virtual storage object.

Since vSphere API Release 6.7

datastore

ManagedObjectReference
to a Datastore

The datastore where the source virtual storage object is located.

Since vSphere API Release 6.7

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:vim25="urn:vim25" name="RetrieveSnapshotInfo" type="vim25:RetrieveSnapshotInfoRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveSnapshotInfoResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:VStorageObjectSnapshotInfo"/>
                     </sequence>
                  </complexType>
               </element>

RetrieveVStorageInfrastructureObjectPolicy(retrieveVStorageInfrastructureObjectPolicy)

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

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

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VcenterVStorageObjectManager used to make the method call.

datastore

ManagedObjectReference
to a Datastore

Datastore on which policy needs to be retrieved.

Since vSphere API Release 6.7

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:vim25="urn:vim25" name="RetrieveVStorageInfrastructureObjectPolicy" type="vim25:RetrieveVStorageInfrastructureObjectPolicyRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveVStorageInfrastructureObjectPolicyResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:vslmInfrastructureObjectPolicy" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

RetrieveVStorageObject(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 VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object to be retrieved. *Since* vSphere API Release 6.5
datastore	ManagedObjectReference to a Datastore	The datastore where the virtual storage object is located. *Since* vSphere API Release 6.5
diskInfoFlags*	xsd:string[]	Flags indicating the FCD information to be retrieved. If diskInfoFlags is unset, then all FCD information will be retrieved. See vslmDiskInfoFlag for the list of supported values. *Since* vSphere API Release 6.5

*Need not be set

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:vim25="urn:vim25" name="RetrieveVStorageObject" type="vim25:RetrieveVStorageObjectRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveVStorageObjectResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:VStorageObject"/>
                     </sequence>
                  </complexType>
               </element>

RetrieveVStorageObjectAssociations(retrieveVStorageObjectAssociations)

Retrieve vm associations for each virtual storage object in the query.

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VcenterVStorageObjectManager used to make the method call.

ids*

RetrieveVStorageObjSpec[]

The IDs of the virtual storage objects of the query.

Since vSphere API Release 6.7

*Need not be set

Return Value

Type	Description
VStorageObjectAssociations[]	The list of VStorageObjectVmAssociations which provides virtual storage object id to vm associations mapping.

Faults

Type	Description
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:vim25="urn:vim25" name="RetrieveVStorageObjectAssociations" type="vim25:RetrieveVStorageObjectAssociationsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveVStorageObjectAssociationsResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:VStorageObjectAssociations" minOccurs="0" maxOccurs="unbounded"/>
                     </sequence>
                  </complexType>
               </element>

RetrieveVStorageObjectState(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 VcenterVStorageObjectManager used to make the method call.

The ID of the virtual storage object the state to be retrieved.

Since vSphere API Release 6.5

datastore

ManagedObjectReference
to a Datastore

The datastore where the virtual storage object is located.

Since vSphere API Release 6.5

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:vim25="urn:vim25" name="RetrieveVStorageObjectState" type="vim25:RetrieveVStorageObjectStateRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveVStorageObjectStateResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:VStorageObjectStateInfo"/>
                     </sequence>
                  </complexType>
               </element>

RevertVStorageObject_Task

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

Requires Datastore.FileManagement privilege.

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 6.7
datastore	ManagedObjectReference to a Datastore	The datastore where the source virtual storage object is located. *Since* vSphere API Release 6.7
snapshotId	ID	The ID of the snapshot of a virtual storage object. *Since* vSphere API Release 6.7

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

ScheduleReconcileDatastoreInventory(scheduleReconcileDatastoreInventory)

Schedules reconcile of the inventory info of virtual storage objects on one of the hosts that is connected with the datastore. 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 VcenterVStorageObjectManager used to make the method call.

datastore

ManagedObjectReference
to a Datastore

The datastore that needs to be reconciled.

Since vSphere API Release 6.5

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:vim25="urn:vim25" name="ScheduleReconcileDatastoreInventory" type="vim25:ScheduleReconcileDatastoreInventoryRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ScheduleReconcileDatastoreInventoryResponse">
                  <complexType/>
               </element>

SetVirtualDiskUuidEx_Task(setVirtualDiskUuidEx)

Set the virtual disk Uuid.

The datacenter parameter may be omitted if a URL is used to name the disk. A URL has the form

scheme://authority/folder/path?dcPath=dcPath&dsName=dsName

where

scheme is http or https.
authority specifies the hostname or IP address of the VirtualCenter or ESX server and optionally the port.
dcPath is the inventory path to the Datacenter containing the Datastore.
dsName is the name of the Datastore.
path is a slash-delimited path from the root of the datastore.

Required Privileges: System.View
Since: vSphere API Release 8.0.3.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
name	xsd:string	The name of the disk, either a datastore path or a URL referring to the virtual disk whose uuid for the DDB entry needs to be set. A datastore path has the form [datastore] path where datastore is the datastore name. path is a slash-delimited path from the root of the datastore. An example datastore path is "[storage] path/to/file.extension". *Since* vSphere API Release 8.0.3.0
datacenter*	ManagedObjectReference to a Datacenter	If `name` is a datastore path, the datacenter for that datastore path is mandatory. Not needed when invoked directly on ESX. If not specified on a call from VirtualCenter, `name` must be a URL. *Since* vSphere API Release 8.0.3.0
uuid*	xsd:string	The hex representation of the unique ID for this virtual disk. If uuid is not set or missing, a random UUID is generated and assigned. *Since* vSphere API Release 8.0.3.0

*Need not be set

Return Value

Type	Description
ManagedObjectReference to a Task

Faults

Type	Description
FileFault	Thrown if an error occurs updating 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

SetVStorageObjectControlFlags(setVStorageObjectControlFlags)

Set control flags on VStorageObject. The control flags are defined in vslmVStorageObjectControlFlag.

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

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

*Need not be set P Required privilege: Datastore.FileManagement

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:vim25="urn:vim25" name="SetVStorageObjectControlFlags" type="vim25:SetVStorageObjectControlFlagsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="SetVStorageObjectControlFlagsResponse">
                  <complexType/>
               </element>

UpdateVStorageInfrastructureObjectPolicy_Task(updateVStorageInfrastructureObjectPolicy)

Assigns specified SBPM policy to the given virtual storage infrastructure object. Only support VSAN datastore.

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

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the VcenterVStorageObjectManager used to make the method call.

spec

vslmInfrastructureObjectPolicySpec

specification to assign a SPBM policy to virtual storage infrastructure object.

Since vSphere API Release 6.7

Return Value

Type	Description
ManagedObjectReference to a Task

Faults

Type	Description
InvalidDatastore	Thrown if the operation cannot be performed on the datastore.
InvalidState	Thrown if there is issue with profile spec.
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.
TaskInProgress

Events

Type
None

UpdateVStorageObjectCrypto_Task(updateVStorageObjectCrypto)

Update the crypto on a virtual storage object. This is also intended for disk encryption, decryption and re-encryption. To encrypt the disk, profile must contain an encryption component. disksCrypto can be left as blank, which means caller doesn't care which key is used to encrypt the disk. If it's not blank, it has to be of type CryptoSpecEncrypt. To decrypt the disk, profile must not contain an encryption component. disksCrypto can be left as blank, if not, it has be of type CryptoSpecDecrypt. To re-encrypt the disk, profile must contain an encryption component. disksCrypto cannot be left as blank. It has to be of type either CryptoSpecShallowRecrypt or CryptoSpecDeepRecrypt.

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

Required Privileges: System.View
Since: vSphere API Release 7.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 7.0
datastore	ManagedObjectReference to a Datastore	The datastore where the virtual storage object is located. *Since* vSphere API Release 7.0
profile*	VirtualMachineProfileSpec[]	New profile requirement on the virtual storage object. *Since* vSphere API Release 7.0
disksCrypto*	DiskCryptoSpec	The crypto information of each disk on the chain. *Since* vSphere API Release 7.0

*Need not be set

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 updating the virtual storage object policy.
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.
TaskInProgress	Thrown if the virtual storage object is busy.

Events

Type
None

UpdateVStorageObjectPolicy_Task(updateVStorageObjectPolicy)

Update the storage policy on a virtual storage object.

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

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 6.7
datastore	ManagedObjectReference to a Datastore	The datastore where the virtual storage object is located. *Since* vSphere API Release 6.7
profile*	VirtualMachineProfileSpec[]	New profile requirement on the virtual storage object. *Since* vSphere API Release 6.7

*Need not be set

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 updating the virtual storage object policy.
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.
TaskInProgress	Thrown if the virtual storage object is busy.

Events

Type
None

VCenterUpdateVStorageObjectMetadataEx_Task(updateVStorageObjectMetadataEx)

Update metadata KV pairs to a virtual storage object and returns the corresponding vclock upon success.

Required Privileges: System.View
Since: vSphere API Release 7.0.2.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 7.0.2.0
datastore	ManagedObjectReference to a Datastore	The datastore to query for the virtual storage objects. *Since* vSphere API Release 7.0.2.0
metadata*	KeyValue[]	array of key/value strings. (keys must be unique within the list) *Since* vSphere API Release 7.0.2.0
deleteKeys*	xsd:string[]	array of keys need to be deleted *Since* vSphere API Release 7.0.2.0

*Need not be set

Return Value

Type	Description
ManagedObjectReference to a Task

Faults

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

VStorageObjectCreateSnapshot_Task(createSnapshot)

Creates a snapshot of a given VStorageObject.

Requires Datastore.FileManagement privilege.

Required Privileges: System.View
Since: vSphere API Release 6.7

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 6.7
datastore	ManagedObjectReference to a Datastore	The datastore where the source virtual storage object is located. *Since* vSphere API Release 6.7
description	xsd:string	A short description to be associated with the snapshot. *Since* vSphere API Release 6.7

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

VstorageObjectVCenterQueryChangedDiskAreas(queryChangedDiskAreas)

Get a list of areas of a virtual disk that have been modified since a well-defined point in the past. The beginning of the change interval is identified by "changeId", while the end of the change interval is implied by the snapshot ID passed in.

Note that the result of this function may contain "false positives" (i.e: flag areas of the disk as modified that are not). However, it is guaranteed that no changes will be missed.

Required Privileges: System.View
Since: vSphere API Release 7.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VcenterVStorageObjectManager used to make the method call.
id	ID	The ID of the virtual storage object. *Since* vSphere API Release 6.7
datastore	ManagedObjectReference to a Datastore	The datastore where the source virtual storage object is located. *Since* vSphere API Release 6.7
snapshotId	ID	The ID of the snapshot of a virtual storage object for which changes that have been made since "changeId" should be computed. *Since* vSphere API Release 6.7
startOffset	xsd:long	Start Offset in bytes at which to start computing changes. Typically, callers will make multiple calls to this function, starting with startOffset 0 and then examine the "length" property in the returned DiskChangeInfo structure, repeatedly calling queryChangedDiskAreas until a map for the entire virtual disk has been obtained. *Since* vSphere API Release 6.7
changeId	xsd:string	Identifier referring to a point in the past that should be used as the point in time at which to begin including changes to the disk in the result. A typical use case would be a backup application obtaining a changeId from a virtual disk's backing info when performing a backup. When a subsequent incremental backup is to be performed, this change Id can be used to obtain a list of changed areas on disk. *Since* vSphere API Release 6.7

Return Value

Type	Description
DiskChangeInfo	Returns a data structure specifying extents of the virtual disk that have changed since the thime the changeId string was obtained.

Faults

Type	Description
FileFault	Thrown if the virtual disk files cannot be accessed/queried.
InvalidArgument	Thrown if startOffset is beyond the end of the virtual disk or changeId is invalid.
InvalidDatastore	Thrown if the operation cannot be performed on the datastore.
InvalidState	Thrown if change tracking is not supported for this particular disk.
NotFound	Thrown if specified virtual storage object or snapshot 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:vim25="urn:vim25" name="VstorageObjectVCenterQueryChangedDiskAreas" type="vim25:VstorageObjectVCenterQueryChangedDiskAreasRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VstorageObjectVCenterQueryChangedDiskAreasResponse">
                  <complexType>
                     <sequence>
                        <element name="returnval" type="vim25:DiskChangeInfo"/>
                     </sequence>
                  </complexType>
               </element>

Test Search vSphere Web Services API

Managed Object - VcenterVStorageObjectManager(vim.vslm.vcenter.VStorageObjectManager)

Managed Object Description

AttachTagToVStorageObject(attachTagToVStorageObject)

ClearVStorageObjectControlFlags(clearVStorageObjectControlFlags)

CloneVStorageObject_Task(cloneVStorageObject)

CreateDisk_Task(createDisk)

CreateDiskFromSnapshot_Task(createDiskFromSnapshot)

DeleteSnapshot_Task(deleteSnapshot)

DeleteVStorageObject_Task(deleteVStorageObject)

DeleteVStorageObjectEx_Task(deleteVStorageObjectEx)

DetachTagFromVStorageObject(detachTagFromVStorageObject)

ExtendDisk_Task(extendDisk)

InflateDisk_Task(inflateDisk)

ListTagsAttachedToVStorageObject(listTagsAttachedToVStorageObject)

ListVStorageObject(listVStorageObject)

ListVStorageObjectsAttachedToTag(listVStorageObjectsAttachedToTag)

QueryVirtualDiskUuidEx(queryVirtualDiskUuidEx)

ReconcileDatastoreInventory_Task(reconcileDatastoreInventory)

RegisterDisk(registerDisk)

RelocateVStorageObject_Task(relocateVStorageObject)

RenameVStorageObject(renameVStorageObject)

RetrieveSnapshotDetails(retrieveSnapshotDetails)

RetrieveSnapshotInfo(retrieveSnapshotInfo)

RetrieveVStorageInfrastructureObjectPolicy(retrieveVStorageInfrastructureObjectPolicy)

RetrieveVStorageObject(retrieveVStorageObject)

RetrieveVStorageObjectAssociations(retrieveVStorageObjectAssociations)

RetrieveVStorageObjectState(retrieveVStorageObjectState)

RevertVStorageObject_Task

ScheduleReconcileDatastoreInventory(scheduleReconcileDatastoreInventory)

SetVirtualDiskUuidEx_Task(setVirtualDiskUuidEx)

SetVStorageObjectControlFlags(setVStorageObjectControlFlags)

UpdateVStorageInfrastructureObjectPolicy_Task(updateVStorageInfrastructureObjectPolicy)

UpdateVStorageObjectCrypto_Task(updateVStorageObjectCrypto)

UpdateVStorageObjectPolicy_Task(updateVStorageObjectPolicy)

VCenterUpdateVStorageObjectMetadataEx_Task(updateVStorageObjectMetadataEx)

VStorageObjectCreateSnapshot_Task(createSnapshot)

VstorageObjectVCenterQueryChangedDiskAreas(queryChangedDiskAreas)