[openstack-dev] [keystone] endpoint versioning in API v3

Yee, Guang guang.yee at hp.com
Tue Jan 29 00:56:31 UTC 2013



I think we would need this when Keystone starting advertising both v2 and v3






From: Jorge Williams [mailto:jorge.williams at rackspace.com] 
Sent: Monday, January 28, 2013 12:55 PM
To: OpenStack Development Mailing List
Subject: Re: [openstack-dev] [keystone] endpoint versioning in API v3


The idea is that services can provide two resources: 


1.  One resource provides a list of available versions of the service
(Versions List)

2.  One resource  provides details about a particular version (Version


The idea was that the service catalog can give you a couple of pointers
where you can get metadata about the service.  For example:  is  it in Beta?
When was it last updated? Are any new versions available? Where can I find
documentation? etc.


For the nova API see examples 3.26 - 3.33 here:


-jOrGe W.



On Jan 28, 2013, at 2:21 PM, Dolph Mathews wrote:

I just noticed that we overlooked/forgot a feature from the v2
serviceCatalog API which includes the following attributes on each endpoint:


  "versionId": "1.0",

  "versionList": "https://compute.north.host/",

  "versionInfo": "https://compute.north.host/v1.0/",


I never completely understood the intended use case for these attributes...
e.g. if you can ask the remote service for a 'version list' then why does
keystone need to redundantly identify the API version of the endpoint and
enumerate options for each API version? I don't think you should have to
revise your service catalog to roll out a new API version, either. IMO,
clients should (ideally) start with an unversioned endpoint, receive a 300
Multiple Choice response, and select a compatible/acceptable versioned
endpoint before proceeding.


Is anyone using this feature in v2 and want to see it carried forward to v3?



OpenStack-dev mailing list
OpenStack-dev at lists.openstack.org


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20130129/c2fd9dcc/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/x-pkcs7-signature
Size: 6186 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20130129/c2fd9dcc/attachment.bin>

More information about the OpenStack-dev mailing list