[openstack-dev] [neutron] [API]Make API errors conform to the common error message without microversion

Xie, Xianshan xiexs at cn.fujitsu.com
Mon Apr 11 13:32:49 UTC 2016


Ping.

-----Original Message-----
From: Xie, Xianshan [mailto:xiexs at cn.fujitsu.com] 
Sent: Friday, April 08, 2016 4:24 PM
To: OpenStack Development Mailing List (not for usage questions)
Cc: Cao, Shufeng/曹 树烽; dougwig at parkside.io
Subject: [openstack-dev] [neutron] [API]Make API errors conform to the common error message without microversion

Hi, all,

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.

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.

According to the discussion, a new header would be a good idea to resolve this issue [4], we think.
For instance:
curl -X DELETE "http://xxx:9696/v2.0/networks/xxx" -H "Neutron-Common-Error-Format: True" 

But we haven't decided which header name will be used yet.
So how do you think which is the best appropriate one?
A: Neutron-Common-Error-Format
B: OpenStack-Neutron-Common-Error-Format
C: other (Could you please specify it? Thanks in advance)

Any comments would be appreciated.

[1] http://specs.openstack.org/openstack/api-wg/guidelines/errors.html
[2] https://review.openstack.org/#/c/113570/
[3] https://review.openstack.org/#/c/293306/
[4] https://bugs.launchpad.net/neutron/+bug/1554869

Best regards,
xiexs


__________________________________________________________________________
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




More information about the OpenStack-dev mailing list