Revision history for VMware::vCloud

NB: Skipped version numbers were never released.

2.404 2023/09/14

  Added:
    POD test

  Improved:
    'use warnings' on all modules

2.401 2014/03/06

  Added:
    LICENSE is part of the distribution now

  Improved:
    Better handling of connection timeouts
    examples/compose-vapp.pl - Now uses Term::Prompt fully.
    examples/create-vapp-from-template.pl - Now uses Term::Prompt fully.
    examples/poweron-vapp.pl - Now uses Term::Prompt fully.
    RCS 'Revisison' based version info removed from examples
    Directly declared VERSION variables
    Autogenerating META data for the modules

2.400 2013-05-03

  Improved:
    All examples are now actually bundled with distribution.

v2.390 2013-05-03

  Added:
    examples/list-datastores.pl
    VMware::vCloud - list_datastores(), progress_of_task()
    VMware::API::vCloud - datastore_list()

2.380 2013-04-17

  Added:
    examples/get-template.pl

  Improved:
    examples/list-templates.pl - Better variable names for the example.
    Added 'Which "name" is which' to POD on VMware::API::vCloud
    Using Term::Prompt to ask for auth on example scripts.

  Fixed:
    VMware::API::vCloud - template_get(), vdc_get() - Missing match target on ternary.*
 
  * Problem found by David Gress

2.370 2013-04-15

  Added:
    VMware::API::vCloud - vapp_recompose_add_vm()

  Improved:
    VMware::vCloud - get_template() - now returns hash or hashref in context
    VMware::API::vCloud - admin(), admin_extension_get(),
      admin_extension_vimServer_get(), catalog_get(), catalog_get_access(),
      org_get(), org_list(), pvdc_get(), task_get(), template_get(), 
      template_get_metadata(), vdc_get(), vdc_list(), vapp_get(), 
      vapp_get_metadata() - now use the core get() method

2.360 2013-04-09

  Added:
    VMware::vCloud - delete_vapp(), create_vapp_from_sources()
    VMware::API::vCloud - vapp_create_from_sources(), vapp_create_from_template()

  Improved:
    Error's now die() with the returned "message" as well as the HTTP code.
    VMware::vCloud - Cache is automatically purged on delete actions.
    VMware::API::vCloud - org_get(), org_list(), vapp_get(), vdc_get() - now use the core get() method
    VMware::API::vCloud - get() now has level-3 debug of the request header
  
2.32 2013-03-29

  Added:
    VMware::vCloud - get_task(), list_pvdcs(), wait_on_task()
    VMware::API::vCloud - org_vdc_update(), put(), task_get()

  Improved:
    examples/list-pvds.pl - Now using VMware::vCloud
    VMware::vCloud - get_vdc() now retruns hash or hashref.
    VMware::API::vCloud - added debug levels 2 and 3
    Date format in documentation is now in ISO 8601 format.

2.29 2013-03-25

  Added:
    Acknowledgement of David Gress as a contributor.
    VMware::vCloud - create_catalog(), delete_catalog()
    VMware::API::vCloud - catalog_create(), catalog_get_access(),
      catalog_set_access(), logout()*
	VMware::API::vCloud - POD noting the LoginUrl error.

  Improved:
    Automatic call of logout() on DESTROY if needed.

  * Provided by David Gress
    
2.26 2013-03-19

  Added:
    VMware::API::vCloud - template_get_metadata(), vapp_get_metadata()
    VMware::API::vCloud - Started adding API documentation URLs as comments in 
                          front of each method.

  Improved:
    VMware::vCloud - list_vapps() & list_templates() - Now uses the current login 
      org a a parameter to list_vapps() to avoid pemission errors when logged in 
      as an Org Admin.
    VMware::vCloud - org_create() improved POD, added ldap_mode as a parameter.

2.22 2013-03-14

  Added:
    VMware::vCloud - admin_urls(), debug(), delete_org(), delete_org_network(), 
      delete_vdc(), disable_org(), disable_vdc(), enable_org(), enable_vdc(), 
      extensions(), get_pvdc(), list_external_networks(), list_portgroups(), 
      purge(), vimserver(), webclienturl()

  Improved:
    VMware::vCloud - get_org() - now returns hash or hashref depending on context.
    VMware::vCloud - Improved and reorganized POD.
    POD cleanup and formatting.

