Nutanix API V1 to V2 Migration Guide
This article provides guidelines for migrating from the Nutanix V0.8 and V1 REST APIs to V2. The scope of this article is to describe what has changed from V0.8/V1 to V2 and things to consider while planning to migrate.
Following is a summary of the differences between the V1 and V2 APIs. See the V2 API reference for full details.
Most entity names remain the same. One exception is that
containerhas been changed to
The structure of the URI endpoints has been changed. The V2 API endpoints follow this format:
The payload structures have changed.
All parameter names are now in snake case (for example,
alert_summary) rather than camel case (
Extra functionality has been added to some APIs. For example,
GET /vmhas boolean parameters that give more details:
include_vm_nic_configprovide detailed information about disk and NIC configuration respectively.
V2 works on both AHV and ESXi using the same calls. For example, V2
/vmCRUD (create, read, update, delete) operations work on both AHV and ESXi hosts. (Note: The vCenter Server responsible for managing the vSphere cluster must be added in Prism under Settings > vCenter Registration for the V2 API to work.)