Com::Vmware::Vcenter::Vm::Hardware::Floppy Class Reference

Inheritance diagram for Com::Vmware::Vcenter::Vm::Hardware::Floppy:

Classes
class	BackingInfo
class	BackingSpec
class	BackingType
class	CreateSpec
class	Info
class	Summary
class	UpdateSpec

Avaliable Methods
public method	create ()
public method	disconnect ()
public method	get ()
public method	delete ()
public method	new ()
public method	update ()
public method	list ()
public method	connect ()

Detailed Description

The Com::Vmware::Vcenter::Vm::Hardware::Floppy interface provides methods for configuring the virtual floppy drives of a virtual machine. Constant String::RESOURCE_TYPE # Resource type for the virtual floppy drive device.

Member Function Documentation

public method Com::Vmware::Vcenter::Vm::Hardware::Floppy::connect

(

)

Connects a virtual floppy drive 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 :func:Com::Vmware::Vcenter::Vm::Hardware::Floppy.update method may be used to configure the virtual floppy drive to start in the connected state when the virtual machine is powered on.

Parameters

vm	[REQUIRED] Virtual machine identifier. The value must be an identifier for the resource type getQualifiedName(VirtualMachine). . The value must be str.
floppy	[REQUIRED] Virtual floppy drive identifier. The value must be an identifier for the resource type getQualifiedName(com.vmware.vcenter.vm.hardware.Floppy). . The value must be str.

Exceptions

Com::Vmware::Vapi::Std::Errors::Error	if the system reports an error while responding to the request.
Com::Vmware::Vapi::Std::Errors::NotFound	if the virtual machine or virtual floppy drive is not found.
Com::Vmware::Vapi::Std::Errors::AlreadyInDesiredState	if the virtual floppy drive is already connected.
Com::Vmware::Vapi::Std::Errors::NotAllowedInCurrentState	if the virtual machine is not powered on.
Com::Vmware::Vapi::Std::Errors::ResourceBusy	if the virtual machine is busy performing another operation.
Com::Vmware::Vapi::Std::Errors::ResourceInaccessible	if the virtual machine's configuration state cannot be accessed.
Com::Vmware::Vapi::Std::Errors::ServiceUnavailable	if the system is unable to communicate with a service to complete the request.
Com::Vmware::Vapi::Std::Errors::Unauthenticated	if the user can not be authenticated.
Com::Vmware::Vapi::Std::Errors::Unauthorized	if the user doesn't have the required privileges.

Code:

public method Com::Vmware::Vcenter::Vm::Hardware::Floppy::create

(

)

Adds a virtual floppy drive to the virtual machine.

Parameters

vm	[REQUIRED] Virtual machine identifier. The value must be an identifier for the resource type getQualifiedName(VirtualMachine). . The value must be str.
spec	[REQUIRED] Specification for the new virtual floppy drive. . The value must be Com::Vmware::Vcenter::Vm::Hardware::Floppy::CreateSpec.

Return values

Virtual

floppy drive identifier. The value will be an identifier for the resource type getQualifiedName(com.vmware.vcenter.vm.hardware.Floppy). The return type will be str

Exceptions

Com::Vmware::Vapi::Std::Errors::Error	if the system reported that the floppy device was created but was unable to confirm the creation because the identifier of the new device could not be determined.
Com::Vmware::Vapi::Std::Errors::Error	if the system reports an error while responding to the request.
Com::Vmware::Vapi::Std::Errors::NotFound	if the virtual machine is not found.
Com::Vmware::Vapi::Std::Errors::NotAllowedInCurrentState	if the virtual machine is not powered off.
Com::Vmware::Vapi::Std::Errors::UnableToAllocateResource	if the virtual machine already has the maximum number of supported floppy drives.
Com::Vmware::Vapi::Std::Errors::ResourceBusy	if the virtual machine is busy performing another operation.
Com::Vmware::Vapi::Std::Errors::ResourceInaccessible	if the virtual machine's configuration state cannot be accessed.
Com::Vmware::Vapi::Std::Errors::ServiceUnavailable	if the system is unable to communicate with a service to complete the request.
Com::Vmware::Vapi::Std::Errors::Unauthenticated	if the user can not be authenticated.
Com::Vmware::Vapi::Std::Errors::Unauthorized	if the user doesn't have the required privileges.

