Summary
In this Fling, a new wire protocol is designed as an alternative to SOAP/XML. The new protocol is based on JSON and adhering to the industry-standard OpenAPI specification. The traditional API model is fully supported, allowing exposure of all existing APIs.
Benefits
- Applications employing both modern REST and traditional vSphere client APIs could be simplified as only one wire protocol has to be supported.
- Partners can use modern productivity tools while developing vSphere-based solutions.
- Existing APIs can be extended as needed, with the additions available simultaneously through both SOAP/XML and the new protocol.
- The time-to-market is moderate as the new protocol does not depend on existing APIs and does not require modifications to backend services.
The major legacy aspect that will not be addressed with this project is the API complexity, which will not be reduced.
The protocol is available for Scripting and for SDK-based development.
Scripting - To automate common tasks, customers will use industry-standard tools such as curl and Postman specialized in sending HTTP requests to a server. There are numerous resources on the Web on getting started with these common utilities.
Script consists of initial authentication, followed by a number of requests to achieve the desired functionality. Often, individual requests are developed by customizing readily-available samples to form a template which is then parametrized via the script CLI interface.
SDK-based development
Partners will use readily-available OpenAPI SDKs from 3rd-parties to develop more sophisticated applications.
With this approach, VMware-provided OpenAPI definitions are used in conjunction with a bindings generator to produce API interfaces for various programming languages. By using these bindings and the corresponding OpenAPI runtime, partners may develop a business-logic for managing vSphere based entirely on in-proc API calls.
Requirements
- vSphere 7.0 deployment
- Docker or Kubernetes environment
- JDK 8 or newer
- 8 GB RAM
Instructions
For more information, please see the SDK User Guide.
Video
Contributors
Similar Flings

Virtual Machine Desired State Configuration
Virtual Machine Desired State Configuration (VMDSC) allows virtual administrators to specify VM CPU/Memory desired state which will take effect upon the next Guest OS reboot. This removes the burden of having to schedule a downtime window with the business/app owners.

Cross vCenter VM Mobility - CLI
Cross vCenter VM Mobility - CLI is a command line interface (CLI) tool that can be used to migrate or clone a VM from one host to another host managed by a linked or isolated vCenter (VC) instance.

vSphere Diagnostic Tool
vSphere Diagnostic Tool is a python script that runs diagnostic commands on the Photon Appliance or ESXi platform to return useful troubleshooting data while running within the confines of the local environment with out upstream dependencies.