VMware vSphere Automation SDK for Java 6.7 Release Notes
|
VMware vSphere Automation SDK for Java 6.7 | 17 APR 2018
Check for additions and updates to these release notes.
|
What's in the Release Notes
The release notes cover the following topics:
The VMware vSphere Automation SDKs provide support for your client application infrastructure with services to perform management operations in your vSphere environment. This SDK also contains samples that demonstrate API extensibility and how the libraries work with other vSphere APIs.
The version 6.7 SDK enables programmatic access to the following services:
- Service discovery (Lookup Service)
- Authentication (Single Sign-On)
- Session management
- Tagging
- Content Library
- Virtual Machines
- vCenter Server Appliance management
- vCenter Server Appliance and Platform Services Controller appliance deployment
Note: Single Sign-On authentication is available through the VMware vCenter Single Sign-On API. Service discovery is available through the Lookup Service API.
You can clone and download the vSphere Automation SDK for Java distribution kit from https://github.com/vmware/vsphere-automation-sdk-java.
The vSphere Automation SDK for Java 6.7 runs with JDK 1.8 or later.
The vSphere Automation SDKs for vSphere 6.7 includes new APIs for:
- Storage Policy
- Guest Ops
- vCenter Server Appliance and Platform Services Controller appliance deployment
For information about the new APIs and samples, see the vSphere Automation repositories at GitHub.
The vcenter API includes the following methods that have known issues and might be removed in a future version. It is advised that these APIs are not invoked:
- DeploymentType.reconfigure
- PscRegistration.repoint
- Upgrade.cancel
- Deployment.rollback
Known Issues- 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.
- Samples unable to connect to server
If you run the samples in a JDK 1.7 environment, the samples will be unable to connect to vSphere services. The error message is:
Exception in thread "main" java.lang.RuntimeException:
javax.net.ssl.SSLPeerUnverifiedException: peer not authenticated
The error results from a transport encryption mismatch. In vSphere 6.5 and later, vSphere services run with enhanced security, using TLS 1.2. JDK 1.7 does not support the stronger version of TLS.
To run the samples, you must install JDK 1.8, which supports TLS 1.2. After you install JDK 1.8, set the JAVA_HOME variable to the location of JDK 1.8 on your system.
|