Open Stack

Hi Michael,

We discussed this at the API-WG meeting today (occurs at 16:00 UTC on Thursdays, #openstack-meeting-3). A point regarding the ‘/’ endpoint and the versions response is made in the microversions guideline [1]<https://specs.openstack.org/openstack/api-wg/guidelines/microversion_specification.html#version-discovery>. I was testing the services you mentioned (+ manila), the results from my environment are here [2].<http://paste.openstack.org/show/569282/> Looks like none of the services require authentication to make a request to the bare endpoint. What am I missing? One thing to note is that you included the tenant ID and /v3 in case of cinder; why is that?

When instantiating a client and performing version negotiation, you may have auth details; but looks like we have some consistency among all of the projects you mentioned to not require auth. Maybe we can add this to [1].

Thanks,
Goutham

[1] https://specs.openstack.org/openstack/api-wg/guidelines/microversion_specification.html#version-discovery
[2] http://paste.openstack.org/show/569282/


From: Michael Krotscheck <krotscheck at gmail.com>
Reply-To: "OpenStack Development Mailing List (not for usage questions)" <openstack-dev at lists.openstack.org>
Date: Tuesday, August 30, 2016 at 1:11 PM
To: "OpenStack Development Mailing List (not for usage questions)" <openstack-dev at lists.openstack.org>
Subject: [openstack-dev] [api] [devstack] [ocata] Consistent Endpoint Discovery

Hey everyone - I have a little bit of a UX request for our API developers.

For the last week or so, I've been working on building version negotiation logic for an OpenStack SDK. The process is pretty simple:

1- Read clouds.yaml for the keystone URL.
2- Query keystone for the service catalog.
3- Instantiate service instances for each discovered service.
4- Perform version negotiation on each service.

The problem: the service endpoints registered in the catalog all behave just a little bit differently, which makes building consistent version negotiation a royal PITA. I've annotated the various behaviors from a default devstack configuration here: http://paste.openstack.org/show/564863/.

In a perfect world, every endpoint would return the same type of resource - most likely the versions resource as described in the API WG Microversions spec. It would also be nice if version negotiation can happen without requiring authentication, the easiest path to which would be supporting the 'max_version' and 'min_version' fields in the root versions resource.

Sadly, this is my last week before I'm no longer paid to contribute to the OpenStack community, so I can't take on the responsibility of proposing something of this magnitude as an Ocata goal with only my own free time to offer. Is there anyone willing to help push this forward?

Michael
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160908/9bd37a97/attachment.html>