[pbs-devel] [PATCH proxmox-backup v3 3/3] docs: add section for moving datastores

[Hannes Laimer]

Signed-off-by: Hannes Laimer <h.laimer at proxmox.com>
---
new in v3.

 docs/storage.rst | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/docs/storage.rst b/docs/storage.rst
index 54540219..00e45ce1 100644
--- a/docs/storage.rst
+++ b/docs/storage.rst
@@ -527,7 +527,25 @@ For backup groups, the existing privilege rules still apply. You either need a
 privileged enough permission or to be the owner of the backup group; nothing
 changed here.
 
-.. todo:: continue
+Moving Namespaces
+^^^^^^^^^^^^^^^^^
+
+You can move a namespace within the same datastore to reorganize the hierarchy. Moving the root
+namespace is not allowed, and cross-datastore moves are not supported.
+
+Requirements and limits:
+
+- Source namespace must exist and must not be the root
+- Target parent namespace must exist and the final destination must not already exist
+- You cannot move a namespace into one of its own sub-namespaces
+- The resulting depth cannot exceed the maximum depth
+
+Notes:
+
+- On local filesystems, moves are typically fast.
+- On S3-backed datastores (see :ref:`datastore_s3_backend`), moves may take longer and incur API
+  costs, as objects are re-written under a new prefix. For example, ``.cnt/a/b/...`` moved to
+  target namespace ``x/b`` becomes ``.cnt/x/b/...``.
 
 
 Options
-- 
2.47.3