NovaV3API

• Launchpad Entry: NovaSpec:nova-v3-api
• Created: 02 Nov 2012
• Contributors: Sean Dague

Summary

There are a number of inconsistencies in the Nova v2 API. These include error code inconsistencies (200 vs 202 returns), formatting inconsistencies (time stamps are in multiple formats), bugs, and straight up missing features that we assume the user has a tool to go directly to the database. We'll be creating a v3 API focused on cleaning up these changes, as well as promoting a few key extensions.

Release Note

There will be a new v3 API, and the v2 API will be deprecated, though still supported in the first release with v3.

Rationale

Nova needs to have an API which is "stable, performant, and capable of building 3rd party APIs on top of"

Implementation

v2 API will be copied to a v3 API directory, and fixes will come in there.

This section should describe a plan of action (the "how") to implement the changes discussed. Could include subsections like:

Test/Demo Plan

This need not be added or completed until the specification is nearing beta.

Unresolved issues

This should highlight any issues that should be addressed in further specifications, and not problems with the specification itself; since any specification with problems cannot be approved.

BoF agenda and discussion

Etherpad on this session from the Grizzly summit: https://etherpad.openstack.org/grizzly-nova-api

---