com.vmware.vcenter.vm.hardware

Class EthernetStub

java.lang.Object

com.vmware.vapi.internal.bindings.Stub

com.vmware.vcenter.vm.hardware.EthernetStub

All Implemented Interfaces:

Service, Ethernet, EthernetTypes

public class EthernetStub
extends com.vmware.vapi.internal.bindings.Stub
implements Ethernet

Remote stub implementation of the Ethernet API service.

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

Nested Class Summary

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

EthernetTypes.BackingInfo, EthernetTypes.BackingSpec, EthernetTypes.BackingType, EthernetTypes.CreateSpec, EthernetTypes.EmulationType, EthernetTypes.Info, EthernetTypes.MacAddressType, EthernetTypes.Summary, EthernetTypes.UpdateSpec

Field Summary

Fields inherited from interface com.vmware.vcenter.vm.hardware.EthernetTypes

RESOURCE_TYPE

Constructor Summary

Constructors

Constructor and Description
EthernetStub(ApiProvider apiProvider, StubConfigurationBase config)

Method Summary

Methods

Modifier and Type	Method and Description
void	connect(String vm, String nic) Connects a virtual Ethernet adapter of a powered-on virtual machine to its backing.
void	connect(String vm, String nic, AsyncCallback<Void> asyncCallback) Connects a virtual Ethernet adapter of a powered-on virtual machine to its backing.
void	connect(String vm, String nic, AsyncCallback<Void> asyncCallback, InvocationConfig invocationConfig) Connects a virtual Ethernet adapter of a powered-on virtual machine to its backing.
void	connect(String vm, String nic, InvocationConfig invocationConfig) Connects a virtual Ethernet adapter of a powered-on virtual machine to its backing.
String	create(String vm, EthernetTypes.CreateSpec spec) Adds a virtual Ethernet adapter to the virtual machine.
void	create(String vm, EthernetTypes.CreateSpec spec, AsyncCallback<String> asyncCallback) Adds a virtual Ethernet adapter to the virtual machine.
void	create(String vm, EthernetTypes.CreateSpec spec, AsyncCallback<String> asyncCallback, InvocationConfig invocationConfig) Adds a virtual Ethernet adapter to the virtual machine.
String	create(String vm, EthernetTypes.CreateSpec spec, InvocationConfig invocationConfig) Adds a virtual Ethernet adapter to the virtual machine.
void	delete(String vm, String nic) Removes a virtual Ethernet adapter from the virtual machine.
void	delete(String vm, String nic, AsyncCallback<Void> asyncCallback) Removes a virtual Ethernet adapter from the virtual machine.
void	delete(String vm, String nic, AsyncCallback<Void> asyncCallback, InvocationConfig invocationConfig) Removes a virtual Ethernet adapter from the virtual machine.
void	delete(String vm, String nic, InvocationConfig invocationConfig) Removes a virtual Ethernet adapter from the virtual machine.
void	disconnect(String vm, String nic) Disconnects a virtual Ethernet adapter of a powered-on virtual machine from its backing.
void	disconnect(String vm, String nic, AsyncCallback<Void> asyncCallback) Disconnects a virtual Ethernet adapter of a powered-on virtual machine from its backing.
void	disconnect(String vm, String nic, AsyncCallback<Void> asyncCallback, InvocationConfig invocationConfig) Disconnects a virtual Ethernet adapter of a powered-on virtual machine from its backing.
void	disconnect(String vm, String nic, InvocationConfig invocationConfig) Disconnects a virtual Ethernet adapter of a powered-on virtual machine from its backing.
EthernetTypes.Info	get(String vm, String nic) Returns information about a virtual Ethernet adapter.
void	get(String vm, String nic, AsyncCallback<EthernetTypes.Info> asyncCallback) Returns information about a virtual Ethernet adapter.
void	get(String vm, String nic, AsyncCallback<EthernetTypes.Info> asyncCallback, InvocationConfig invocationConfig) Returns information about a virtual Ethernet adapter.
EthernetTypes.Info	get(String vm, String nic, InvocationConfig invocationConfig) Returns information about a virtual Ethernet adapter.
List<EthernetTypes.Summary>	list(String vm) Returns commonly used information about the virtual Ethernet adapters belonging to the virtual machine.
void	list(String vm, AsyncCallback<List<EthernetTypes.Summary>> asyncCallback) Returns commonly used information about the virtual Ethernet adapters belonging to the virtual machine.
void	list(String vm, AsyncCallback<List<EthernetTypes.Summary>> asyncCallback, InvocationConfig invocationConfig) Returns commonly used information about the virtual Ethernet adapters belonging to the virtual machine.
List<EthernetTypes.Summary>	list(String vm, InvocationConfig invocationConfig) Returns commonly used information about the virtual Ethernet adapters belonging to the virtual machine.
void	update(String vm, String nic, EthernetTypes.UpdateSpec spec) Updates the configuration of a virtual Ethernet adapter.
void	update(String vm, String nic, EthernetTypes.UpdateSpec spec, AsyncCallback<Void> asyncCallback) Updates the configuration of a virtual Ethernet adapter.
void	update(String vm, String nic, EthernetTypes.UpdateSpec spec, AsyncCallback<Void> asyncCallback, InvocationConfig invocationConfig) Updates the configuration of a virtual Ethernet adapter.
void	update(String vm, String nic, EthernetTypes.UpdateSpec spec, InvocationConfig invocationConfig) Updates the configuration of a virtual Ethernet adapter.

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

toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

EthernetStub

public EthernetStub(ApiProvider apiProvider,
            StubConfigurationBase config)

Method Detail

list

public List<EthernetTypes.Summary> list(String vm)

Description copied from interface: Ethernet

Returns commonly used information about the virtual Ethernet adapters belonging to the virtual machine.

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

Specified by:

list in interface Ethernet

Parameters:

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

Returns:

List of commonly used information about virtual Ethernet adapters.

list

public List<EthernetTypes.Summary> list(String vm,
                               InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Returns commonly used information about the virtual Ethernet adapters belonging to the 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:

list in interface Ethernet

Parameters:

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

invocationConfig - Configuration for the method invocation.

Returns:

List of commonly used information about virtual Ethernet adapters.

list

public void list(String vm,
        AsyncCallback<List<EthernetTypes.Summary>> asyncCallback)

Description copied from interface: Ethernet

Returns commonly used information about the virtual Ethernet adapters belonging to the virtual machine.

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

Operation Result:
List of commonly used information about virtual Ethernet adapters.

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.

Specified by:

list in interface Ethernet

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.

list

public void list(String vm,
        AsyncCallback<List<EthernetTypes.Summary>> asyncCallback,
        InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Returns commonly used information about the virtual Ethernet adapters belonging to the 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:
List of commonly used information about virtual Ethernet adapters.

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.

Specified by:

list in interface Ethernet

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.

get

public EthernetTypes.Info get(String vm,
                     String nic)

Description copied from interface: Ethernet

Returns information about a virtual Ethernet adapter.

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

Specified by:

get in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

Returns:

Information about the specified virtual Ethernet adapter.

get

public EthernetTypes.Info get(String vm,
                     String nic,
                     InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Returns information about a virtual Ethernet adapter.

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 Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

invocationConfig - Configuration for the method invocation.

Returns:

Information about the specified virtual Ethernet adapter.

get

public void get(String vm,
       String nic,
       AsyncCallback<EthernetTypes.Info> asyncCallback)

Description copied from interface: Ethernet

Returns information about a virtual Ethernet adapter.

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

Operation Result:
Information about the specified virtual Ethernet adapter.

Operation Errors:
Error - if the system reports an error while responding to the request.
NotFound - if the virtual machine or virtual Ethernet adapter 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.

Specified by:

get in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

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

get

public void get(String vm,
       String nic,
       AsyncCallback<EthernetTypes.Info> asyncCallback,
       InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Returns information about a virtual Ethernet adapter.

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:
Information about the specified virtual Ethernet adapter.

Operation Errors:
Error - if the system reports an error while responding to the request.
NotFound - if the virtual machine or virtual Ethernet adapter 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.

Specified by:

get in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

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

invocationConfig - Configuration for the method invocation.

create

public String create(String vm,
            EthernetTypes.CreateSpec spec)

Description copied from interface: Ethernet

Adds a virtual Ethernet adapter to the virtual machine.

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

Specified by:

create in interface Ethernet

Parameters:

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

spec - Specification for the new virtual Ethernet adapter.

Returns:

Virtual Ethernet adapter identifier. The return value will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

create

public String create(String vm,
            EthernetTypes.CreateSpec spec,
            InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Adds a virtual Ethernet adapter to the 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 Ethernet

Parameters:

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

spec - Specification for the new virtual Ethernet adapter.

invocationConfig - Configuration for the method invocation.

Returns:

Virtual Ethernet adapter identifier. The return value will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

create

public void create(String vm,
          EthernetTypes.CreateSpec spec,
          AsyncCallback<String> asyncCallback)

Description copied from interface: Ethernet

Adds a virtual Ethernet adapter to the virtual machine.

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

Operation Result:
Virtual Ethernet adapter identifier. The return value will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

Operation Errors:
Error - if the system reported that the Ethernet adapter was created but was unable to confirm the creation because the identifier of the new adapter could not be determined.
Error - if the system reports an error while responding to the request.
NotFound - if the virtual machine or network backing is not found.
UnableToAllocateResource - if the virtual machine already has the maximum number of supported Ethernet adapters.
InvalidArgument - if the specified PCI address is out of bounds, HOST_DEVICE is specified as the type, or a backing cannot be found in the case that backing is left null.
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.
Unsupported - if the guest operating system of the virtual machine is not supported and spec includes null properties that default to guest-specific values.

Specified by:

create in interface Ethernet

Parameters:

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

spec - Specification for the new virtual Ethernet adapter.

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

create

public void create(String vm,
          EthernetTypes.CreateSpec spec,
          AsyncCallback<String> asyncCallback,
          InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Adds a virtual Ethernet adapter to the 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:
Virtual Ethernet adapter identifier. The return value will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

Operation Errors:
Error - if the system reported that the Ethernet adapter was created but was unable to confirm the creation because the identifier of the new adapter could not be determined.
Error - if the system reports an error while responding to the request.
NotFound - if the virtual machine or network backing is not found.
UnableToAllocateResource - if the virtual machine already has the maximum number of supported Ethernet adapters.
InvalidArgument - if the specified PCI address is out of bounds, HOST_DEVICE is specified as the type, or a backing cannot be found in the case that backing is left null.
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.
Unsupported - if the guest operating system of the virtual machine is not supported and spec includes null properties that default to guest-specific values.

Specified by:

create in interface Ethernet

Parameters:

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

spec - Specification for the new virtual Ethernet adapter.

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

invocationConfig - Configuration for the method invocation.

update

public void update(String vm,
          String nic,
          EthernetTypes.UpdateSpec spec)

Description copied from interface: Ethernet

Updates the configuration of a virtual Ethernet adapter.

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

Specified by:

update in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

spec - Specification for updating the virtual Ethernet adapter.

update

public void update(String vm,
          String nic,
          EthernetTypes.UpdateSpec spec,
          InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Updates the configuration of a virtual Ethernet adapter.

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:

update in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

spec - Specification for updating the virtual Ethernet adapter.

invocationConfig - Configuration for the method invocation.

update

public void update(String vm,
          String nic,
          EthernetTypes.UpdateSpec spec,
          AsyncCallback<Void> asyncCallback)

Description copied from interface: Ethernet

Updates the configuration of a virtual Ethernet adapter.

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 HOST_DEVICE is specified as the type.
NotFound - if the virtual machine, virtual Ethernet adapter, or backing network 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.

Specified by:

update in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

spec - Specification for updating the virtual Ethernet adapter.

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

update

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

Description copied from interface: Ethernet

Updates the configuration of a virtual Ethernet adapter.

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 HOST_DEVICE is specified as the type.
NotFound - if the virtual machine, virtual Ethernet adapter, or backing network 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.

Specified by:

update in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

spec - Specification for updating the virtual Ethernet adapter.

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

invocationConfig - Configuration for the method invocation.

delete

public void delete(String vm,
          String nic)

Description copied from interface: Ethernet

Removes a virtual Ethernet adapter from the virtual machine.

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

Specified by:

delete in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

delete

public void delete(String vm,
          String nic,
          InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Removes a virtual Ethernet adapter from the 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 Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

invocationConfig - Configuration for the method invocation.

delete

public void delete(String vm,
          String nic,
          AsyncCallback<Void> asyncCallback)

Description copied from interface: Ethernet

Removes a virtual Ethernet adapter from the 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 or virtual Ethernet adapter 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.

Specified by:

delete in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

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

delete

public void delete(String vm,
          String nic,
          AsyncCallback<Void> asyncCallback,
          InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Removes a virtual Ethernet adapter from the 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 or virtual Ethernet adapter 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.

Specified by:

delete in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

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

invocationConfig - Configuration for the method invocation.

connect

public void connect(String vm,
           String nic)

Description copied from interface: Ethernet

Connects a virtual Ethernet adapter of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system.

For a powered-off virtual machine, the Ethernet.update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.EthernetTypes.UpdateSpec) method may be used to configure the virtual Ethernet adapter to start in the connected state when the virtual machine is powered on.

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

Specified by:

connect in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

connect

public void connect(String vm,
           String nic,
           InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Connects a virtual Ethernet adapter of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system.

For a powered-off virtual machine, the Ethernet.update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.EthernetTypes.UpdateSpec) method may be used to configure the virtual Ethernet adapter to start in the connected state when the virtual machine is powered on.

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:

connect in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

invocationConfig - Configuration for the method invocation.

connect

public void connect(String vm,
           String nic,
           AsyncCallback<Void> asyncCallback)

Description copied from interface: Ethernet

Connects a virtual Ethernet adapter of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system.

For a powered-off virtual machine, the Ethernet.update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.EthernetTypes.UpdateSpec) method may be used to configure the virtual Ethernet adapter to start in the connected state when the virtual machine is powered on.

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 or virtual Ethernet adapter is not found.
AlreadyInDesiredState - if the virtual Ethernet adapter is already connected.
NotAllowedInCurrentState - if the virtual machine is not powered on.
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.

Specified by:

connect in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

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

connect

public void connect(String vm,
           String nic,
           AsyncCallback<Void> asyncCallback,
           InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Connects a virtual Ethernet adapter of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system.

For a powered-off virtual machine, the Ethernet.update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.EthernetTypes.UpdateSpec) method may be used to configure the virtual Ethernet adapter to start in the connected state when the virtual machine is powered on.

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 or virtual Ethernet adapter is not found.
AlreadyInDesiredState - if the virtual Ethernet adapter is already connected.
NotAllowedInCurrentState - if the virtual machine is not powered on.
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.

Specified by:

connect in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

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

invocationConfig - Configuration for the method invocation.

disconnect

public void disconnect(String vm,
              String nic)

Description copied from interface: Ethernet

Disconnects a virtual Ethernet adapter of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the Ethernet adapter is not connected to its backing resource.

For a powered-off virtual machine, the Ethernet.update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.EthernetTypes.UpdateSpec) method may be used to configure the virtual Ethernet adapter to start in the disconnected state when the virtual machine is powered on.

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

Specified by:

disconnect in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

disconnect

public void disconnect(String vm,
              String nic,
              InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Disconnects a virtual Ethernet adapter of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the Ethernet adapter is not connected to its backing resource.

For a powered-off virtual machine, the Ethernet.update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.EthernetTypes.UpdateSpec) method may be used to configure the virtual Ethernet adapter to start in the disconnected state when the virtual machine is powered on.

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:

disconnect in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

invocationConfig - Configuration for the method invocation.

disconnect

public void disconnect(String vm,
              String nic,
              AsyncCallback<Void> asyncCallback)

Description copied from interface: Ethernet

Disconnects a virtual Ethernet adapter of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the Ethernet adapter is not connected to its backing resource.

For a powered-off virtual machine, the Ethernet.update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.EthernetTypes.UpdateSpec) method may be used to configure the virtual Ethernet adapter to start in the disconnected state when the virtual machine is powered on.

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 or virtual Ethernet adapter is not found.
AlreadyInDesiredState - if the virtual Ethernet adapter is already disconnected.
NotAllowedInCurrentState - if the virtual machine is not powered on.
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.

Specified by:

disconnect in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

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

disconnect

public void disconnect(String vm,
              String nic,
              AsyncCallback<Void> asyncCallback,
              InvocationConfig invocationConfig)

Description copied from interface: Ethernet

Disconnects a virtual Ethernet adapter of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the Ethernet adapter is not connected to its backing resource.

For a powered-off virtual machine, the Ethernet.update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.EthernetTypes.UpdateSpec) method may be used to configure the virtual Ethernet adapter to start in the disconnected state when the virtual machine is powered on.

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 or virtual Ethernet adapter is not found.
AlreadyInDesiredState - if the virtual Ethernet adapter is already disconnected.
NotAllowedInCurrentState - if the virtual machine is not powered on.
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.

Specified by:

disconnect in interface Ethernet

Parameters:

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

nic - Virtual Ethernet adapter identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

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

invocationConfig - Configuration for the method invocation.