openstack
/
manila
Code Issues Proposed changes

[doc] Move Experimental APIs description to a common place 

Change-Id: I41695632d48f7cbcbe008867671f8196b5543c93
This commit is contained in:
zhongjun 2017-08-17 16:36:19 +08:00 committed by zhongjun
parent 9042f14e47
commit eac27c40d9
5 changed files with 27 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
api-ref/source/consistency-group-snapshots.inc
View File

@ -23,11 +23,9 @@ actions to other roles.
.. note::
Consistency group snapshot APIs are part of an ``experimental`` feature
introduced in version 2.4. The APIs may change or be removed in further
versions of the Shared File Systems API. All experimental APIs
require the ``X-OpenStack-Manila-API-Experimental: True`` header to be
sent in the requests.
Consistency group snapshot APIs are part of the `experimental APIs
<http://developer.openstack.org/api-ref/shared-file-systems/
#experimental-apis>`_.
Consistency group snapshot APIs were removed in 2.31 API version. They
were replaced with 'share groups' APIs.

8
api-ref/source/consistency-groups.inc
View File

@ -18,11 +18,9 @@ other roles.
.. note::
Consistency groups APIs are part of an ``experimental`` feature introduced
in version 2.4. The APIs may change or be removed in further versions
of the Shared File Systems API. All experimental APIs require the
``X-OpenStack-Manila-API-Experimental: True`` header to be sent in the
requests.
Consistency groups APIs are part of the `experimental APIs
<http://developer.openstack.org/api-ref/shared-file-systems/
#experimental-apis>`_.
Consistency group APIs were removed in 2.31 API version. They were
replaced with 'share groups' APIs.

14
api-ref/source/experimental.inc Normal file
View File

@ -0,0 +1,14 @@
.. -*- rst -*-
=================
Experimental APIs
=================
.. important::
The following APIs are part of the `experimental feature <https://docs.
openstack.org/manila/latest/contributor/experimental_apis.html>`_ introduced
in version 2.4. The APIs may change or be removed in future versions of the
Shared File Systems API. All experimental APIs require the
``X-OpenStack-Manila-API-Experimental: True`` header to be sent in the
requests.

1
api-ref/source/index.rst
View File

@ -33,6 +33,7 @@ Shared File Systems API (EXPERIMENTAL)
.. rest_expand_all::
.. include:: experimental.inc
.. include:: share-migration.inc
.. include:: consistency-groups.inc
.. include:: consistency-group-snapshots.inc

15
api-ref/source/share-migration.inc
View File

@ -1,8 +1,8 @@
.. -*- rst -*-
===============
Share Migration
===============
================================
Share Migration (Since API v2.5)
================================
As an administrator, you can migrate a share with its data from one
location to another in a manner that is transparent to users and workloads.
@ -15,12 +15,9 @@ Possible use cases for data migration include:
.. note::
Share Migration APIs are part an the ``experimental`` feature
introduced in version 2.5. The APIs may change or be removed in further
versions of the Shared File Systems API. The changes are
documented within each API below. All experimental APIs require the
``X-OpenStack-Manila-API-Experimental: True`` header to be
sent in the requests.
Share Migration APIs are part of the `experimental APIs
<http://developer.openstack.org/api-ref/shared-file-systems/
#experimental-apis>`_ .
Migrate share (versions 2.5 to 2.14)