manila/api-ref/source/share-access-rule-metadata.inc

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/{project_id}/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/{project_id}/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