Hi Colleagues,
I am trying to collect operating system information for all virtual machines through the Nutanix Prism Central v3 API.
I’m using the following API endpoints:
-
POST /api/nutanix/v3/vms/list
to retrieve VM UUIDs -
GET /api/nutanix/v3/vms/{uuid}
to check detailed metadata per VM
However, in all cases, the OS information fields (e.g. guest_tools.guest_os_version
, guest_info.operating_system
, runtime_os
, etc.) are returning null
or “Unknown”, even for VMs that have Nutanix Guest Tools (NGT) installed and are visible in the Prism UI with proper OS details.
Steps I’ve taken:
-
Verified that NGT is installed and running on the VMs.
-
Queried both
/vms/list
and/vms/{uuid}
API endpoints. -
Tried multiple fields including:
-
.status.resources.guest_tools.guest_os_version
-
.status.resources.guest_info.operating_system
-
.status.resources.agented_info.guest_os_name
-
.spec.resources.guest_os_id
-
-
All these fields return
null
via API, but Prism UI shows correct OS information.
Expected result:
API should return the same OS information that is visible in Prism Central UI for each VM.
Actual result:
API response shows null
or “Unknown” for OS fields.
Request for assistance:
Please confirm:
-
Which exact API field or endpoint should return the VM OS info (as shown in Prism UI)?
-
Is there a known issue or limitation in the current Prism Central build regarding OS info reporting via API?
-
Any workaround to get OS info programmatically (e.g., via Prism Element API or alternative endpoints)?
Thank you in advance for your support.