VMware Cloud Provider Lifecycle Manager API overview

The VMware Cloud Provider Lifecycle Manager API is a single REST API that provides functionality to deploy and manage products supported by VMware Cloud Provider Lifecycle Manager: VMware Cloud Director, vCloud Usage Meter and vRealize Operations Manager Tenant App.

The API works similarly for each product and thus provides similar functionality and experience.

In order to get started with the VMware Cloud Provider Lifecycle Manager API, VMware Cloud Provider Lifecycle Manager should be set up and running first. A REST client (e.g. Postman) is recommended to be used to interact with the API directly, if the API is not integrated within existing scripts or automation.

Generally, each API call requires that a valid JSESSION token is passed as a header 'JSESSIONID'. The token has to be retrieved once via API call and is then valid for a certain time (default 15 minutes).

Retrieve Build and API version

VMware Cloud Provider Lifecycle Manager API supports API versioning, so that new functionality can be introduced with new API versions. Old API versions might get deprecated eventually.

In order to make sure the latest API version is used, the following API request can be made to retrieve version information.

Method: GET

URL: https://{{host}}:{{port}}/api/about

The response contains version information about the VMware Cloud Provider Lifecycle Manager, as well as the supported API versions.

Authentication

To get a valid JSESSIONID from VMware Cloud Provider Lifecycle Manager, the following request should be executed.

Method: POST

URL: https://{{host}}:{{port}}/api/v1/session

Headers: "Content-Type": "application/json"

Body:

{
    "username": "{{VCPLCM_USER}}",
    "password": "{{VCPLCM_PASSWORD}}"
}

If the provided credentials can be validated successfully, the JSESSIONID is returned in the response body.

Example response:

{
    "JSESSIONID":"123ABC456DEF789GHI"
}