You can use a browser or an HTTP client program to send requests and receive responses.

REST Client Programs

Any client application that can send HTTPS requests is an appropriate tool for developing REST applications with the vRealize Operations Cloud API. REST client plug-ins are available for most browsers and many IDEs. The following open-source programs are commonly used:

  • cURL. http://curl.haxx.se
  • Postman application. http://www.getpostman.com

In addition, VMware provides language-specific client bindings for the vRealize Operations Cloud API. See About the Schema Reference.

About the Schema Reference

The vRealize Operations Cloud REST API documentation includes reference material for all elements, types, queries, and operations in the vRealize Operations Cloud API. It also includes the schema definition files.

Swagger based API documentation is available with the product, with the capability of making REST API calls right from the landing page.

To access the API documentation, use the URL of your vRealize Operations Cloud instance. For example, if the URL of your instance is https://www.mgmt.cloud.vmware.com, the API reference is available from: https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/doc/swagger-ui.html.
Note: If your organization is located outside of the United States, use the country abbreviation for your API endpoint. Using the wrong endpoint will result in a 404 error. For example, if your organization is located in Australia, your country abbreviation is AU and your API documentation will be available at:
https://au.www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/doc/swagger-ui.html

Language-specific client bindings are available from:

https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/

About the vRealize Operations Cloud API Examples

All examples include HTTP requests and responses. These examples show the workflow and content associated with operations such as creating and querying for information about objects in your monitored environment.

Example request bodies are in JSON. Request headers required by the vRealize Operations Cloud API are included in example requests that are not fragments of a larger example.

Most example responses show only those elements and attributes that are relevant to the operation being discussed. Ellipses (...) indicate omitted content within response bodies.