← Back to team overview

openstack team mailing list archive

Re: API version in Grizzly


I have few more questions related to APIs.

When you say Identity v3.0 development is going on side-by-side so I
think if I have Grizzly setup with Identity v2.0 then it'll be upgraded
to Identity v3.0 with Grizzly when new version is available in updates.
Though I might have option to upgrade it or not? OR Identity v3.0 will
be released with Havana ?

Another thing looks confusing to me in API Specification page
http://docs.openstack.org/api/api-specs.html, we have version number
mentioned with v1.0/v2.0 for some components (e.g. Object, Identity,
Networking) but v1/v2 for few others (e.g. Image, Compute). Is there any
special reason to not put ".0" in version for some components ?


On Friday 10 May 2013 07:30 PM, Devendra Gupta wrote:
> Thanks! Joi. I understood.
> Devendra
> On Thursday 09 May 2013 09:03 PM, heckj wrote:
>> That's not entirely the case - the API structure has changed rather significantly (mostly made more consistent and unified), so API calls to V2 may or may not match entirely with API calls to V3. We did go to the trouble of writing a very thorough spec, and then checking and updating it as we did the V3 API implementation. You can find that spec at https://github.com/openstack/identity-api/blob/master/openstack-identity-api/src/markdown/identity-api-v3.md
>> The WADL's that generate the V2 API didn't expose or explicitly set many of the administrative functions in V2, although the data structures returned a very similiar - there's also some additional concepts that are only exposed in V3 (domains, groups) - which may or may not be relevant to what you're trying to do.
>> tl;dr - don't assume the API translates perfectly forward
>> - joe
>> On May 9, 2013, at 7:24 AM, Devendra Gupta <dev29aug@xxxxxxxxx> wrote:
>>> Thanks, Anne and Gabriel. So I believe, if we develop something based on
>>> Identity v2.0 API then it will also support Identity v3.0, please
>>> correct me if I am wrong.
>>> Thanks,
>>> Devendra Gupta
>>> On 09-May-13 5:27 AM, Gabriel Hurley wrote:
>>>> In Grizzly I can send Keystone requests to either
>>>> _http://<keyston__e_host>:5000/v2.0/_
>>>> <http://<keystone_host>:5000/v2.0/> or to
>>>> _http://<keystone_host>:5000/v3/_ and both work just fine (provided I
>>>> send the right request). Both APIs are enabled, and simply have
>>>> different API controllers wired to different code paths under the hood.
>>>> The only thing making one “default” is the fact that DevStack (and by
>>>> extension a lot of guides and a lot of people’s existing copy-pasted
>>>> installations) have the Keystone v2.0 endpoint hard-coded into the
>>>> service catalog. See the various threads and my TC proposal for further
>>>> detail on what I think about that fact and what to do with it going forward.
>>>> As for api.openstack.org, I always look at the “Complete Reference”
>>>> (_http://api.openstack.org/api-ref.html_) which lists one version for
>>>> each service API (currently still Keystone v2.0). As long as you’re
>>>> taking feature requests, what I’d **like** to see when I land on that
>>>> page is a collapsed list of each service API type (e.g. Identity,
>>>> Compute, etc.) which I can then expand, revealing the list of available
>>>> versions. Expanding one of those should yield what I currently see on
>>>> the Complete Reference page. J
>>>> All the best,
>>>>  * Gabriel
>>>> *From:* annegentle@xxxxxxxxxxxxxxxxxx
>>>> [mailto:annegentle@xxxxxxxxxxxxxxxxxx] *On Behalf Of *Anne Gentle
>>>> *Sent:* Wednesday, May 08, 2013 4:38 PM
>>>> *To:* Gabriel Hurley
>>>> *Cc:* Devendra Gupta; openstack@xxxxxxxxxxxxxxxxxxx
>>>> *Subject:* Re: [Openstack] API version in Grizzly
>>>> On Wed, May 8, 2013 at 4:54 PM, Gabriel Hurley
>>>> <_Gabriel.Hurley@nebula.com_ <mailto:Gabriel.Hurley@xxxxxxxxxx>> wrote:
>>>> Identity service has both a v2.0 and v3 side-by-side. There isn’t
>>>> necessarily a “default” except for the fact that most people’s Service
>>>> Catalogs still say “v2.0” in them because they’re hard-coded that way.
>>>> Wow, really? I have asked and asked about that API in particular and
>>>> still don't understand how that really works. Can you explain more about
>>>> how that can happen other than mis-labeled endpoints?
>>>> In the future I believe the _api.openstack.org_
>>>> <http://api.openstack.org> site would gain a lot by storing
>>>> documentation for each version of the API for historical purposes,
>>>> legacy deployments, etc. Sure would help me, too. ;-)
>>>> Could you explain more about what "storing documentation for each
>>>> version of the API for historical purposes" would look like to you? We
>>>> have all versions (v 1.1, v2, v3.0) of each  API spec stored. Do you
>>>> want them published as well? We do so for Image API for example. Tell me
>>>> more.
>>>> Anne
>>>> -          Gabriel
>>>> *From:* Openstack [mailto:_openstack-bounces+gabriel.hurley_
>>>> <mailto:openstack-bounces%2Bgabriel.hurley>=_nebula.com@lists.launchpad.net_
>>>> <mailto:nebula.com@xxxxxxxxxxxxxxxxxxx>] *On Behalf Of *Anne Gentle
>>>> *Sent:* Wednesday, May 08, 2013 2:44 PM
>>>> *To:* Devendra Gupta
>>>> *Cc:* _openstack@lists.launchpad.net_ <mailto:openstack@xxxxxxxxxxxxxxxxxxx>
>>>> *Subject:* Re: [Openstack] API version in Grizzly
>>>> Hi Devendra,
>>>> Generally the guidance for the _api.openstack.org_
>>>> <http://api.openstack.org> site is to publish documents that reflect the
>>>> latest version, grizzly, as the underlying implementation for the API.
>>>> However the cloud provider can pick and choose which extensions they
>>>> have in place, for example, so some Compute extensions may be
>>>> unavailable on essex for example. 
>>>> Generally I believe this list of API versions is true for Grizzly
>>>> default implementations. PTLs please correct as needed:
>>>> Identity Service API 2.0
>>>> Compute API 2 and Extensions
>>>> Image Service API 2 (a provider could choose to implement v1)
>>>> Object Storage API 1.0
>>>> Networking API 2.0
>>>> Block Storage Service API 2.0
>>>> Thanks,
>>>> Anne
>>>> On Wed, May 8, 2013 at 3:23 PM, Devendra Gupta <_dev29aug@gmail.com_
>>>> <mailto:dev29aug@xxxxxxxxx>> wrote:
>>>> Hi,
>>>> I am trying to find the lasted stable API versions of all the OpenStack
>>>> components, I am looking around in OpenStack docs but unable to see some
>>>> specific page which says about particular version of APIs are available
>>>> with Grizzly.
>>>> I can see following pages but they don't say what version of API is
>>>> latest stable with Grizzly.
>>>> _http://docs.openstack.org/api/api-specs.html_
>>>> _http://api.openstack.org/api-ref.html_
>>>> I need this information to plan some work related to OpenStack, guidance
>>>> around this would be highly appreciate.
>>>> Thanks,
>>>> Devendra
>>>> _______________________________________________
>>>> Mailing list: _https://launchpad.net/~openstack_
>>>> Post to     : _openstack@lists.launchpad.net_
>>>> <mailto:openstack@xxxxxxxxxxxxxxxxxxx>
>>>> Unsubscribe : _https://launchpad.net/~openstack_
>>>> More help   : _https://help.launchpad.net/ListHelp_
>>> _______________________________________________
>>> Mailing list: https://launchpad.net/~openstack
>>> Post to     : openstack@xxxxxxxxxxxxxxxxxxx
>>> Unsubscribe : https://launchpad.net/~openstack
>>> More help   : https://help.launchpad.net/ListHelp

Follow ups