VMware vCloud Suite SDK for Perl 6.0 Release Notes
Released 12 MAR 2015
This document contains the following sections:
|
Overview
This SDK provides programmatic access to new features introduced in vSphere 6.0 and existing
features that did not have a public API prior to the vSphere 6.0 release. Access to existing features
is exposed through the vSphere Web Services API. The vCloud Suite SDK for Perl also contains samples that
demonstrate how the libraries work with other vSphere APIs.
The version 6.0 SDK enables programmatic access to the following services:
- Service discovery using Lookup Service
- Authentication (Single Sign-On)
- Session management
- Tagging
- Content Library
Note: Single Sign-On authentication is available
through the VMware vCenter Single Sign On API. Service discovery
is available through the Lookup Service API.
Distribution Kit
When you extract the contents of the vCloud Suite SDK for Perl distribution kit,
the vCloud Suite client SDK is placed in the VMware-vCloud-Suite-SDK-Perl-6.0.0 directory:
VMware-vCloud-Suite-SDK-Perl-6.0.0/
client/
docs/
EULA
README
You can download the vCloud Suite SDK for Perl distribution kit from the VMware Developer Center.
Known Issues
The following issues were discovered during testing.
-
Internal Server Error if Tagging Description Field is Empty
The Tag Category Description field is optional in the vSphere Web Services API, but it is mandatory in the vCloud Suite SDK. Therefore, if the description field is empty,
the vCloud Suite SDK can return an internal server error that states, "the ‘description’ field of the Category model is empty".
Workaround:
When creating tags, do not leave the description field empty. If you do not have any description, you may add a whitespace character (i.e. space).
-
Unauthenticated exception following long-running operation
After an API client completes a long-running operation, such as an upload to the content library, the next operation might fail with
an "Unauthenticated exception" message. This happens if the long running operation did not complete within the lifetime of the
authentication session.
Workarounds:
-
Keep the session alive by issuing short operations on another thread until the long running operation completes.
-
Increase the session length using the VMware vSphere Web Client. Select
Administration > System Configuration > Services > vAPI Endpoint > Manage > General,
and increase the value for the Maximum session idle time.
-
Perl async call limitations
Some of the key CPAN modules are not thread-safe. They may crash the Perl interpreter during execution, or may
dump core memory on termination.
To work around these difficulties,
the vCloud Suite SDK for Perl creates long lived threads to handle async calls.
On most systems, frequent and continual creation and destruction of async calls can lead to an ever-increasing number of
threads that increases the memory footprint of the Perl interpreter. It is a best practice to not use Perl async calls frequently.
-
Limitation with certificate validation
The samples in the vCloud Suite SDK for Perl do not perform
certificate validation for SSO endpoints.
The samples do validate certificates from other service endpoints.
|