[openstack-dev] [api] [Nova] [Ironic] [Magnum] Microversion guideline in API-WG

Jay Lau jay.lau.513 at gmail.com
Thu Jun 4 09:41:06 UTC 2015

Hi Alex,

Based on my understanding, the Mangum code base is get from Ironic, that's
why Magnum using http headers because when Magnum was created, Ironic is
also using http headers.

Perhaps Magnum can follow the way how Ironic move to use Microversion?


2015-06-04 14:58 GMT+08:00 Xu, Hejie <hejie.xu at intel.com>:

>  Hi, guys,
> I’m working on adding Microversion into the API-WG’s guideline which make
> sure we have consistent Microversion behavior in the API for user.
> The Nova and Ironic already have Microversion implementation, and as I
> know Magnum *https://review.openstack.org/#/c/184975/*
> <https://review.openstack.org/#/c/184975/> is going to implement
> Microversion also.
> Hope all the projects which support( or plan to) Microversion can join the
> review of guideline.
> The Mircoversion specification(this almost copy from nova-specs):
> *https://review.openstack.org/#/c/187112*
> <https://review.openstack.org/#/c/187112>
> And another guideline for when we should bump Mircoversion
> *https://review.openstack.org/#/c/187896/*
> <https://review.openstack.org/#/c/187896/>
> As I know, there already have a little different between Nova and Ironic’s
> implementation. Ironic return min/max version when the requested
> version doesn’t support in server by http-headers. There isn’t such thing
> in nova. But that is something for version negotiation we need for nova
> also.
> Sean have pointed out we should use response body instead of http headers,
> the body can includes error message. Really hope ironic team can take a
> look at if you guys have compelling reason for using http headers.
> And if we think return body instead of http headers, we probably need
> think about back-compatible also. Because Microversion itself isn’t
> versioned.
> So I think we should keep those header for a while, does make sense?
> Hope we have good guideline for Microversion, because we only can change
> Mircoversion itself by back-compatible way.
> Thanks
> Alex Xu
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


Jay Lau (Guangya Liu)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150604/5aeba850/attachment.html>

More information about the OpenStack-dev mailing list