
<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">

<meta name="Generator" content="Microsoft Exchange Server">

<!-- converted from rtf -->

<style><!-- .EmailQuote { margin-left: 1pt; padding-left: 4pt; border-left: #800000 2px solid; } --></style>

</head>

<body>

<font face="Calibri" size="2"><span style="font-size:10.5pt;">

<div align="left" style="text-align:justify;">Hi, guys,</div>

<div align="left" style="text-align:justify;"><font face="Times New Roman"> </font></div>

<div align="left" style="text-align:justify;">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.</div>

<div align="left" style="text-align:justify;">The Nova and Ironic already have Microversion implementation, and as I know Magnum <a href="https://review.openstack.org/#/c/184975/"><font color="#0563C1"><u>https://review.openstack.org/#/c/184975/</u></font></a>

is going to implement Microversion also.</div>

<div align="left" style="text-align:justify;"><font face="Times New Roman"> </font></div>

<div align="left" style="text-align:justify;">Hope all the projects which support( or plan to) Microversion can join the review of guideline.</div>

<div align="left" style="text-align:justify;"><font face="Times New Roman"> </font></div>

<div align="left" style="text-align:justify;">The Mircoversion specification(this almost copy from nova-specs): <a href="https://review.openstack.org/#/c/187112"><font color="#0563C1"><u>https://review.openstack.org/#/c/187112</u></font></a></div>

<div align="left" style="text-align:justify;">And another guideline for when we should bump Mircoversion <a href="https://review.openstack.org/#/c/187896/"><font color="#0563C1"><u>https://review.openstack.org/#/c/187896/</u></font></a></div>

<div align="left" style="text-align:justify;"><font face="Times New Roman"> </font></div>

<div align="left" style="text-align:justify;">As I know, there already have a little different between Nova and Ironic’s implementation. Ironic return min/max version when the requested</div>

<div align="left" style="text-align:justify;">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.</div>

<div align="left" style="text-align:justify;">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</div>

<div align="left" style="text-align:justify;">look at if you guys have compelling reason for using http headers.</div>

<div align="left" style="text-align:justify;"><font face="Times New Roman"> </font></div>

<div align="left" style="text-align:justify;">And if we think return body instead of http headers, we probably need think about back-compatible also. Because Microversion itself isn’t versioned.</div>

<div align="left" style="text-align:justify;">So I think we should keep those header for a while, does make sense?</div>

<div align="left" style="text-align:justify;"> </div>

<div align="left" style="text-align:justify;">Hope we have good guideline for Microversion, because we only can change Mircoversion itself by back-compatible way.</div>

<div align="left" style="text-align:justify;"><font face="Times New Roman"> </font></div>

<div align="left" style="text-align:justify;">Thanks</div>

<div align="left" style="text-align:justify;">Alex Xu</div>

<div align="left" style="text-align:justify;"><font face="Times New Roman"> </font></div>

</span></font>

</body>

</html>