2.19 2013-03-13

  Added:
    VMware::vCloud - create_external_network()
    VMware::API::vCloud - admin(), admin_extension_get(), 
      admin_extension_vimServer_get(), delete(), get_raw(), org_create(), 
      org_list(), org_network_create(), org_vdc_create(), pvdc_get(), vdc_list()
    API version information is now read directly from offered versions.
    Learned variables and Raw responses now attached to $VMware::API::vCloud::self
    When Debug is on, learned variables are displayed on exit.
    
  Improved:
    Now working with API version v5.1
    Removed the 1.0 and 1.5 schema from the MANIFEST until necessary.
    Most recent version is used.
    Login URL is now directed by Version response.
    VMware::API::vCloud - org_list() now generated with caching.

  Fixed:
    Version now included in accept header for authentication.
  
2.12 2011-10-27

  Added:
    XML schema descriptors for 1.0 and 1.5 included in distribution.
    VMware::API::vCloud - "Template name validation" to "BUGS and LIMITATIONS" POD.
    VMware::vCloud - create_vapp_from_template(), get_template(), 
      list_networks(), list_vdcs()
    VMware::API::vCloud - template_get()
    examples/list-templates.pl - Example of how to list templates.
    examples/create-vapp-from-template.pl - Instantiate a template with defaults.

  Improved:
    examples/poweron-vapp.pl - Corrected documentation.
    VMware::vCloud & VMware::vCloud::vApp - now used bless() with two arguments.
    VMware::API::vCloud
      _fault() now pushes a Dumper() of the HTTP object on error. That gives 
         more detail on a fault when debug is enabled.
      post() now has optional parameters for content and content type.
      
  Fixed:
    examples/poweron-vappl.pl - Now actually included in the distribution
      
2.07 2011-10-06

  Improved:
    VMware::API::vCloud: Error handling now recognizes an HTTP::Response object.
    Synopsis documentation on VMware::vCloud.

  Fixed:
    Included VMware::vCloud::vApp in MANIFEST

2.06 2011-10-05

  Added:
    VMware::vCloud::vApp - An object representation of a vApp.
    examples/poweron-vapp.pl - Powering a vApp on.

  Improved:
    Documentation now matches all methods.

2.04 2011-10-03

  Added:
    Caching of data with Cache::Bounded.
    list_templates() & examples/list-vms.pl - List templates
  
  Improved:
    examples/list-vms.pl - Removed commented-out code from 1.x version.


2.01 2011-09-30

  This is a major change in philosophy. Previously this module emulated the API
  in the name of method and returned data structures.

  This does not match most conceptual and desired usage for automation. People
  do not "think" in a collection of REST API calls. They think in actions like
  "deploy a VM."

  Consequently I have moved the direct API implementation to 
  VMware::API::vCloud. It offers an unadulterated pure-perl based view of the
  API and its transactions.

  In VMware::vCloud, I am going to try and present a more human friendly view.

  Added:
    lib/VMware/API/vCloud.pm - Raw API calls and returns.

  Fixed:
    Session ID is now handled via HTTP header, not cookies. This matches the published API docs.


1.600.08 2011-08-02

  Added:
	examples/list-vms.pl - List all vApps and their VMs

  Improved:
    Added POD to the examples: get_org.pl, login.pl
    Fixed double "v" on new Version in POD

1.600.07 2011-07-29

  Added:    
    vdc_get() - List the contents of a Virtual Datacenter
    vapp_get() - List the contents of a vApp

  Fixed:
    Moved to multidigit CPAN-compatible version to work around single-digit subversion numbers.

1.6 2011-07-14

  Added:
    catalog_get() - List a catalogs contents

  NB: Release created and submitted from the air on cross-country flight. :)

1.5 2011-07-01

  Improved:
    Tests now skip() and don't report fail when connection info is not
    provided. The first test reports visual details of this.

1.4 2011-06-25

  Added:
    org_get() - List an organizations contents
	examples/org_get.pl - Usage of the org_get() method
  
  Improved:
    login() - Returned data structure is now only the Org branch of the content.
	t/02-header.t - Added a dummy "ok" to avoid "dubious" warnings until test is expanded.

  Corrected:
    Removed POD references to VMware::API::LabManager

1.3 2011-06-25

  Corrected:
    Error calling Data::Dumper on _fault()
    Syntax error in META.yml

1.2 2011-06-23

  The server is now properly queried for the API version.
  XML to data structure translation of server responses is now in place.  

  Added:
    api_versions() - Method to check API version supported by server
	
  Improved:
    login() - Now returns a data structure of accessible organizations upon successful login.
  
1.1  2011-06-16

  Initial connection seed from sample code from hosting.com with comments from
  the VMware communities.

   - http://mylhat.com/blog/2009/09/hosting-com-vcloud-express-api-example-in-perl/
   - http://communities.vmware.com/thread/284659

   Added:
     login() - Basic method to get a login token from the server.
