com.vmware.vcenter.vm.hardware

Interface Cdrom

All Superinterfaces:

CdromTypes, Service

All Known Implementing Classes:

CdromStub

public interface Cdrom
extends Service, CdromTypes

The Cdrom interface provides methods for configuring the virtual CD-ROM devices of a virtual machine.

Nested Class Summary

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

CdromTypes.BackingInfo, CdromTypes.BackingSpec, CdromTypes.BackingType, CdromTypes.CreateSpec, CdromTypes.DeviceAccessType, CdromTypes.HostBusAdapterType, CdromTypes.Info, CdromTypes.Summary, CdromTypes.UpdateSpec

Field Summary

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

_VAPI_SERVICE_ID, RESOURCE_TYPE

Method Summary

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

Method Detail

list

java.util.List<CdromTypes.Summary> list(java.lang.String vm)

Returns commonly used information about the virtual CD-ROM devices belonging to the 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:

List of commonly used information about virtual CD-ROM devices.

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.

list

java.util.List<CdromTypes.Summary> list(java.lang.String vm,
                                        InvocationConfig invocationConfig)

Returns commonly used information about the virtual CD-ROM devices 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.

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 CD-ROM devices.

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.

list

void list(java.lang.String vm,
          AsyncCallback<java.util.List<CdromTypes.Summary>> asyncCallback)

Returns commonly used information about the virtual CD-ROM devices belonging to the virtual machine.

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

Invocation Result:
List of commonly used information about virtual CD-ROM devices.

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.

list

void list(java.lang.String vm,
          AsyncCallback<java.util.List<CdromTypes.Summary>> asyncCallback,
          InvocationConfig invocationConfig)

Returns commonly used information about the virtual CD-ROM devices 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.

Invocation Result:
List of commonly used information about virtual CD-ROM devices.

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.

get

CdromTypes.Info get(java.lang.String vm,
                    java.lang.String cdrom)

Returns information about a virtual CD-ROM device.

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.

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

Returns:

Information about the specified virtual CD-ROM device.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device 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

CdromTypes.Info get(java.lang.String vm,
                    java.lang.String cdrom,
                    InvocationConfig invocationConfig)

Returns information about a virtual CD-ROM device.

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.

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

invocationConfig - Configuration for the method invocation.

Returns:

Information about the specified virtual CD-ROM device.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device 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(java.lang.String vm,
         java.lang.String cdrom,
         AsyncCallback<CdromTypes.Info> asyncCallback)

Returns information about a virtual CD-ROM device.

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

Invocation Result:
Information about the specified virtual CD-ROM device.

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

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

get

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

Returns information about a virtual CD-ROM device.

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 CD-ROM device.

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

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

invocationConfig - Configuration for the method invocation.

create

java.lang.String create(java.lang.String vm,
                        CdromTypes.CreateSpec spec)

Adds a virtual CD-ROM device to the 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 the new virtual CD-ROM device.

Returns:

Virtual CD-ROM device identifier. The return value will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

Throws:

Error - if the system reported that the CD-ROM device was created but was unable to confirm the creation because the identifier of the new device could not be determined.

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

NotFound - if the virtual machine is not found.

NotAllowedInCurrentState - if the virtual machine is suspended or if the virtual machine is powered on and virtual CD-ROM type is IDE.

UnableToAllocateResource - if the specified storage address is unavailable; for example, if the SCSI adapter requested does not exist.

ResourceInUse - if the specified storage address is in use.

InvalidArgument - if the specified storage address is out of bounds.

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.

create

java.lang.String create(java.lang.String vm,
                        CdromTypes.CreateSpec spec,
                        InvocationConfig invocationConfig)

Adds a virtual CD-ROM device 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.

Parameters:

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

spec - Specification for the new virtual CD-ROM device.

invocationConfig - Configuration for the method invocation.

Returns:

Virtual CD-ROM device identifier. The return value will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

Throws:

Error - if the system reported that the CD-ROM device was created but was unable to confirm the creation because the identifier of the new device could not be determined.

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

NotFound - if the virtual machine is not found.

NotAllowedInCurrentState - if the virtual machine is suspended or if the virtual machine is powered on and virtual CD-ROM type is IDE.

UnableToAllocateResource - if the specified storage address is unavailable; for example, if the SCSI adapter requested does not exist.

