com.vmware.vcenter

Class VMStub

java.lang.Object

com.vmware.vapi.internal.bindings.Stub

com.vmware.vcenter.VMStub

All Implemented Interfaces:

Service, VM, VMTypes

public class VMStub
extends com.vmware.vapi.internal.bindings.Stub
implements VM

Remote stub implementation of the VM API service.

WARNING: Internal class, subject to change in future versions.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.vcenter.VMTypes

VMTypes._VAPI_OPERATIONS, VMTypes.ClonePlacementSpec, VMTypes.CloneSpec, VMTypes.ComputePlacementSpec, VMTypes.CreateSpec, VMTypes.DiskCloneSpec, VMTypes.DiskRelocateSpec, VMTypes.FilterSpec, VMTypes.GuestCustomizationSpec, VMTypes.Info, VMTypes.InstantClonePlacementSpec, VMTypes.InstantCloneSpec, VMTypes.InventoryPlacementSpec, VMTypes.PlacementSpec, VMTypes.RegisterPlacementSpec, VMTypes.RegisterSpec, VMTypes.RelocatePlacementSpec, VMTypes.RelocateSpec, VMTypes.StoragePlacementSpec, VMTypes.StoragePolicySpec, VMTypes.Summary

Field Summary

Fields inherited from class com.vmware.vapi.internal.bindings.Stub

apiProvider, converter, ifaceId, retryPolicy, securityContext

Fields inherited from interface com.vmware.vcenter.VMTypes

_VAPI_SERVICE_ID, RESOURCE_TYPE

Constructor Summary

Constructors

Constructor and Description
VMStub(ApiProvider apiProvider, StubConfigurationBase config)
VMStub(ApiProvider apiProvider, com.vmware.vapi.internal.bindings.TypeConverter typeConverter, StubConfigurationBase config)

Method Summary