Code:

public method Com::Vmware::Vcenter::Vm::Hardware::Floppy::delete

(

)

Removes a virtual floppy drive from the virtual machine.

Parameters

vm	[REQUIRED] Virtual machine identifier. The value must be an identifier for the resource type getQualifiedName(VirtualMachine). . The value must be str.
floppy	[REQUIRED] Virtual floppy drive identifier. The value must be an identifier for the resource type getQualifiedName(com.vmware.vcenter.vm.hardware.Floppy). . The value must be str.

Exceptions

Com::Vmware::Vapi::Std::Errors::Error	if the system reports an error while responding to the request.
Com::Vmware::Vapi::Std::Errors::NotFound	if the virtual machine or virtual floppy drive is not found.
Com::Vmware::Vapi::Std::Errors::NotAllowedInCurrentState	if the virtual machine is not powered off.
Com::Vmware::Vapi::Std::Errors::ResourceBusy	if the virtual machine is busy performing another operation.
Com::Vmware::Vapi::Std::Errors::ResourceInaccessible	if the virtual machine's configuration state cannot be accessed.
Com::Vmware::Vapi::Std::Errors::ServiceUnavailable	if the system is unable to communicate with a service to complete the request.
Com::Vmware::Vapi::Std::Errors::Unauthenticated	if the user can not be authenticated.
Com::Vmware::Vapi::Std::Errors::Unauthorized	if the user doesn't have the required privileges.

Code:

public method Com::Vmware::Vcenter::Vm::Hardware::Floppy::disconnect

(

)

Disconnects a virtual floppy drive 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 floppy drive is not connected to its backing resource.

For a powered-off virtual machine, the :func:Com::Vmware::Vcenter::Vm::Hardware::Floppy.update method may be used to configure the virtual floppy floppy to start in the disconnected state when the virtual machine is powered on.

Parameters

vm	[REQUIRED] Virtual machine identifier. The value must be an identifier for the resource type getQualifiedName(VirtualMachine). . The value must be str.
floppy	[REQUIRED] Virtual floppy drive identifier. The value must be an identifier for the resource type getQualifiedName(com.vmware.vcenter.vm.hardware.Floppy). . The value must be str.

Exceptions

Com::Vmware::Vapi::Std::Errors::Error	if the system reports an error while responding to the request.
Com::Vmware::Vapi::Std::Errors::NotFound	if the virtual machine or virtual floppy drive is not found.
Com::Vmware::Vapi::Std::Errors::AlreadyInDesiredState	if the virtual floppy drive is already disconnected.
Com::Vmware::Vapi::Std::Errors::NotAllowedInCurrentState	if the virtual machine is not powered on.
Com::Vmware::Vapi::Std::Errors::ResourceBusy	if the virtual machine is busy performing another operation.
Com::Vmware::Vapi::Std::Errors::ResourceInaccessible	if the virtual machine's configuration state cannot be accessed.
Com::Vmware::Vapi::Std::Errors::ServiceUnavailable	if the system is unable to communicate with a service to complete the request.
Com::Vmware::Vapi::Std::Errors::Unauthenticated	if the user can not be authenticated.
Com::Vmware::Vapi::Std::Errors::Unauthorized	if the user doesn't have the required privileges.

Code:

public method Com::Vmware::Vcenter::Vm::Hardware::Floppy::get

(

)

Returns information about a virtual floppy drive.

Parameters

vm	[REQUIRED] Virtual machine identifier. The value must be an identifier for the resource type getQualifiedName(VirtualMachine). . The value must be str.
floppy	[REQUIRED] Virtual floppy drive identifier. The value must be an identifier for the resource type getQualifiedName(com.vmware.vcenter.vm.hardware.Floppy). . The value must be str.

