api-site/api-ref/source/share/v1/migrate-share.inc
Anne Gentle ac4cc65cb5 Adds migrated RST + YAML files from WADL
Contains .inc files which have all the contents of the .rst files
but are grouped together for easier editing.
Contains parameters.yaml, which has all parameters in one file.
Contains request and response samples (JSON and XML) that are
pointed to from the .inc files.

Change-Id: I42d5451300f95774a3ec4df66bc95cb36795844d
2016-05-02 17:42:49 -05:00

47 lines
872 B
ReStructuredText

.. -*- rst -*-
==========================
Experimental share actions
==========================
Migrate share
=============
.. rest_method:: POST /v2/{tenant_id}/shares/{share_id}/action
(Only for API v1.0-2.14) Migrates a share from one back end to another.
You can migrate a share from one back end to another but both back
ends must set the ``driver_handles_share_servers`` parameter to
``False``. If a share driver handles one of the back ends, this
action is not supported. You can configure a back end in the
``manila.conf`` file.
Error response codes:202,
Request
-------
.. rest_parameters:: parameters.yaml
- force_host_copy: force_host_copy
- host: host
- share_id: share_id
- tenant_id: tenant_id
Request Example
---------------
.. literalinclude:: ../samples/manila-share-actions-migrate-request.json
:language: javascript