2.5

Data Director API Overview 1
The Data Director API allows developers to build interactive clients of vFabric Data Director using a RESTful
application development style.
Data Director API calls communicate over HTTP, exchanging representations of Data Director objects. These
representations are encoded as XML elements or JSON objects, depending on the format of your request.
You use HTTP GET requests to retrieve the current representation of an object, HTTP POST and PUT requests
to create or update an object, and HTTP DELETE requests to delete an object.
This chapter includes the following topics:
n
“REST API Versioning,” on page 7
n
“Data Director Concepts,” on page 8
n
“Understanding Call Dependencies,” on page 9
n
“Client Workflow Overview,” on page 10
n
“Create a Data Director REST Request,” on page 11
REST API Versioning
The vFabric Data Director REST API supports versioning through HTTP Accept/Content-Type headers.
For example, if you want to use the version 2.0 APIs, append the vFabric Data Director version prefix to the
standard media type in the request Accept header.
Accept: application/vnd.vmware.vfdd-v2.0+json
The response will include a versioned Content-Type response header.
Content-Type: application/vnd.vmware.vfdd-v2.0+json
If you do not include a version prefix in the Accept header, then the response returns the latest version.
VMware, Inc.
7