Return values

Information

about the specified virtual floppy drive. The return type will be Com::Vmware::Vcenter::Vm::Hardware::Floppy::Info

Exceptions

Com::Vmware::Vapi::Std::Errors::Error	if the system reports an error while responding to the request.
Com::Vmware::Vapi::Std::Errors::NotFound	if the virtual machine or virtual floppy drive is not found.
Com::Vmware::Vapi::Std::Errors::ResourceInaccessible	if the virtual machine's configuration state cannot be accessed.
Com::Vmware::Vapi::Std::Errors::ServiceUnavailable	if the system is unable to communicate with a service to complete the request.
Com::Vmware::Vapi::Std::Errors::Unauthenticated	if the user can not be authenticated.
Com::Vmware::Vapi::Std::Errors::Unauthorized	if the user doesn't have the required privileges.

Code:

public method Com::Vmware::Vcenter::Vm::Hardware::Floppy::list

(

)

Returns commonly used information about the virtual floppy drives belonging to the virtual machine.

Parameters

vm	[REQUIRED] Virtual machine identifier. The value must be an identifier for the resource type getQualifiedName(VirtualMachine). . The value must be str.

Return values

List	of commonly used information about virtual floppy drives. The return type will be Array of Com::Vmware::Vcenter::Vm::Hardware::Floppy::Summary

Exceptions

Com::Vmware::Vapi::Std::Errors::Error	if the system reports an error while responding to the request.
Com::Vmware::Vapi::Std::Errors::NotFound	if the virtual machine is not found.
Com::Vmware::Vapi::Std::Errors::ResourceInaccessible	if the virtual machine's configuration state cannot be accessed.
Com::Vmware::Vapi::Std::Errors::ServiceUnavailable	if the system is unable to communicate with a service to complete the request.
Com::Vmware::Vapi::Std::Errors::Unauthenticated	if the user can not be authenticated.
Com::Vmware::Vapi::Std::Errors::Unauthorized	if the user doesn't have the required privileges.

Code:

public method Com::Vmware::Vcenter::Vm::Hardware::Floppy::new

(

)

Constructor to initialize the object

Parameters

api_provider	- protocol connection to use with stubs created by this factory
StubConfig	- Stub's additional configuration

Return values

Blessed

object

Code:

public method Com::Vmware::Vcenter::Vm::Hardware::Floppy::update

(

)

Updates the configuration of a virtual floppy drive.

Parameters

vm	[REQUIRED] Virtual machine identifier. The value must be an identifier for the resource type getQualifiedName(VirtualMachine). . The value must be str.
floppy	[REQUIRED] Virtual floppy drive identifier. The value must be an identifier for the resource type getQualifiedName(com.vmware.vcenter.vm.hardware.Floppy). . The value must be str.
spec	[REQUIRED] Specification for updating the virtual floppy drive. . The value must be Com::Vmware::Vcenter::Vm::Hardware::Floppy::UpdateSpec.

Exceptions

Com::Vmware::Vapi::Std::Errors::Error	if the system reports an error while responding to the request.
Com::Vmware::Vapi::Std::Errors::NotFound	if the virtual machine or virtual floppy drive is not found.
Com::Vmware::Vapi::Std::Errors::NotAllowedInCurrentState	if one or more of the fields 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 floppy drive.
Com::Vmware::Vapi::Std::Errors::ResourceBusy	if the virtual machine is busy performing another operation.
Com::Vmware::Vapi::Std::Errors::ResourceInaccessible	if the virtual machine's configuration state cannot be accessed.
Com::Vmware::Vapi::Std::Errors::ServiceUnavailable	if the system is unable to communicate with a service to complete the request.
Com::Vmware::Vapi::Std::Errors::Unauthenticated	if the user can not be authenticated.
Com::Vmware::Vapi::Std::Errors::Unauthorized	if the user doesn't have the required privileges.

Code:

---

The documentation for this class was generated from the following file:

• Com/Vmware/Vcenter/Vm/Hardware/Floppy.pm