7f2131e3a1
api-ref path needs update to support uploading cinder api-refs to developer.openstack.org/api-ref/block-storage update includes https://github.com/openstack/cinder/tree/master/api-ref/v2/source to https://github.com/openstack/cinder/tree/master/api-ref/source/v2 Depends-on: Id38dd0609c77b0d6bcd0d935a9312b0211134802 Implements: bp api-reference-to-rst Change-Id: If3a058a95f1eaa8481a926183591ff0f4b23e97b
51 lines
1.3 KiB
ReStructuredText
51 lines
1.3 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
==========================================
|
|
Volume manage extension (os-volume-manage)
|
|
==========================================
|
|
|
|
Creates volumes by using existing storage instead of allocating new
|
|
storage.
|
|
|
|
|
|
Manage existing volume
|
|
======================
|
|
|
|
.. rest_method:: POST /v2/{tenant_id}/os-volume-manage
|
|
|
|
Creates a Block Storage volume by using existing storage rather than allocating new storage.
|
|
|
|
The caller must specify a reference to an existing storage volume
|
|
in the ref parameter in the request. Although each storage driver
|
|
might interpret this reference differently, the driver should
|
|
accept a reference structure that contains either a source-id
|
|
or source-name element, if possible.
|
|
|
|
The API chooses the size of the volume by rounding up the size of
|
|
the existing storage volume to the next gibibyte (GiB).
|
|
|
|
Error response codes:202,
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: description
|
|
- availability_zone: availability_zone
|
|
- bootable: bootable
|
|
- volume_type: volume_type
|
|
- name: name
|
|
- volume: volume
|
|
- host: host
|
|
- ref: ref
|
|
- metadata: metadata
|
|
- tenant_id: tenant_id
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: ./samples/volume-manage-request.json
|
|
:language: javascript
|