manila/api-ref/source/share-access-rule-metadata.inc
Goutham Pacha Ravi de29398128 [doc] remove project_id from api endpoints
As of API version 2.60, a project_id is no
longer needed in the API URLs.

Fix the docs to indicate that.

Also fix up a few quota parameters that use
project_id in a different place in the API path.

Change-Id: I24b32c8521805a7d67d512d36d644c0f07c532ea
Implements: bp remove-project-id-from-urls
Signed-off-by: Goutham Pacha Ravi <gouthampravi@gmail.com>
2021-02-09 21:59:07 -08:00

95 lines
1.7 KiB
ReStructuredText

.. -*- rst -*-
============================================
Share access rule metadata (since API v2.45)
============================================
Updates, and unsets share access rule metadata.
Update share access rule metadata
==================================
.. rest_method:: PUT /v2/share-access-rules/{access_id}/metadata
.. versionadded:: 2.45
Updates the metadata for a share access rule.
Response codes
--------------
.. rest_status_code:: success status.yaml
- 200
.. rest_status_code:: error status.yaml
- 400
- 401
- 403
- 404
Request
-------
.. rest_parameters:: parameters.yaml
- project_id: project_id_path
- access_id: access_id_path
- metadata: access_metadata
Request example
---------------
.. literalinclude:: samples/share-access-rules-update-metadata-request.json
:language: javascript
Response parameters
-------------------
.. rest_parameters:: parameters.yaml
- metadata: access_metadata
Response example
----------------
.. literalinclude:: samples/share-access-rules-update-metadata-response.json
:language: javascript
Unset share access rule metadata
================================
.. rest_method:: DELETE /v2/share-access-rules/{access_id}/metadata/{key}
.. versionadded:: 2.45
Un-sets the metadata on a share access rule.
To unset a metadata key value, specify only the key name in the
URI.
Response codes
--------------
.. rest_status_code:: success status.yaml
- 200
.. rest_status_code:: error status.yaml
- 400
- 401
- 403
- 404
Request
-------
.. rest_parameters:: parameters.yaml
- project_id: project_id_path
- access_id: access_id_path
- key: metadata_key_path