<div dir="ltr">So by adding the handling of a header to change the behaviour of the API, you're basically implementing a subset of microversions, with a non-standard header (See the API WG spec on non-proliferation of headers). You'll find it takes much of the work that implementing microversions does, and explodes your API test matrix some more. <br><br>Sounds like something that should go on hold until microversions is done, assuming that microversions are desired anyway. Standard error messages are not such a big win that they're worth non-standard headers and yet more API weirdness that needs to sit around potentially for a very long time (see the API WG rules on removing APIs, which is basically never)<br></div><div class="gmail_extra"><br><div class="gmail_quote">On 8 April 2016 at 11:23, Xie, Xianshan <span dir="ltr"><<a href="mailto:xiexs@cn.fujitsu.com" target="_blank">xiexs@cn.fujitsu.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi, all,<br>
<br>
We are attempting to make the neutron API conform to the common error message format recommended by API-WG [1]. As this change will introduce a new error format into neutron which is different from existing  format [2], we should think of some solutions to preserve the backward compat.<br>
<br>
The easiest way to do that is microversion, just like the cinder does [3] although which is still in progress. But unfortunately, there are many projects in which the microversion haven't been landed yet, e.g. neutron,  glance, keystone etc. Thus during the interim period we have to find other approaches to keep the backward compat.<br>
<br>
According to the discussion, a new header would be a good idea to resolve this issue [4], we think.<br>
For instance:<br>
curl -X DELETE "<a href="http://xxx:9696/v2.0/networks/xxx" rel="noreferrer" target="_blank">http://xxx:9696/v2.0/networks/xxx</a>" -H "Neutron-Common-Error-Format: True"<br>
<br>
But we haven't decided which header name will be used yet.<br>
So how do you think which is the best appropriate one?<br>
A: Neutron-Common-Error-Format<br>
B: OpenStack-Neutron-Common-Error-Format<br>
C: other (Could you please specify it? Thanks in advance)<br>
<br>
Any comments would be appreciated.<br>
<br>
[1] <a href="http://specs.openstack.org/openstack/api-wg/guidelines/errors.html" rel="noreferrer" target="_blank">http://specs.openstack.org/openstack/api-wg/guidelines/errors.html</a><br>
[2] <a href="https://review.openstack.org/#/c/113570/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/113570/</a><br>
[3] <a href="https://review.openstack.org/#/c/293306/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/293306/</a><br>
[4] <a href="https://bugs.launchpad.net/neutron/+bug/1554869" rel="noreferrer" target="_blank">https://bugs.launchpad.net/neutron/+bug/1554869</a><br>
<br>
Best regards,<br>
xiexs<br>
<br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature"><div dir="ltr"><div>-- <br>Duncan Thomas</div></div></div>
</div>