VMware Cloud Director™ API Programming Guide for Service Providers
This edition of the VMware Cloud Director API Programming Guide provides information about version 36.0 of the VMware Cloud Director API.
VMware provides many different APIs and SDKs for applications and goals. This guide provides information about the VMware Cloud Director API for developers who are interested in creating RESTful clients of VMware Cloud Director.
Revision History
The VMware Cloud Director API version number is incremented whenever any of its types or operations changes. The VMware Cloud Director API Programming Guide is revised with each release of VMware Cloud Director. Versions of the VMware Cloud Director API that were not introduced in a VMware Cloud Director release are documented in the vCloud Air Compute Service Programming Guide . An API version can be deprecated whenever a newer version of the API supports an equivalent set of features. Use of a deprecated API version is not recommended. Support for an API version may be removed in the release following deprecation.
The life cycle of minor VMware Cloud Director API versions depends on the major product API version. For example, VMware Cloud Director API Version 35.2 reaches end of general support at the same time as VMware Cloud Director API Version 35.0.
| Revision Date | Description | Release Vehicle | Status |
|---|---|---|---|
| 15 Jul 2021 | API Version 36.0 | VMware Cloud Director 10.3 | supported |
| 8 Apr 2021 | API Version 35.2 | VMware Cloud Director 10.2.2 | supported |
| 15 Oct 2020 | API Version 35.0 | VMware Cloud Director 10.2 | supported |
| 9 Apr 2020 | API Version 34.0 | VMware Cloud Director 10.1 | supported |
| 19 Sep 2019 | API Version 33.0 | vCloud Director for Service Providers 10.0 | deprecated |
| 28 MAR 2019 | API Version 32.0 | vCloud Director for Service Providers 9.7 | deprecated Unsupported after the next major VMware Cloud Director release. |
| 04 OCT 2018 | API Version 31.0 | vCloud Director for Service Providers 9.5 | deprecated Unsupported after the next major VMware Cloud Director release. |
| 25 SEP 2017 | API Version 30.0 and earlier | vCloud Director 9.0 | not supported |
Intended Audience
This guide is intended for software developers who are building VMware Ready Cloud Services, including interactive clients of VMware Cloud Director. This guide discusses Representational State Transfer (REST) and RESTful programming conventions, the Open Virtualization Format Specification, and VMware Virtual machine technology. You must be familiar with these and other widely deployed technologies such as XML, HTTP, and the Windows or Linux operating system.
Related Publications
The VMware Cloud Director API Schema Reference includes reference material for all elements, types, queries, and operations in the VMware Cloud Director API. It also includes the schema definition files. The schema reference is available at https://code.vmware.com.
The VMware Cloud Director Service Provider Admin Portal Guide and VMware Cloud Director Tenant Portal Guide contain detailed information about many of the objects and operations referred to in this guide. Most users of the VMware Cloud Director API will find the information in those documents valuable when developing client applications. To access the current versions of these and other VMware publications, go to https://docs.vmware.com/.
Starting with version 9.5, VMware Cloud Director integrates OpenAPI. For information about VMware Cloud Director OpenAPI, see Getting Started with VMware Cloud Director OpenAPI at https://code.vmware.com.