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 VMware Aria Operations 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 VMware Aria Operations API. See Accessing Swagger Documentation for Schema Reference.

Accessing Swagger Documentation for Schema Reference

The VMware Aria Operations REST API documentation includes reference material for all elements, types, queries, and operations in the VMware Aria Operations 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, you must first log into VMware Aria Operations at the URL of your VMware Aria Operations 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 VMware Aria Operations 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 VMware Aria Operations 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.