The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
VMware-vCloud-2.405-TRIAL
River stage zero No dependents
++
/ VMware::vCloud::vApp

NAME

VMware::vCloud::vApp - VMware vCloud Director vApp

VERSION

version 2.405

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

new($class, $api, $href)

Create a new VMware::vCloud::vApp object and fetch the associated data from the vCloud API.

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.)

power_off

Not implemented

recompose

Not implemented

AUTHORS

  • Phillip Pollard <bennie@cpan.org>

  • Nigel Metheringham <nigelm@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2011 by Phillip Pollard <bennie@cpan.org>.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)