[Openstack-api-consumers] Consuming the service catalog and endpoints get list of supported enpoints *and* supported API versions for each

Steve Gordon sgordon at redhat.com
Wed Jul 19 18:32:55 UTC 2017


Hi folks,

David Flanders highlighted the existence of this list to me, and also the Consuming Service Catalog [1] document - which is somewhat relevant to what I'm trying to achieve but I need something a step beyond that. What I'm interested in once I have worked out all of the endpoints a given service catalog lists, is there a standard way (or a tool) to interrogate those endpoints to get the API versions each supports (both by default, and in general).

I had hacked up some basic BASH/Python to attempt this some time back but from recollection found that keystone's endpoint returned this information in a slightly different JSON structure than other endpoints (also different values like stable versus current for status of an API's support) and that some endpoints returned this without auth while others didn't. I'm assuming I'm not the only one to ever want to do this though so wondering if there is a tool somewhere that already encapsulates this? 

The actual problem I'm trying to solve, with my downstream product guy hat on, is that for a given build of Red Hat OpenStack I want to expose somewhere documentation (ideally automatically generated) as to what API versions were enabled and supported by default. This information appears in the marketplace per major version but this AFAIK is both manually curated (I've been asked by our marketing folks to confirm inputs for it in the past) - so prone to error - and focuses on major/minor version numbers when microversions are becoming increasingly important in a number of projects (e.g. if my app wants to use device role tagging w/ Nova I have to be very specific about which microversions are available for me to use as they have different "features"/opportunities for failure).

Thanks,

Steve

[1] http://specs.openstack.org/openstack/api-wg/guidelines/consuming-catalog.html
[2] https://www.openstack.org/marketplace/distros/distribution/red-hat/red-hat-openstack-platform



More information about the Openstack-api-consumers mailing list