NAME

VMware::vCloud - The VMware vCloud API

SYNOPSIS

This module has been developed against VMware vCenter director.

my $vcd = new VMware::vCloud (
  $hostname, $username, $password, $orgname
);

my $login = $vcd->login;

DESCRIPTION

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

RETURNED VALUES

Many of the methods return hash references or arrays of hash references that contain information about a specific "object" or concept on the vCloud Director server. This is a rough analog to the Managed Object Reference structure of the VIPERL SDK without the generic interface for retireval.

EXAMPLE SCRIPTS

Included in the distribution of this module are several example scripts. Hopefully they provide an illustrative example of the vCloud API. 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.

WISH LIST

If someone from VMware is reading this, and has control of the API, I would dearly love a few changes, that might help things:

System - It would really help if in the API guide it mentions early on that the organization to connect as an administrator account, IE: the macro organization to which all other orgs descend from is called "System." That helps a lot.

External vs External - When you have the concept of a "fenced" network for a vApp, one of the most confusing points is the local network that is natted to the outside is referred to as "External" as is the outside IPs that the network is routed to. Walk a new user through some of the Org creation wizards and watch the confusion. Bad choice of names.

VERSION

Version: v2.02 (2011/09/30)

AUTHOR

Phillip Pollard, <bennie@cpan.org>

CONTRIBUTIONS

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

DEPENDENCIES

LWP
XML::Simple

LICENSE AND COPYRIGHT

Released under Perl Artistic License

SEE ALSO

VMware vCloud Director
 http://www.vmware.com/products/vcloud/

VMware vCloud API Specification v1.0
 http://communities.vmware.com/docs/DOC-12464

VMware vCloud API Programming Guide v1.0
 http://communities.vmware.com/docs/DOC-12463
 
vCloud API and Admin API v1.0 schema definition files
 http://communities.vmware.com/docs/DOC-13564
 
VMware vCloud API Communities
 http://communities.vmware.com/community/vmtn/developer/forums/vcloudapi