Modifier and Type	Method and Description
java.lang.String	clone_Task(VMTypes.CloneSpec spec) Creates a virtual machine from an existing virtual machine.
void	clone_Task(VMTypes.CloneSpec spec, AsyncCallback<java.lang.String> asyncCallback) Creates a virtual machine from an existing virtual machine.
void	clone_Task(VMTypes.CloneSpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Creates a virtual machine from an existing virtual machine.
java.lang.String	clone_Task(VMTypes.CloneSpec spec, InvocationConfig invocationConfig) Creates a virtual machine from an existing virtual machine.
java.lang.String	clone(VMTypes.CloneSpec spec) Creates a virtual machine from an existing virtual machine.
void	clone(VMTypes.CloneSpec spec, AsyncCallback<java.lang.String> asyncCallback) Creates a virtual machine from an existing virtual machine.
void	clone(VMTypes.CloneSpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Creates a virtual machine from an existing virtual machine.
java.lang.String	clone(VMTypes.CloneSpec spec, InvocationConfig invocationConfig) Creates a virtual machine from an existing virtual machine.
java.lang.String	create(VMTypes.CreateSpec spec) Creates a virtual machine.
void	create(VMTypes.CreateSpec spec, AsyncCallback<java.lang.String> asyncCallback) Creates a virtual machine.
void	create(VMTypes.CreateSpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Creates a virtual machine.
java.lang.String	create(VMTypes.CreateSpec spec, InvocationConfig invocationConfig) Creates a virtual machine.
void	delete(java.lang.String vm) Deletes a virtual machine.
void	delete(java.lang.String vm, AsyncCallback<java.lang.Void> asyncCallback) Deletes a virtual machine.
void	delete(java.lang.String vm, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Deletes a virtual machine.
void	delete(java.lang.String vm, InvocationConfig invocationConfig) Deletes a virtual machine.
VMTypes.Info	get(java.lang.String vm) Returns information about a virtual machine.
void	get(java.lang.String vm, AsyncCallback<VMTypes.Info> asyncCallback) Returns information about a virtual machine.
void	get(java.lang.String vm, AsyncCallback<VMTypes.Info> asyncCallback, InvocationConfig invocationConfig) Returns information about a virtual machine.
VMTypes.Info	get(java.lang.String vm, InvocationConfig invocationConfig) Returns information about a virtual machine.
java.lang.String	instantClone(VMTypes.InstantCloneSpec spec) Create an instant clone of an existing virtual machine.
void	instantClone(VMTypes.InstantCloneSpec spec, AsyncCallback<java.lang.String> asyncCallback) Create an instant clone of an existing virtual machine.
void	instantClone(VMTypes.InstantCloneSpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Create an instant clone of an existing virtual machine.
java.lang.String	instantClone(VMTypes.InstantCloneSpec spec, InvocationConfig invocationConfig) Create an instant clone of an existing virtual machine.
java.util.List<VMTypes.Summary>	list(VMTypes.FilterSpec filter) Returns information about at most 4000 visible (subject to permission checks) virtual machines in vCenter matching the VMTypes.FilterSpec.
void	list(VMTypes.FilterSpec filter, AsyncCallback<java.util.List<VMTypes.Summary>> asyncCallback) Returns information about at most 4000 visible (subject to permission checks) virtual machines in vCenter matching the VMTypes.FilterSpec.
void	list(VMTypes.FilterSpec filter, AsyncCallback<java.util.List<VMTypes.Summary>> asyncCallback, InvocationConfig invocationConfig) Returns information about at most 4000 visible (subject to permission checks) virtual machines in vCenter matching the VMTypes.FilterSpec.
java.util.List<VMTypes.Summary>	list(VMTypes.FilterSpec filter, InvocationConfig invocationConfig) Returns information about at most 4000 visible (subject to permission checks) virtual machines in vCenter matching the VMTypes.FilterSpec.
java.lang.String	register(VMTypes.RegisterSpec spec) Creates a virtual machine from existing virtual machine files on storage.
void	register(VMTypes.RegisterSpec spec, AsyncCallback<java.lang.String> asyncCallback) Creates a virtual machine from existing virtual machine files on storage.
void	register(VMTypes.RegisterSpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Creates a virtual machine from existing virtual machine files on storage.
java.lang.String	register(VMTypes.RegisterSpec spec, InvocationConfig invocationConfig) Creates a virtual machine from existing virtual machine files on storage.
java.lang.String	relocate_Task(java.lang.String vm, VMTypes.RelocateSpec spec) Relocates a virtual machine based on the specification.
void	relocate_Task(java.lang.String vm, VMTypes.RelocateSpec spec, AsyncCallback<java.lang.String> asyncCallback) Relocates a virtual machine based on the specification.
void	relocate_Task(java.lang.String vm, VMTypes.RelocateSpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Relocates a virtual machine based on the specification.
java.lang.String	relocate_Task(java.lang.String vm, VMTypes.RelocateSpec spec, InvocationConfig invocationConfig) Relocates a virtual machine based on the specification.
void	relocate(java.lang.String vm, VMTypes.RelocateSpec spec) Relocates a virtual machine based on the specification.
void	relocate(java.lang.String vm, VMTypes.RelocateSpec spec, AsyncCallback<java.lang.Void> asyncCallback) Relocates a virtual machine based on the specification.
void	relocate(java.lang.String vm, VMTypes.RelocateSpec spec, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Relocates a virtual machine based on the specification.
void	relocate(java.lang.String vm, VMTypes.RelocateSpec spec, InvocationConfig invocationConfig) Relocates a virtual machine based on the specification.
void	unregister(java.lang.String vm) Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine's files from storage.
void	unregister(java.lang.String vm, AsyncCallback<java.lang.Void> asyncCallback) Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine's files from storage.
void	unregister(java.lang.String vm, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine's files from storage.
void	unregister(java.lang.String vm, InvocationConfig invocationConfig) Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine's files from storage.

Methods inherited from class com.vmware.vapi.internal.bindings.Stub

invokeMethod, invokeMethodAsync, invokeStreamMethod, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

VMStub

public VMStub(ApiProvider apiProvider,
              com.vmware.vapi.internal.bindings.TypeConverter typeConverter,
              StubConfigurationBase config)

VMStub

public VMStub(ApiProvider apiProvider,
              StubConfigurationBase config)

Method Detail

create

public java.lang.String create(VMTypes.CreateSpec spec)

Description copied from interface: VM

Creates a virtual machine.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

create in interface VM

Parameters:

spec - Virtual machine specification.

Returns:

ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

create

public java.lang.String create(VMTypes.CreateSpec spec,
                               InvocationConfig invocationConfig)

Description copied from interface: VM

Creates a virtual machine.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

create in interface VM

Parameters:

spec - Virtual machine specification.

invocationConfig - Configuration for the method invocation.

Returns:

ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

create

public void create(VMTypes.CreateSpec spec,
                   AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: VM

Creates a virtual machine.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ResourceInUse - if any of the specified storage addresses (eg. IDE, SATA, SCSI, NVMe) result in a storage address conflict.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to create the virtual machine could not be allocated.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unsupported - if getGuestOS() is not supported for the requested virtual hardware version and spec includes null properties that default to guest-specific values.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource Folder referenced by the property VMTypes.InventoryPlacementSpec.getFolder() requires VirtualMachine.Inventory.Create.
• The resource ResourcePool referenced by the property VMTypes.ComputePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.
• The resource Datastore referenced by the property VMTypes.StoragePlacementSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Network referenced by the property EthernetTypes.BackingSpec.getNetwork() requires Network.Assign.

Specified by:

create in interface VM

Parameters:

spec - Virtual machine specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

create

public void create(VMTypes.CreateSpec spec,
                   AsyncCallback<java.lang.String> asyncCallback,
                   InvocationConfig invocationConfig)

Description copied from interface: VM

Creates a virtual machine.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ResourceInUse - if any of the specified storage addresses (eg. IDE, SATA, SCSI, NVMe) result in a storage address conflict.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to create the virtual machine could not be allocated.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unsupported - if getGuestOS() is not supported for the requested virtual hardware version and spec includes null properties that default to guest-specific values.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource Folder referenced by the property VMTypes.InventoryPlacementSpec.getFolder() requires VirtualMachine.Inventory.Create.
• The resource ResourcePool referenced by the property VMTypes.ComputePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.
• The resource Datastore referenced by the property VMTypes.StoragePlacementSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Network referenced by the property EthernetTypes.BackingSpec.getNetwork() requires Network.Assign.

Specified by:

create in interface VM

Parameters:

spec - Virtual machine specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

clone

public java.lang.String clone(VMTypes.CloneSpec spec)

Description copied from interface: VM

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.0.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

clone in interface VM

Parameters:

spec - Virtual machine clone specification.

Returns:

ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

clone

public java.lang.String clone(VMTypes.CloneSpec spec,
                              InvocationConfig invocationConfig)

Description copied from interface: VM

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.0.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

clone in interface VM

Parameters:

spec - Virtual machine clone specification.

invocationConfig - Configuration for the method invocation.

Returns:

ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

clone_Task

public java.lang.String clone_Task(VMTypes.CloneSpec spec)

Description copied from interface: VM

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.0.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method.

Specified by:

clone_Task in interface VM

Parameters:

spec - Virtual machine clone specification.

Returns:

identifier for the task created by this API invocation

clone_Task

public java.lang.String clone_Task(VMTypes.CloneSpec spec,
                                   InvocationConfig invocationConfig)

Description copied from interface: VM

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.0.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

clone_Task in interface VM

Parameters:

spec - Virtual machine clone specification.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

clone_Task

public void clone_Task(VMTypes.CloneSpec spec,
                       AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: VM

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.0.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to clone the virtual machine could not be allocated.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource Datastore referenced by the property VMTypes.DiskCloneSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Datastore referenced by the property VMTypes.ClonePlacementSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Folder referenced by the property VMTypes.ClonePlacementSpec.getFolder() requires VirtualMachine.Inventory.CreateFromExisting.
• The resource ResourcePool referenced by the property VMTypes.ClonePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.
• The resource VirtualMachine referenced by the property VMTypes.CloneSpec.getSource() requires VirtualMachine.Provisioning.Clone.

Specified by:

clone_Task in interface VM

Parameters:

spec - Virtual machine clone specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

clone_Task

public void clone_Task(VMTypes.CloneSpec spec,
                       AsyncCallback<java.lang.String> asyncCallback,
                       InvocationConfig invocationConfig)

Description copied from interface: VM

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.0.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to clone the virtual machine could not be allocated.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource Datastore referenced by the property VMTypes.DiskCloneSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Datastore referenced by the property VMTypes.ClonePlacementSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Folder referenced by the property VMTypes.ClonePlacementSpec.getFolder() requires VirtualMachine.Inventory.CreateFromExisting.
• The resource ResourcePool referenced by the property VMTypes.ClonePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.
• The resource VirtualMachine referenced by the property VMTypes.CloneSpec.getSource() requires VirtualMachine.Provisioning.Clone.

Specified by:

clone_Task in interface VM

Parameters:

spec - Virtual machine clone specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

clone

public void clone(VMTypes.CloneSpec spec,
                  AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: VM

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.0.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to clone the virtual machine could not be allocated.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource Datastore referenced by the property VMTypes.DiskCloneSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Datastore referenced by the property VMTypes.ClonePlacementSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Folder referenced by the property VMTypes.ClonePlacementSpec.getFolder() requires VirtualMachine.Inventory.CreateFromExisting.
• The resource ResourcePool referenced by the property VMTypes.ClonePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.
• The resource VirtualMachine referenced by the property VMTypes.CloneSpec.getSource() requires VirtualMachine.Provisioning.Clone.

Specified by:

clone in interface VM

Parameters:

spec - Virtual machine clone specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

clone

public void clone(VMTypes.CloneSpec spec,
                  AsyncCallback<java.lang.String> asyncCallback,
                  InvocationConfig invocationConfig)

Description copied from interface: VM

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.0.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to clone the virtual machine could not be allocated.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource Datastore referenced by the property VMTypes.DiskCloneSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Datastore referenced by the property VMTypes.ClonePlacementSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Folder referenced by the property VMTypes.ClonePlacementSpec.getFolder() requires VirtualMachine.Inventory.CreateFromExisting.
• The resource ResourcePool referenced by the property VMTypes.ClonePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.
• The resource VirtualMachine referenced by the property VMTypes.CloneSpec.getSource() requires VirtualMachine.Provisioning.Clone.

Specified by:

clone in interface VM

Parameters:

spec - Virtual machine clone specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

relocate

public void relocate(java.lang.String vm,
                     VMTypes.RelocateSpec spec)

Description copied from interface: VM

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.0.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

relocate in interface VM

Parameters:

vm - Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Relocate specification.

relocate

public void relocate(java.lang.String vm,
                     VMTypes.RelocateSpec spec,
                     InvocationConfig invocationConfig)

Description copied from interface: VM

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.0.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

relocate in interface VM

Parameters:

vm - Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Relocate specification.

invocationConfig - Configuration for the method invocation.

relocate_Task

public java.lang.String relocate_Task(java.lang.String vm,
                                      VMTypes.RelocateSpec spec)

Description copied from interface: VM

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.0.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method.

Specified by:

relocate_Task in interface VM

Parameters:

vm - Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Relocate specification.

Returns:

identifier for the task created by this API invocation

relocate_Task

public java.lang.String relocate_Task(java.lang.String vm,
                                      VMTypes.RelocateSpec spec,
                                      InvocationConfig invocationConfig)

Description copied from interface: VM

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.0.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

relocate_Task in interface VM

Parameters:

vm - Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Relocate specification.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

relocate_Task

public void relocate_Task(java.lang.String vm,
                          VMTypes.RelocateSpec spec,
                          AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: VM

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.0.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec or the given "vm" could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires Resource.ColdMigrate.
• The resource ResourcePool referenced by the property VMTypes.RelocatePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.

Specified by:

relocate_Task in interface VM

Parameters:

vm - Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Relocate specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

relocate_Task

public void relocate_Task(java.lang.String vm,
                          VMTypes.RelocateSpec spec,
                          AsyncCallback<java.lang.String> asyncCallback,
                          InvocationConfig invocationConfig)

Description copied from interface: VM

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.0.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec or the given "vm" could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires Resource.ColdMigrate.
• The resource ResourcePool referenced by the property VMTypes.RelocatePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.

Specified by:

relocate_Task in interface VM

Parameters:

vm - Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Relocate specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

relocate

public void relocate(java.lang.String vm,
                     VMTypes.RelocateSpec spec,
                     AsyncCallback<java.lang.Void> asyncCallback)

Description copied from interface: VM

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.0.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Operation Errors:
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec or the given "vm" could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires Resource.ColdMigrate.
• The resource ResourcePool referenced by the property VMTypes.RelocatePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.

Specified by:

relocate in interface VM

Parameters:

vm - Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Relocate specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

relocate

public void relocate(java.lang.String vm,
                     VMTypes.RelocateSpec spec,
                     AsyncCallback<java.lang.Void> asyncCallback,
                     InvocationConfig invocationConfig)

Description copied from interface: VM

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.0.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Operation Errors:
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec or the given "vm" could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires Resource.ColdMigrate.
• The resource ResourcePool referenced by the property VMTypes.RelocatePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.

Specified by:

relocate in interface VM

Parameters:

vm - Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Relocate specification.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

instantClone

public java.lang.String instantClone(VMTypes.InstantCloneSpec spec)

Description copied from interface: VM

Create an instant clone of an existing virtual machine. This method was added in vSphere API 6.7.1.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

instantClone in interface VM

Parameters:

spec - Virtual machine InstantCloneSpec.

Returns:

ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

instantClone

public java.lang.String instantClone(VMTypes.InstantCloneSpec spec,
                                     InvocationConfig invocationConfig)

Description copied from interface: VM

Create an instant clone of an existing virtual machine. This method was added in vSphere API 6.7.1.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

instantClone in interface VM

Parameters:

spec - Virtual machine InstantCloneSpec.

invocationConfig - Configuration for the method invocation.

Returns:

ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

instantClone

public void instantClone(VMTypes.InstantCloneSpec spec,
                         AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: VM

Create an instant clone of an existing virtual machine. This method was added in vSphere API 6.7.1.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to create an instant clone could not be allocated.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the property VMTypes.InstantCloneSpec.getSource() requires VirtualMachine.Provisioning.Clone and VirtualMachine.Inventory.CreateFromExisting.
• The resource Folder referenced by the property VMTypes.InstantClonePlacementSpec.getFolder() requires VirtualMachine.Interact.PowerOn.
• The resource ResourcePool referenced by the property VMTypes.InstantClonePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.
• The resource Datastore referenced by the property VMTypes.InstantClonePlacementSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Network referenced by the property EthernetTypes.BackingSpec.getNetwork() requires Network.Assign.

Specified by:

instantClone in interface VM

Parameters:

spec - Virtual machine InstantCloneSpec.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

instantClone

public void instantClone(VMTypes.InstantCloneSpec spec,
                         AsyncCallback<java.lang.String> asyncCallback,
                         InvocationConfig invocationConfig)

Description copied from interface: VM

Create an instant clone of an existing virtual machine. This method was added in vSphere API 6.7.1.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to create an instant clone could not be allocated.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the property VMTypes.InstantCloneSpec.getSource() requires VirtualMachine.Provisioning.Clone and VirtualMachine.Inventory.CreateFromExisting.
• The resource Folder referenced by the property VMTypes.InstantClonePlacementSpec.getFolder() requires VirtualMachine.Interact.PowerOn.
• The resource ResourcePool referenced by the property VMTypes.InstantClonePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.
• The resource Datastore referenced by the property VMTypes.InstantClonePlacementSpec.getDatastore() requires Datastore.AllocateSpace.
• The resource Network referenced by the property EthernetTypes.BackingSpec.getNetwork() requires Network.Assign.

Specified by:

instantClone in interface VM

Parameters:

spec - Virtual machine InstantCloneSpec.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

get

public VMTypes.Info get(java.lang.String vm)

Description copied from interface: VM

Returns information about a virtual machine.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

get in interface VM

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

Returns:

Information about the specified virtual machine.

get

public VMTypes.Info get(java.lang.String vm,
                        InvocationConfig invocationConfig)

Description copied from interface: VM

Returns information about a virtual machine.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

get in interface VM

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

invocationConfig - Configuration for the method invocation.

Returns:

Information about the specified virtual machine.

get

public void get(java.lang.String vm,
                AsyncCallback<VMTypes.Info> asyncCallback)

Description copied from interface: VM

Returns information about a virtual machine.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
Information about the specified virtual machine.

Operation Errors:
Error - if the system reports an error while responding to the request.
NotFound - if the virtual machine is not found.
ResourceInaccessible - if the virtual machine's configuration state cannot be accessed.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires System.Read.

Specified by:

get in interface VM

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

get

public void get(java.lang.String vm,
                AsyncCallback<VMTypes.Info> asyncCallback,
                InvocationConfig invocationConfig)

Description copied from interface: VM

Returns information about a virtual machine.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
Information about the specified virtual machine.

Operation Errors:
Error - if the system reports an error while responding to the request.
NotFound - if the virtual machine is not found.
ResourceInaccessible - if the virtual machine's configuration state cannot be accessed.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires System.Read.

Specified by:

get in interface VM

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

delete

public void delete(java.lang.String vm)

Description copied from interface: VM

Deletes a virtual machine.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

delete in interface VM

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

delete

public void delete(java.lang.String vm,
                   InvocationConfig invocationConfig)

Description copied from interface: VM

Deletes a virtual machine.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

delete in interface VM

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

invocationConfig - Configuration for the method invocation.

delete

public void delete(java.lang.String vm,
                   AsyncCallback<java.lang.Void> asyncCallback)

Description copied from interface: VM

Deletes a virtual machine.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Operation Errors:
Error - if the system reports an error while responding to the request.
NotAllowedInCurrentState - if the virtual machine is running (powered on).
NotFound - if the virtual machine is not found.
ResourceBusy - if the virtual machine is busy performing another operation.
ResourceInaccessible - if the virtual machine's configuration state cannot be accessed.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Inventory.Delete.

Specified by:

delete in interface VM

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

delete

public void delete(java.lang.String vm,
                   AsyncCallback<java.lang.Void> asyncCallback,
                   InvocationConfig invocationConfig)

Description copied from interface: VM

Deletes a virtual machine.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Operation Errors:
Error - if the system reports an error while responding to the request.
NotAllowedInCurrentState - if the virtual machine is running (powered on).
NotFound - if the virtual machine is not found.
ResourceBusy - if the virtual machine is busy performing another operation.
ResourceInaccessible - if the virtual machine's configuration state cannot be accessed.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Inventory.Delete.

Specified by:

delete in interface VM

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

list

public java.util.List<VMTypes.Summary> list(VMTypes.FilterSpec filter)

Description copied from interface: VM

Returns information about at most 4000 visible (subject to permission checks) virtual machines in vCenter matching the VMTypes.FilterSpec.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

list in interface VM

Parameters:

filter - Specification of matching virtual machines for which information should be returned. If null, the behavior is equivalent to a VMTypes.FilterSpec with all properties null which means all virtual machines match the filter.

Returns:

Commonly used information about the virtual machines matching the VMTypes.FilterSpec.

list

public java.util.List<VMTypes.Summary> list(VMTypes.FilterSpec filter,
                                            InvocationConfig invocationConfig)

Description copied from interface: VM

Returns information about at most 4000 visible (subject to permission checks) virtual machines in vCenter matching the VMTypes.FilterSpec.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

list in interface VM

Parameters:

filter - Specification of matching virtual machines for which information should be returned. If null, the behavior is equivalent to a VMTypes.FilterSpec with all properties null which means all virtual machines match the filter.

invocationConfig - Configuration for the method invocation.

Returns:

Commonly used information about the virtual machines matching the VMTypes.FilterSpec.

list

public void list(VMTypes.FilterSpec filter,
                 AsyncCallback<java.util.List<VMTypes.Summary>> asyncCallback)

Description copied from interface: VM

Returns information about at most 4000 visible (subject to permission checks) virtual machines in vCenter matching the VMTypes.FilterSpec.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
Commonly used information about the virtual machines matching the VMTypes.FilterSpec.

Operation Errors:
InvalidArgument - if the VMTypes.FilterSpec.getPowerStates() property contains a value that is not supported by the server.
UnableToAllocateResource - if more than 4000 virtual machines match the VMTypes.FilterSpec.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.

Specified by:

list in interface VM

Parameters:

filter - Specification of matching virtual machines for which information should be returned. If null, the behavior is equivalent to a VMTypes.FilterSpec with all properties null which means all virtual machines match the filter.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

list

public void list(VMTypes.FilterSpec filter,
                 AsyncCallback<java.util.List<VMTypes.Summary>> asyncCallback,
                 InvocationConfig invocationConfig)

Description copied from interface: VM

Returns information about at most 4000 visible (subject to permission checks) virtual machines in vCenter matching the VMTypes.FilterSpec.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
Commonly used information about the virtual machines matching the VMTypes.FilterSpec.

Operation Errors:
InvalidArgument - if the VMTypes.FilterSpec.getPowerStates() property contains a value that is not supported by the server.
UnableToAllocateResource - if more than 4000 virtual machines match the VMTypes.FilterSpec.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.

Specified by:

list in interface VM

Parameters:

filter - Specification of matching virtual machines for which information should be returned. If null, the behavior is equivalent to a VMTypes.FilterSpec with all properties null which means all virtual machines match the filter.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

register

public java.lang.String register(VMTypes.RegisterSpec spec)

Description copied from interface: VM

Creates a virtual machine from existing virtual machine files on storage. This method was added in vSphere API 6.8.7.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

register in interface VM

Parameters:

spec - Specification of the location of the virtual machine files and the placement of the new virtual machine.

Returns:

Identifier of the newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

register

public java.lang.String register(VMTypes.RegisterSpec spec,
                                 InvocationConfig invocationConfig)

Description copied from interface: VM

Creates a virtual machine from existing virtual machine files on storage. This method was added in vSphere API 6.8.7.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

register in interface VM

Parameters:

spec - Specification of the location of the virtual machine files and the placement of the new virtual machine.

invocationConfig - Configuration for the method invocation.

Returns:

Identifier of the newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

register

public void register(VMTypes.RegisterSpec spec,
                     AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: VM

Creates a virtual machine from existing virtual machine files on storage. This method was added in vSphere API 6.8.7.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
Identifier of the newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists or if a virtual machine using the specified virtual machine files already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found.
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to register the virtual machine could not be allocated.
Unauthenticated - if the user cannot be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource Datastore referenced by the property VMTypes.RegisterSpec.getDatastore() requires System.Read.
• The resource Folder referenced by the property VMTypes.InventoryPlacementSpec.getFolder() requires VirtualMachine.Inventory.Register.
• The resource ResourcePool referenced by the property VMTypes.ComputePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.

Specified by:

register in interface VM

Parameters:

spec - Specification of the location of the virtual machine files and the placement of the new virtual machine.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

register

public void register(VMTypes.RegisterSpec spec,
                     AsyncCallback<java.lang.String> asyncCallback,
                     InvocationConfig invocationConfig)

Description copied from interface: VM

Creates a virtual machine from existing virtual machine files on storage. This method was added in vSphere API 6.8.7.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
Identifier of the newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.

Operation Errors:
AlreadyExists - if a virtual machine with the specified name already exists or if a virtual machine using the specified virtual machine files already exists.
Error - if the system reports an error while responding to the request.
InvalidArgument - if any of the specified parameters are invalid.
NotFound - if any of the resources specified in spec could not be found.
ResourceInaccessible - if a specified resource (eg. host) is not accessible.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
UnableToAllocateResource - if any of the resources needed to register the virtual machine could not be allocated.
Unauthenticated - if the user cannot be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource Datastore referenced by the property VMTypes.RegisterSpec.getDatastore() requires System.Read.
• The resource Folder referenced by the property VMTypes.InventoryPlacementSpec.getFolder() requires VirtualMachine.Inventory.Register.
• The resource ResourcePool referenced by the property VMTypes.ComputePlacementSpec.getResourcePool() requires Resource.AssignVMToPool.

Specified by:

register in interface VM

Parameters:

spec - Specification of the location of the virtual machine files and the placement of the new virtual machine.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

unregister

public void unregister(java.lang.String vm)

Description copied from interface: VM

Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine's files from storage. All high-level information stored with the management server (ESXi or vCenter) is removed, including information such as statistics, resource pool association, permissions, and alarms. This method was added in vSphere API 6.8.7.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

unregister in interface VM

Parameters:

vm - Identifier of the virtual machine to be unregistered. The parameter must be an identifier for the resource type: VirtualMachine.

unregister

public void unregister(java.lang.String vm,
                       InvocationConfig invocationConfig)

Description copied from interface: VM

Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine's files from storage. All high-level information stored with the management server (ESXi or vCenter) is removed, including information such as statistics, resource pool association, permissions, and alarms. This method was added in vSphere API 6.8.7.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

unregister in interface VM

Parameters:

vm - Identifier of the virtual machine to be unregistered. The parameter must be an identifier for the resource type: VirtualMachine.

invocationConfig - Configuration for the method invocation.

unregister

public void unregister(java.lang.String vm,
                       AsyncCallback<java.lang.Void> asyncCallback)

Description copied from interface: VM

Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine's files from storage. All high-level information stored with the management server (ESXi or vCenter) is removed, including information such as statistics, resource pool association, permissions, and alarms. This method was added in vSphere API 6.8.7.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Operation Errors:
NotAllowedInCurrentState - if the virtual machine is running (powered on).
NotFound - if there is no virtual machine associated with vm in the system.
ResourceBusy - if the virtual machine is busy performing another operation.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Inventory.Unregister.

Specified by:

unregister in interface VM

Parameters:

vm - Identifier of the virtual machine to be unregistered. The parameter must be an identifier for the resource type: VirtualMachine.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

unregister

public void unregister(java.lang.String vm,
                       AsyncCallback<java.lang.Void> asyncCallback,
                       InvocationConfig invocationConfig)

Description copied from interface: VM

Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine's files from storage. All high-level information stored with the management server (ESXi or vCenter) is removed, including information such as statistics, resource pool association, permissions, and alarms. This method was added in vSphere API 6.8.7.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Operation Errors:
NotAllowedInCurrentState - if the virtual machine is running (powered on).
NotFound - if there is no virtual machine associated with vm in the system.
ResourceBusy - if the virtual machine is busy performing another operation.
ServiceUnavailable - if the system is unable to communicate with a service to complete the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Inventory.Unregister.

Specified by:

unregister in interface VM

Parameters:

vm - Identifier of the virtual machine to be unregistered. The parameter must be an identifier for the resource type: VirtualMachine.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.