doc/rados: add bucket rename command

Add "ceph osd crush rename bucket" command. This commit is made in
response to a request from Michele Giacomoli.

Fixes: https://tracker.ceph.com/issues/65599
Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 1030b572fa1680792b4c5843a6cf517bd31511ae)

diff --git a/doc/rados/operations/crush-map.rst b/doc/rados/operations/crush-map.rst
index 18f4dcb6d177e259200da32287ce20a7c4e862c0..eb608d8fcad5e858f3b92bfca106d459b77e5345 100644 (file)
--- a/doc/rados/operations/crush-map.rst
+++ b/doc/rados/operations/crush-map.rst
@@ -514,6 +514,16 @@ For details on this command's parameters, see the following:
    :Required: No
    :Example: ``datacenter=dc1 room=room1 row=foo rack=bar host=foo-bar-1``
 
+Renaming a bucket
+-----------------
+
+To rename a bucket while maintaining its position in the CRUSH map hierarchy,
+run a command of the following form:
+
+.. prompt:: bash #
+
+   ceph osd crush rename-bucket {oldname} {newname}
+
 Removing a Bucket
 -----------------