Skip to main content

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:

  1. Verified that NGT is installed and running on the VMs.

  2. Queried both /vms/list and /vms/{uuid} API endpoints.

  3. 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

  4. 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.

Be the first to reply!