vSphere Automation API
This is the vSphere REST API Reference. It provides API documentation, request/response samples, and usage description of the following vSphere services:
Notice: Dear users, due to an issue with rendering VCF API documentation, please treat any '__' in the query parameters as '?'. We are working on providing a fix shortly. Please toggle to the 8.0.3(Latest) documentation for the better experience.
Getting Started with vSphere REST APIs in 5 Minutes
To get you started quickly let’s dive into the necessary steps to enable you to begin calling APIs.
Step 1 - Authenticate to the API Endpoint
The first setup is to create a session ID using the following API:
POST Create Session
Step 2 - Use the session ID in subsequent calls
On subsequent API calls you will need to include the session ID returned in the above call using an HTTP header as follows:
For more details on the API sessions you can refer Common Infrastruture Services documentation.
Step 3 - Create your first Virtual Machine
You have been authenticated and have retrieved your API session ID. Now, you can create your first virtual machine using this API:
POST Create VM
Step 4 - Get details about your VM
Once your VM is created, you can get the details of your VM by passing VM identifier
GET Get VM
API Categories
Appliance
The Appliance APIs provides services for managing vCenter Appliance configuration.
Common Infrastructure Services(CIS)
The CIS APIs provide VMware common infrastructure services such as session management, tags, and task management.
Content
The Content APIs provide services to manage and configure content libraries.
ESX
The ESX APIs provide services related to host management, host provisioning, KMS, and many more.
VAPI
the VAPI APIs provide access to VAPI meta data.
vCenter
The vcenter API provides services for managing and configuring vSphere environments.
vStats
The vStats APIs provide services to manage and collect metrics on objects inside your vSphere environment.