NAME

VMware::vCloud::vApp

DESCRIPTION

This module is instanciated to represent a vApp on vCloud Director. As such, it contains methods that interact with the specific vApp this object represents.

This is an internal module to VMware::vCloud and is not designed to be used independantly. You obtain a vApp object by using the get_vapp() method availble in VMware::vCloud.

METHODS

available_actions()

This method returns a hash or hashref of available actions that can be performed on the VM. (Eg: Powering on, deploying, etc.)

Each key represents and action and each value is the corresponding href for said action to be executed.

dumper()

This debugging method returns the internal data structure representing all known information on the vApp.

power_on($vappid)

If it is an available action, it creates the task to power on a vApp.

It returns an array or arraref with three items: returned message, returned numeric code, and a hashref of the full XML data returned.

The "Power On" action will deploy the vApp if it is currently undeployed.

A text error message is returned if the app is currently not able to be powered on. (IE: It is already on, or is busy with another task.)

BUGS AND SOURCE

Bug tracking for this module: https://rt.cpan.org/Public/Dist/Display.html?Name=VMware-vCloud

Source hosting: http://www.github.com/bennie/perl-VMware-vCloud

VERSION

VMware::vCloud::vApp v2.404 (2023/09/14)

COPYRIGHT

(c) 2011-2023, Phillip Pollard <bennie@cpan.org>

LICENSE

This source code is released under the "Perl Artistic License 2.0," the text of which is included in the LICENSE file of this distribution. It may also be reviewed here: http://opensource.org/licenses/artistic-license-2.0