fling logo of OpenAPI interface for vSphere

OpenAPI interface for vSphere

version 1.0 — August 03, 2021

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

Similar Flings

May 23, 2022
fling logo of Virtual Machine Desired State Configuration

Virtual Machine Desired State Configuration

version 1.1.3 (4092207)

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.

Apr 27, 2018
fling logo of Cross vCenter VM Mobility - CLI

Cross vCenter VM Mobility - CLI

version 1.6.0

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.

Jul 25, 2023
fling logo of vSphere Diagnostic Tool

vSphere Diagnostic Tool

version 1.1.6

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.