<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Tue, Oct 29, 2013 at 7:22 AM, David Kranz <span dir="ltr"><<a href="mailto:dkranz@redhat.com" target="_blank">dkranz@redhat.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">As I looked at the havana release notes that talk about the v3 api, and as I was reviewing<br>
"port test_images and test_server_actions into v3 part2" <a href="https://review.openstack.org/#/c/39609/" target="_blank">https://review.openstack.org/#<u></u>/c/39609/</a>,<br>
I saw some less-than-obvious differences. For example, the images/get it seems now goes directly to glance which<br>
results in the returned state being 'active' instead of 'ACTIVE' as it was in v2. Another test was changed to expect the state to be<br>
'queued' when it used to be 'SAVING'. There are also all the changes regarding CamelCase of dict keywords.<br>
<br>
I saw there was work on documenting the v3 api but doesn't there also need to be some kind of release note that documents the incompatible changes that users need to account for in their client code when they start pointing it at a v3 server? Such a document would also make it much easier to review the v3 api tests in tempest. Does such information exist already?<br>

<br></blockquote><div><br></div><div>Unfortunately, no there isn't really - nothing that is specific to individual APIs. I've mainly been focussing on getting a V3 specification documentation up first (which I think is more important), but I do agree that a transition document would be very useful as well.<br>
<br></div><div>This is a broad description of what was done:<br><br><a href="https://etherpad.openstack.org/p/NovaV3APIHavana">https://etherpad.openstack.org/p/NovaV3APIHavana</a><br><br></div><div>which lists the types of changes which were made - eg CamelCase changes, removal of proxying of services like glance through Nova etc. But I agree we could do with something much better so its something we will do, I just can't make any guarantees of when it will be available yet.<br>
<br></div><div>Chris</div><div><br></div></div></div></div>