Aria Operations のバージョンを REST API で取得する方法

Products

• VCF Operations

Issue/Introduction

免責事項: これは英文の記事 「How to use the REST API to obtain the version of Aria Operations」 の日本語訳です。記事はベストエフォートで翻訳を進めているため、ローカライズ化コンテンツは最新情報ではない可能性があります。最新情報は英語版の記事で参照してください。

本記事は REST API を用いて Aria Operations のバージョンを取得する方法を説明します。

Environment

VMware Aria Operations 8.18.x

Resolution

以下の手順に従い curl コマンドを用いてバージョンを取得できます。

1. 以下のPOST リクエストコマンドを実行して API アクセストークンを取得します:
   

   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"}'

   出力例 ("token" の値がアクセストークンです) :

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

    

2.  ヘッダーにトークンを入れてバージョン用のエンドポイントに対して以下の GET リクエストコマンドを実行します。
   

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

   手順 1 のトークンを用いた出力例 (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",   <--- 現在のバージョン 
     "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  
   }