/ 
VMware-vCloud-v2.07
River stage zero No dependents
/ VMware::vCloud

NAME

VMware::vCloud - VMware vCloud Director

SYNOPSIS

my $vcd = new VMware::vCloud ( $hostname, $username, $password, $orgname, { debug => 1 } );  
my %vapps = $vcd->list_vapps();

my $vappid = $vapps{'My Personal vApp'};

my $vapp = $vcd->get_vapp($vappid);
my $ret = $vapp->power_on();

DESCRIPTION

This module provides a Perl interface to VMware's vCloud Director.

EXAMPLE SCRIPTS

Included in the distribution of this module are several example scripts. Hopefully they provide an illustrative example of the use of vCloud Director. All scripts have their own POD and accept command line parameters in a similar way to the VIPERL SDK utilities and vghetto scripts.

login.pl - An example script that demonstrates logging in to the server.
org_get.pl - Selects a random organization and prints a Data::Dumper dump of it's information.
list-vapps.pl - Prints a list of all VMs the user has access to.

METHODS

new($host,$user,$pass,$org,$conf)

This method instances the VMware::vCloud object and verifies the user can log onto the server.

$host, $user, and $pass are required. They should contain the login information for the vCloud server.

$org and $conf are optional.

$org is the vCloud Organization to connect to. If $org is not given, the default of 'System' is used.

$conf is an optional hasref containing tuneable parameters:

* debug - set to a true value to turn on STDERR debugging statements.

get_org($orgid)

Given an organization id, it returns a hash of data for that organization.

get_vapp($vappid)

Given an vApp id, it returns a vApp object for that vApp.

See the documentation on VMware::vCloud::vApp for full details on this object type.

get_vdc($vdcid)

Given an vDC id, it returns a hash of data for that vDC.

list_orgs()

This method returns a hash or hashref of Organization names and IDs.

list_templates()

This method returns a hash or hashref of Template names and IDs the user has access too.

list_vapps()

This method returns a hash or hashref of Template names and IDs the user has access too.

login()

This method is deprecated and will be removed in later releases.

This method roughly emulates the default login action of the API: It returns information on which organizations are accessible to the user.

It is a synonym for list_orgs() and all details on return values should be take from that method's documentation.

VERSION

Version: v2.07 (2011/10/06)

AUTHOR

Phillip Pollard, <bennie@cpan.org>

CONTRIBUTIONS

stu41j - http://communities.vmware.com/people/stu42j

DEPENDENCIES

Cache::Bounded
VMware::API::vCloud

LICENSE AND COPYRIGHT

Released under Perl Artistic License