ResourceInUse - if the specified storage address is in use.

InvalidArgument - if the specified storage address is out of bounds.

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.

create

void create(java.lang.String vm,
            CdromTypes.CreateSpec spec,
            AsyncCallback<java.lang.String> asyncCallback)

Adds a virtual CD-ROM device to the virtual machine.

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

Invocation Result:
Virtual CD-ROM device identifier. The return value will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

Operation Errors:
Error - if the system reported that the CD-ROM device was created but was unable to confirm the creation because the identifier of the new device could not be determined.
Error - if the system reports an error while responding to the request.
NotFound - if the virtual machine is not found.
NotAllowedInCurrentState - if the virtual machine is suspended or if the virtual machine is powered on and virtual CD-ROM type is IDE.
UnableToAllocateResource - if the specified storage address is unavailable; for example, if the SCSI adapter requested does not exist.
ResourceInUse - if the specified storage address is in use.
InvalidArgument - if the specified storage address is out of bounds.
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.

Parameters:

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

spec - Specification for the new virtual CD-ROM device.

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

create

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

Adds a virtual CD-ROM device 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.

Invocation Result:
Virtual CD-ROM device identifier. The return value will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

Operation Errors:
Error - if the system reported that the CD-ROM device was created but was unable to confirm the creation because the identifier of the new device could not be determined.
Error - if the system reports an error while responding to the request.
NotFound - if the virtual machine is not found.
NotAllowedInCurrentState - if the virtual machine is suspended or if the virtual machine is powered on and virtual CD-ROM type is IDE.
UnableToAllocateResource - if the specified storage address is unavailable; for example, if the SCSI adapter requested does not exist.
ResourceInUse - if the specified storage address is in use.
InvalidArgument - if the specified storage address is out of bounds.
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.

Parameters:

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

spec - Specification for the new virtual CD-ROM device.

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

invocationConfig - Configuration for the method invocation.

update

void update(java.lang.String vm,
            java.lang.String cdrom,
            CdromTypes.UpdateSpec spec)

Updates the configuration of a virtual CD-ROM device.

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.

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

spec - Specification for updating the virtual CD-ROM device.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device is not found.

NotAllowedInCurrentState - if one or more of the properties specified in the spec parameter cannot be modified due to the current power state of the virtual machine or the connection state of the virtual CD-ROM device.

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(java.lang.String vm,
            java.lang.String cdrom,
            CdromTypes.UpdateSpec spec,
            InvocationConfig invocationConfig)

Updates the configuration of a virtual CD-ROM device.

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.

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

spec - Specification for updating the virtual CD-ROM device.

invocationConfig - Configuration for the method invocation.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device is not found.

NotAllowedInCurrentState - if one or more of the properties specified in the spec parameter cannot be modified due to the current power state of the virtual machine or the connection state of the virtual CD-ROM device.

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(java.lang.String vm,
            java.lang.String cdrom,
            CdromTypes.UpdateSpec spec,
            AsyncCallback<java.lang.Void> asyncCallback)

Updates the configuration of a virtual CD-ROM device.

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 CD-ROM device is not found.
NotAllowedInCurrentState - if one or more of the properties specified in the spec parameter cannot be modified due to the current power state of the virtual machine or the connection state of the virtual CD-ROM device.
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.

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

spec - Specification for updating the virtual CD-ROM device.

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

update

void update(java.lang.String vm,
            java.lang.String cdrom,
            CdromTypes.UpdateSpec spec,
            AsyncCallback<java.lang.Void> asyncCallback,
            InvocationConfig invocationConfig)

Updates the configuration of a virtual CD-ROM device.

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 CD-ROM device is not found.
NotAllowedInCurrentState - if one or more of the properties specified in the spec parameter cannot be modified due to the current power state of the virtual machine or the connection state of the virtual CD-ROM device.
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.

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

spec - Specification for updating the virtual CD-ROM device.

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

invocationConfig - Configuration for the method invocation.

delete

void delete(java.lang.String vm,
            java.lang.String cdrom)

Removes a virtual CD-ROM device from the 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.

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device is not found.

NotAllowedInCurrentState - if the virtual machine is suspended or if the virtual machine is powered on and virtual CD-ROM type is IDE.

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.

delete

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

Removes a virtual CD-ROM device 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.

