Open Stack

Hi, Jay, I would say follow what happened on this guideline https://review.openstack.org/#/c/187112 :)

From: Jay Lau [mailto:jay.lau.513 at gmail.com]
Sent: Thursday, June 4, 2015 5:41 PM
To: OpenStack Development Mailing List (not for usage questions)
Subject: Re: [openstack-dev] [api] [Nova] [Ironic] [Magnum] Microversion guideline in API-WG

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?
Thanks.


2015-06-04 14:58 GMT+08:00 Xu, Hejie <hejie.xu at intel.com<mailto: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/ 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
And another guideline for when we should bump Mircoversion 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://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev



--
Thanks,
Jay Lau (Guangya Liu)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150605/8a6e99dc/attachment.html>