os-quota-sets update documentation is incorrect

[Steve Gregory]

The documentation for os-quota-sets suggests that to update a quota one should make a POST request to v2/{tenant_id}/os-quota-sets/{tenant_id} with a request body of :
{
    "quota_set": {
        "security_groups": 45
    }
}

However, the correct implementation, and the implementation used when calling 'nova quota-update' requires that 'tenant_id' (the ID for the tenant or account to act on.) should also be included inside the quota_set, i.e.:
{
    "quota_set": {
        "security_groups": 45,
        "tenant_id": <tenant_id>
    }
}

Failure to add the tenant_id to the request parameter results in a 404 Resource Not Found error.

The Link to the reference documentation can be found here: http://api.openstack.org/api-ref.html#ext-os-quota-sets

[Steve Gregory (steve-gregory)]

One other thing I forgot to mention is that the request must be a PUT not a POST, as described in the documentation.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/50642

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/50642
Committed: http://github.com/openstack/api-site/commit/6ef127e564470e3fb75e652e87807ac3aa77d756
Submitter: Jenkins
Branch: master

commit 6ef127e564470e3fb75e652e87807ac3aa77d756
Author: Kersten Richter <email address hidden>
Date: Wed Oct 9 08:51:50 2013 -0500

    Use PUT instead of POST for updating a quota

    Partial-bug: 1218235
    Change-Id: Ic297637d40b2a5a01d2b60d6881d01a53ab051de

[Diane Fleming (diane-fleming)]

Miranda, Can you finish this one? Kersten did one part of it, but the request example needs to include the tenant ID as mentioned in the comments here.

[Miranda Zhang (miranda-zhang-q)]

if the original description is correct
"POST request to v2/{tenant_id}/os-quota-sets/{tenant_id}"

the most closely matched API call to me is
http://api.openstack.org/api-ref-compute.html#os-quota-sets
POST v2/​{tenant_id}​/os-quota-sets/​{user_id}​ Updates quotas for a specified tenant and user.

instead of

PUT v2/​{tenant_id}​/os-quota-sets Updates quotas for a tenant.
(which is kersten-r's change)

I'd like some confirmation on this, so I won't update in the wrong place.