]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commit
docs: set, get, list and remove custom metadata for snapshot
authorNikhilkumar Shelke <nshelke@redhat.com>
Wed, 27 Apr 2022 16:41:07 +0000 (22:11 +0530)
committerNikhilkumar Shelke <nshelke@redhat.com>
Thu, 2 Jun 2022 17:44:32 +0000 (23:14 +0530)
commit7e150a0ab3c8e4ca2268edd99dd5ef7d641c6d3e
treeeefb03c62dc005d3b813ecec1fd403c103a3fa8a
parentb683d5fd07f6391b4e73d72128c77ab89789e270
docs: set, get, list and remove custom metadata for snapshot

Set custom metadata on the snapshot as a key-value pair using
    $ ceph fs subvolume snapshot metadata set <vol_name> <subvol_name> <snap_name> <key_name> <value> [--group_name <subvol_group_name>]
    note: If the key_name already exists then the old value will get replaced by the new value.
    note: The key_name and value should be a string of ASCII characters (as specified in python's string.printable). The key_name is case-insensitive and always stored in lower case.
    note: Custom metadata on a snapshots is not preserved when snapshotting the subvolume, and hence, is also not preserved when cloning the subvolume snapshot.

Get custom metadata set on the snapshot using the metadata key::
    $ ceph fs subvolume snapshot metadata get <vol_name> <subvol_name> <snap_name> <key_name> [--group_name <subvol_group_name>]

List custom metadata (key-value pairs) set on the snapshot using::
    $ ceph fs subvolume snapshot metadata ls <vol_name> <subvol_name> <snap_name> [--group_name <subvol_group_name>]

Remove custom metadata set on the snapshot using the metadata key::
    $ ceph fs subvolume snapshot metadata rm <vol_name> <subvol_name> <snap_name> <key_name> [--group_name <subvol_group_name>] [--force]
    Using the '--force' flag allows the command to succeed that would otherwise fail if the metadata key did not exist.

Fixes: https://tracker.ceph.com/issues/55401
Signed-off-by: Nikhilkumar Shelke <nshelke@redhat.com>
(cherry picked from commit 59a0cbc14bf2832080e983729de5c462ddc70bb3)
doc/cephfs/fs-volumes.rst