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 ?

Thanks,
Devendra



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 <[email protected]> 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:* [email protected]
>>>> [mailto:[email protected]] *On Behalf Of *Anne Gentle
>>>> *Sent:* Wednesday, May 08, 2013 4:38 PM
>>>> *To:* Gabriel Hurley
>>>> *Cc:* Devendra Gupta; [email protected]
>>>> *Subject:* Re: [Openstack] API version in Grizzly
>>>>
>>>>
>>>>
>>>> On Wed, May 8, 2013 at 4:54 PM, Gabriel Hurley
>>>> <[email protected]_ <mailto:[email protected]>> 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>[email protected]_
>>>> <mailto:[email protected]>] *On Behalf Of *Anne Gentle
>>>> *Sent:* Wednesday, May 08, 2013 2:44 PM
>>>> *To:* Devendra Gupta
>>>> *Cc:* [email protected]_ 
>>>> <mailto:[email protected]>
>>>> *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 <[email protected]_
>>>> <mailto:[email protected]>> 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     : [email protected]_
>>>> <mailto:[email protected]>
>>>> Unsubscribe : _https://launchpad.net/~openstack_
>>>> More help   : _https://help.launchpad.net/ListHelp_
>>>>
>>>>
>>>>
>>>
>>>
>>> _______________________________________________
>>> Mailing list: https://launchpad.net/~openstack
>>> Post to     : [email protected]
>>> Unsubscribe : https://launchpad.net/~openstack
>>> More help   : https://help.launchpad.net/ListHelp
>>
> 


_______________________________________________
Mailing list: https://launchpad.net/~openstack
Post to     : [email protected]
Unsubscribe : https://launchpad.net/~openstack
More help   : https://help.launchpad.net/ListHelp

Reply via email to