Nova create volume snapshot doc is incorrect

[Carolyn Van Slyck]

I am using OpenStack Liberty and referencing http://developer.openstack.org/api-ref-compute-v2.1.html#createSnapshot from the Nova v2.1 API.

The request body for create volume snapshot is incorrect and looks like it is actually a response object instead of a request. Looking at the code (https://github.com/openstack/nova/blob/1221688fb873305ef7c5ac987e87f9522497ac0a/nova/api/openstack/compute/volumes.py#L530) the request should look like the sample below, where only volume_id is required:

{
  "snapshot": {
    "volume_id": "24f5921a-20d9-480f-9f70-c309b7627909"
    "force": False,
    "display_name": "my snaphot",
    "display_description": "a moment in time"
  }
}

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/280402
Committed: https://git.openstack.org/cgit/openstack/api-site/commit/?id=3c5a01d2193ca95e8469b6aa7e8d627a24ed71bf
Submitter: Jenkins
Branch: master

commit 3c5a01d2193ca95e8469b6aa7e8d627a24ed71bf
Author: Sana Khan <email address hidden>
Date: Tue Feb 16 02:33:34 2016 +0530

    Changes Create Snapshot link to snapshot-create-request.json
    Closes-Bug: #1540581
    Change-Id: I8a6c82d0e07848a434c838eff5628570548a8c25