<div dir="ltr"><div><div>Hi Alain,<br>We do already have a doc bug for this one, thanks for identifying it as well. You can subscribe yourself here: <br><a href="https://bugs.launchpad.net/openstack-api-site/+bug/1187277">https://bugs.launchpad.net/openstack-api-site/+bug/1187277</a><br>

<br></div>Diane Fleming is a great contributor to the API docs, and is currently assigned to fix this bug, but if you reach out to her she could also walk you through how to fix it yourself. The way this page is put together is written up on my blog at <a href="http://justwriteclick.com/2013/04/14/how-its-made-the-openstack-api-reference-page/">http://justwriteclick.com/2013/04/14/how-its-made-the-openstack-api-reference-page/</a> so you could get a deep dive if you like. <br>

<br></div>Thanks,<br>Anne<br></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Nov 6, 2013 at 11:56 PM, Alain Roy <span dir="ltr"><<a href="mailto:A.Roy@f5.com" target="_blank">A.Roy@f5.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">




<div>
<div style="direction:ltr;font-size:10pt;font-family:Tahoma">Hello,<br>
<br>
I've been looking at the APIs for Nova's os-quota-sets, and the docs don't seem to match the implementation. Or perhaps I'm confused--I'm no expert here. Here's what I'm seeing:<br>
<br>
The docs at <<a href="http://api.openstack.org/api-ref-compute.html" target="_blank">http://api.openstack.org/api-ref-compute.html</a>> show the quota API as:<br>
<br>
    GET v2/{tenant_id}/os-quota-sets<br>
<br>
However, the nova command-line tool and my experimentation suggest that the correct usage is:<br>
<br>
    GET v2/{tenant_id}/os-quota-sets/{tenant_id}<br>
<br>
The docs also show that I can get details, which will show me not just the quotas but also the current usage with:<br>
<br>
    GET v2/{tenant_id}/os-quota-sets/{user_id}/detail<br>
<br>
I've tried various combinations on this theme and cannot get the 'detail' API to work. I'm not super familiar with the OpenStack code base, but when I looked at the code it appeared that it's not implemented. (The data is there, but I think it's not exposed
 via the API). Moreover, the user quotas only seem to be in Havana while project quotas are in Havana and earlier. But when I browse the API docs, I can't tell what might be available in Havana and what might be available in earlier versions.
<br>
<br>
Horizon (Grizzly) shows detail similar to what the detail API says it provides, but when I look at the nova-api.log file, it's not using the osg-quota-sets/detail API, but appears to be synthesizing the data from the quotas plus the server and flavor details.
<br>
<br>
Am I correct that the docs don't match the implementation? If so, what's the best thing to do? Should I file a bug or should I provide a fix to the docs? (I'm not confident that I know the correct documentation, but I'd be willing to try.)
<br>
<br>
Thanks,<br>
-alain<br>
<br>
</div>
</div>

<br>_______________________________________________<br>
Mailing list: <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack</a><br>
Post to     : <a href="mailto:openstack@lists.openstack.org">openstack@lists.openstack.org</a><br>
Unsubscribe : <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack</a><br>
<br></blockquote></div><br></div>