com.vmware.vcenter.vm.hardware

Interface Memory

All Superinterfaces:

MemoryTypes, Service

All Known Implementing Classes:

MemoryStub

public interface Memory
extends Service, MemoryTypes

The Memory interface provides methods for configuring the memory settings of a virtual machine.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.vcenter.vm.hardware.MemoryTypes

MemoryTypes.Info, MemoryTypes.UpdateSpec

Method Summary

Methods

Modifier and Type	Method and Description
MemoryTypes.Info	get(String vm) Returns the memory-related settings of a virtual machine.
void	get(String vm, AsyncCallback<MemoryTypes.Info> asyncCallback) Returns the memory-related settings of a virtual machine.
void	get(String vm, AsyncCallback<MemoryTypes.Info> asyncCallback, InvocationConfig invocationConfig) Returns the memory-related settings of a virtual machine.
MemoryTypes.Info	get(String vm, InvocationConfig invocationConfig) Returns the memory-related settings of a virtual machine.
void	update(String vm, MemoryTypes.UpdateSpec spec) Updates the memory-related settings of a virtual machine.
void	update(String vm, MemoryTypes.UpdateSpec spec, AsyncCallback<Void> asyncCallback) Updates the memory-related settings of a virtual machine.
void	update(String vm, MemoryTypes.UpdateSpec spec, AsyncCallback<Void> asyncCallback, InvocationConfig invocationConfig) Updates the memory-related settings of a virtual machine.
void	update(String vm, MemoryTypes.UpdateSpec spec, InvocationConfig invocationConfig) Updates the memory-related settings of a virtual machine.

Method Detail

get

MemoryTypes.Info get(String vm)

Returns the memory-related settings of a virtual machine.

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

Parameters:

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

Returns:

Memory-related settings of the virtual machine.

Throws:

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.

get

MemoryTypes.Info get(String vm,
                   InvocationConfig invocationConfig)

Returns the memory-related settings of 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.

Parameters:

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

invocationConfig - Configuration for the method invocation.

Returns:

Memory-related settings of the virtual machine.

Throws:

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.

get

void get(String vm,
       AsyncCallback<MemoryTypes.Info> asyncCallback)

Returns the memory-related settings of a virtual machine.

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

Operation Result:
Memory-related settings of the 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.

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

void get(String vm,
       AsyncCallback<MemoryTypes.Info> asyncCallback,
       InvocationConfig invocationConfig)

Returns the memory-related settings of 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 Result:
Memory-related settings of the 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.

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.

update

void update(String vm,
          MemoryTypes.UpdateSpec spec)

Updates the memory-related settings of a virtual machine.

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

Parameters:

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

spec - Specification for updating the memory-related settings of the virtual machine.

Throws:

Error - if the system reports an error while responding to the request.

NotFound - if the virtual machine is not found.

InvalidArgument - if one of the provided settings is not permitted; for example, specifying a negative value for getSizeMiB().

NotAllowedInCurrentState - if getHotAddEnabled() is specified and the virtual machine is not powered off.

NotAllowedInCurrentState - if getSizeMiB() is specified, getHotAddEnabled() is false, and the virtual machine is not powered off.

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.

update

void update(String vm,
          MemoryTypes.UpdateSpec spec,
          InvocationConfig invocationConfig)

Updates the memory-related settings of 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.

Parameters:

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

spec - Specification for updating the memory-related settings of the virtual machine.

invocationConfig - Configuration for the method invocation.

Throws:

Error - if the system reports an error while responding to the request.

NotFound - if the virtual machine is not found.

InvalidArgument - if one of the provided settings is not permitted; for example, specifying a negative value for getSizeMiB().

NotAllowedInCurrentState - if getHotAddEnabled() is specified and the virtual machine is not powered off.

NotAllowedInCurrentState - if getSizeMiB() is specified, getHotAddEnabled() is false, and the virtual machine is not powered off.

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.

update

void update(String vm,
          MemoryTypes.UpdateSpec spec,
          AsyncCallback<Void> asyncCallback)

Updates the memory-related settings of 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.
NotFound - if the virtual machine is not found.
InvalidArgument - if one of the provided settings is not permitted; for example, specifying a negative value for getSizeMiB().
NotAllowedInCurrentState - if getHotAddEnabled() is specified and the virtual machine is not powered off.
NotAllowedInCurrentState - if getSizeMiB() is specified, getHotAddEnabled() is false, and the virtual machine is not powered off.
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.

Parameters:

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

spec - Specification for updating the memory-related settings of the virtual machine.

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

update

void update(String vm,
          MemoryTypes.UpdateSpec spec,
          AsyncCallback<Void> asyncCallback,
          InvocationConfig invocationConfig)

Updates the memory-related settings of 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.
NotFound - if the virtual machine is not found.
InvalidArgument - if one of the provided settings is not permitted; for example, specifying a negative value for getSizeMiB().
NotAllowedInCurrentState - if getHotAddEnabled() is specified and the virtual machine is not powered off.
NotAllowedInCurrentState - if getSizeMiB() is specified, getHotAddEnabled() is false, and the virtual machine is not powered off.
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.

Parameters:

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

spec - Specification for updating the memory-related settings of the virtual machine.

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

invocationConfig - Configuration for the method invocation.