"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/source/user/create-and-manage-shares.rst" between
manila-8.1.3.tar.gz and manila-8.1.4.tar.gz

About: OpenStack Manila provides “Shared Filesystems as a service”.
The "Stein" series (maintained release).

create-and-manage-shares.rst  (manila-8.1.3):create-and-manage-shares.rst  (manila-8.1.4)
skipping to change at line 164 skipping to change at line 164
| b6bd76ce-12a2-42a9-a30a-8a43b503867d | 10.254.0.3:/share-e1c2d35e-fe67-4 028-ad7a-45f668732b1d | False | | b6bd76ce-12a2-42a9-a30a-8a43b503867d | 10.254.0.3:/share-e1c2d35e-fe67-4 028-ad7a-45f668732b1d | False |
+--------------------------------------+---------------------------------- ----------------------+-----------+ +--------------------------------------+---------------------------------- ----------------------+-----------+
Allow read-write access Allow read-write access
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
#. Allow access. #. Allow access.
.. code-block:: console .. code-block:: console
$ manila access-allow myshare ip 10.0.0.0/24 $ manila access-allow myshare ip 10.0.0.0/24 --metadata key1=value1
+--------------+--------------------------------------+ +--------------+--------------------------------------+
| Property | Value | | Property | Value |
+--------------+--------------------------------------+ +--------------+--------------------------------------+
| id | 0c8470ca-0d77-490c-9e71-29e1f453bf97 |
| share_id | 8d8b854b-ec32-43f1-acc0-1b2efa7c3400 | | share_id | 8d8b854b-ec32-43f1-acc0-1b2efa7c3400 |
| access_type | ip |
| access_to | 10.0.0.0/24 |
| access_level | rw | | access_level | rw |
| state | new | | access_to | 10.0.0.0/24 |
| id | 0c8470ca-0d77-490c-9e71-29e1f453bf97 | | access_type | ip |
| state | queued_to_apply |
| access_key | None |
| created_at | 2016-03-24T14:51:36.000000 |
| updated_at | None |
| metadata | {'key1': 'value1'} |
+--------------+--------------------------------------+ +--------------+--------------------------------------+
.. note::
Since API version 2.45, metadata can be added, removed and updated for
share access rules in a form of key=value pairs.
#. List access. #. List access.
.. code-block:: console .. code-block:: console
$ manila access-list myshare $ manila access-list myshare
+--------------------------------------+-------------+-------------+------ +--------------------------------------+-------------+-------------+------
--------+--------+ --------+--------+------------+----------------------------+------------+
| id | access_type | access_to | acces | id | access_type | access_to | acces
s_level | state | s_level | state | access_key | created_at | updated_at |
+--------------------------------------+-------------+-------------+------ +--------------------------------------+-------------+-------------+------
--------+--------+ --------+--------+------------+----------------------------+------------+
| 0c8470ca-0d77-490c-9e71-29e1f453bf97 | ip | 10.0.0.0/24 | rw | 0c8470ca-0d77-490c-9e71-29e1f453bf97 | ip | 10.0.0.0/24 | rw
| active | | active | None | 2016-03-24T14:51:36.000000 | None |
+--------------------------------------+-------------+-------------+------ +--------------------------------------+-------------+-------------+------
--------+--------+ --------+--------+------------+----------------------------+------------+
The access is created. The access is created.
Allow read-only access Allow read-only access
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
#. Allow access. #. Allow access.
.. code-block:: console .. code-block:: console
$ manila access-allow myshare ip 20.0.0.0/24 --access-level ro $ manila access-allow myshare ip 20.0.0.0/24 --access-level ro
+--------------+--------------------------------------+ +--------------+--------------------------------------+
| Property | Value | | Property | Value |
+--------------+--------------------------------------+ +--------------+--------------------------------------+
| id | f151ad17-654d-40ce-ba5d-98a5df67aadc |
| share_id | 8d8b854b-ec32-43f1-acc0-1b2efa7c3400 | | share_id | 8d8b854b-ec32-43f1-acc0-1b2efa7c3400 |
| access_type | ip |
| access_to | 20.0.0.0/24 |
| access_level | ro | | access_level | ro |
| state | new | | access_to | 20.0.0.0/24 |
| id | f151ad17-654d-40ce-ba5d-98a5df67aadc | | access_type | ip |
| state | queued_to_apply |
| access_key | None |
| created_at | 2016-03-24T14:54:11.000000 |
| updated_at | None |
| metadata | {} |
+--------------+--------------------------------------+ +--------------+--------------------------------------+
#. List access. #. List access.
.. code-block:: console .. code-block:: console
$ manila access-list myshare $ manila access-list myshare
+--------------------------------------+-------------+-------------+------ +--------------------------------------+-------------+-------------+------
--------+--------+ --------+--------+------------+----------------------------+------------+
| id | access_type | access_to | acces | id | access_type | access_to | acces
s_level | state | s_level | state | access_key | created_at | updated_at |
+--------------------------------------+-------------+-------------+------ +--------------------------------------+-------------+-------------+------
--------+--------+ --------+--------+------------+----------------------------+------------+
| 0c8470ca-0d77-490c-9e71-29e1f453bf97 | ip | 10.0.0.0/24 | rw | 0c8470ca-0d77-490c-9e71-29e1f453bf97 | ip | 10.0.0.0/24 | rw
| active | | active | None | 2016-03-24T14:51:36.000000 | None |
| f151ad17-654d-40ce-ba5d-98a5df67aadc | ip | 20.0.0.0/24 | ro | f151ad17-654d-40ce-ba5d-98a5df67aadc | ip | 20.0.0.0/24 | ro
| active | | active | None | 2016-03-24T14:54:11.000000 | None |
+--------------------------------------+-------------+-------------+------ +--------------------------------------+-------------+-------------+------
--------+--------+ --------+--------+------------+----------------------------+------------+
The access is created. The access is created.
Update access rules metadata
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#. Add a new metadata.
.. code-block:: console
$ manila access-metadata 0c8470ca-0d77-490c-9e71-29e1f453bf97 set key2=val
ue2
$ manila access-show 0c8470ca-0d77-490c-9e71-29e1f453bf97
+--------------+--------------------------------------+
| Property | Value |
+--------------+--------------------------------------+
| id | 0c8470ca-0d77-490c-9e71-29e1f453bf97 |
| share_id | 8d8b854b-ec32-43f1-acc0-1b2efa7c3400 |
| access_level | rw |
| access_to | 10.0.0.0/24 |
| access_type | ip |
| state | active |
| access_key | None |
| created_at | 2016-03-24T14:51:36.000000 |
| updated_at | None |
| metadata | {'key1': 'value1', 'key2': 'value2'} |
+--------------+--------------------------------------+
#. Remove a metadata key value.
.. code-block:: console
$ manila access-metadata 0c8470ca-0d77-490c-9e71-29e1f453bf97 unset key
$ manila access-show 0c8470ca-0d77-490c-9e71-29e1f453bf97
+--------------+--------------------------------------+
| Property | Value |
+--------------+--------------------------------------+
| id | 0c8470ca-0d77-490c-9e71-29e1f453bf97 |
| share_id | 8d8b854b-ec32-43f1-acc0-1b2efa7c3400 |
| access_level | rw |
| access_to | 10.0.0.0/24 |
| access_type | ip |
| state | active |
| access_key | None |
| created_at | 2016-03-24T14:51:36.000000 |
| updated_at | None |
| metadata | {'key2': 'value2'} |
+--------------+--------------------------------------+
Deny access Deny access
~~~~~~~~~~~ ~~~~~~~~~~~
#. Deny access. #. Deny access.
.. code-block:: console .. code-block:: console
$ manila access-deny myshare 0c8470ca-0d77-490c-9e71-29e1f453bf97 $ manila access-deny myshare 0c8470ca-0d77-490c-9e71-29e1f453bf97
$ manila access-deny myshare f151ad17-654d-40ce-ba5d-98a5df67aadc $ manila access-deny myshare f151ad17-654d-40ce-ba5d-98a5df67aadc
 End of changes. 11 change blocks. 
31 lines changed or deleted 89 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)