How to use the REST API to obtain the version of Aria Operations

Products

• VCF Operations/Automation (formerly VMware Aria Suite)

Issue/Introduction

This article explains how to obtain the version of VMware Aria Operations using the REST API.

Environment

VMware Aria Operations 8.18.x

Resolution

Follow these steps to use curl commands to obtain the version.

1. Run the following POST request command to acquire the API access token:
   

   curl -ks -X POST "https://<Ops-FQDN>/suite-api/api/auth/token/acquire" \
         -H "Accept: application/json" \
         -H "Content-Type: application/json" \
         -d '{"username": "admin", "password": "<PASSWORD>", "authSource": "local"}'

   Example output (The value for "token" is access token):

   {
     "token": "########-####-####-####-######################-####-####-####-############",
     "validity": 1783432729249,
     "expiresAt": "Tuesday, July 7, 2026 at 1:58:49 PM Coordinated Universal Time",
     "roles": []
   }

    

2. Run the following GET request command against the version endpoint, passing the token in the header:
   

   curl -ks -X GET "https://<Ops-FQDN>/suite-api/api/versions/current" \
          -H "Accept: application/json" \
          -H "Authorization: vRealizeOpsToken <ACCESS TOKEN>"

   Example output using the Step1's token (formatted with jq):

   $ curl -ks -X GET "https://<Ops-FQDN>/suite-api/api/versions/current" -H "Accept: application/json" -H "Authorization: vRealizeOpsToken ########-####-####-####-######################-####-####-####-############" | jq  
   {  
     "releaseName": "VMware Aria Operations 8.18.3",   <--- current versions is here  
     "major": 1,  
     "minor": 73,  
     "minorMinor": 0,  
     "buildNumber": 24521408,  
     "releasedDate": 1738195200075,  
     "humanlyReadableReleaseDate": "Thursday, January 30, 2025 at 12:00:00 AM Coordinated Universal Time",  
     "description": null  
   }