Parameters:

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

invocationConfig - Configuration for the method invocation.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device is not found.

NotAllowedInCurrentState - if the virtual machine is suspended or if the virtual machine is powered on and virtual CD-ROM type is IDE.

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.

delete

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

Removes a virtual CD-ROM device 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 CD-ROM device is not found.
NotAllowedInCurrentState - if the virtual machine is suspended or if the virtual machine is powered on and virtual CD-ROM type is IDE.
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.

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

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

delete

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

Removes a virtual CD-ROM device 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 CD-ROM device is not found.
NotAllowedInCurrentState - if the virtual machine is suspended or if the virtual machine is powered on and virtual CD-ROM type is IDE.
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.

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

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

invocationConfig - Configuration for the method invocation.

connect

void connect(java.lang.String vm,
             java.lang.String cdrom)

Connects a virtual CD-ROM device 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 update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.CdromTypes.UpdateSpec) method may be used to configure the virtual CD-ROM device 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.

Parameters:

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device is not found.

AlreadyInDesiredState - if the virtual CD-ROM device 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.

connect

void connect(java.lang.String vm,
             java.lang.String cdrom,
             InvocationConfig invocationConfig)

Connects a virtual CD-ROM device 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 update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.CdromTypes.UpdateSpec) method may be used to configure the virtual CD-ROM device 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.

Parameters:

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

invocationConfig - Configuration for the method invocation.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device is not found.

AlreadyInDesiredState - if the virtual CD-ROM device 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.

connect

void connect(java.lang.String vm,
             java.lang.String cdrom,
             AsyncCallback<java.lang.Void> asyncCallback)

Connects a virtual CD-ROM device 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 update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.CdromTypes.UpdateSpec) method may be used to configure the virtual CD-ROM device 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 CD-ROM device is not found.
AlreadyInDesiredState - if the virtual CD-ROM device 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.

Parameters:

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

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

connect

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

Connects a virtual CD-ROM device 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 update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.CdromTypes.UpdateSpec) method may be used to configure the virtual CD-ROM device 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 CD-ROM device is not found.
AlreadyInDesiredState - if the virtual CD-ROM device 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.

Parameters:

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

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

invocationConfig - Configuration for the method invocation.

disconnect

void disconnect(java.lang.String vm,
                java.lang.String cdrom)

Disconnects a virtual CD-ROM device 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 CD-ROM device is not connected to its backing resource.

For a powered-off virtual machine, the update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.CdromTypes.UpdateSpec) method may be used to configure the virtual CD-ROM device 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.

Parameters:

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device is not found.

AlreadyInDesiredState - if the virtual CD-ROM device 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.

disconnect

void disconnect(java.lang.String vm,
                java.lang.String cdrom,
                InvocationConfig invocationConfig)

Disconnects a virtual CD-ROM device 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 CD-ROM device is not connected to its backing resource.

For a powered-off virtual machine, the update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.CdromTypes.UpdateSpec) method may be used to configure the virtual CD-ROM device 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.

Parameters:

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

invocationConfig - Configuration for the method invocation.

Throws:

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

NotFound - if the virtual machine or virtual CD-ROM device is not found.

AlreadyInDesiredState - if the virtual CD-ROM device 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.

disconnect

void disconnect(java.lang.String vm,
                java.lang.String cdrom,
                AsyncCallback<java.lang.Void> asyncCallback)

Disconnects a virtual CD-ROM device 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 CD-ROM device is not connected to its backing resource.

For a powered-off virtual machine, the update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.CdromTypes.UpdateSpec) method may be used to configure the virtual CD-ROM device 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 CD-ROM device is not found.
AlreadyInDesiredState - if the virtual CD-ROM device 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.

Parameters:

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

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

disconnect

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

Disconnects a virtual CD-ROM device 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 CD-ROM device is not connected to its backing resource.

For a powered-off virtual machine, the update(java.lang.String, java.lang.String, com.vmware.vcenter.vm.hardware.CdromTypes.UpdateSpec) method may be used to configure the virtual CD-ROM device 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 CD-ROM device is not found.
AlreadyInDesiredState - if the virtual CD-ROM device 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.

Parameters:

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

cdrom - Virtual CD-ROM device identifier. The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

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

invocationConfig - Configuration for the method invocation.