From: Oguzhan Ozmen <oozmen@bloomberg.net>
Date: Wed, 1 Apr 2026 02:41:38 +0000 (+0000)
Subject: doc/rgw: add doc regarding bucket listing with pagination
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=2ca625237e2f9499fc4531c7f0a84c677186bd14;p=ceph.git

doc/rgw: add doc regarding bucket listing with pagination

Signed-off-by: Oguzhan Ozmen <oozmen@bloomberg.net>
---

diff --git a/PendingReleaseNotes b/PendingReleaseNotes
index 01184cf5419f..c08a80f56971 100644
--- a/PendingReleaseNotes
+++ b/PendingReleaseNotes
@@ -3,6 +3,10 @@
   very large namespaces.
 * RGW: Bucket Logging suppports creating log buckets in EC pools.
   Implicit logging object commits are now performed asynchronously.
+* RGW: radosgw-admin bucket list now supports pagination for versioned buckets by using
+  both --marker and --object-version options together (e.g., ``--marker=obj1 --object-version=abc123``).
+  This enables proper pagination through versioned bucket listings without duplicates or
+  infinite loops. For non-versioned buckets, use only --marker as before (backward compatible).
 * RGW: OpenSSL engine support is deprecated in favor of provider support.
   - Removed the `openssl_engine_opts` configuration option. OpenSSL engine configuration in string format is no longer supported.
   - Added the `openssl_conf` configuration option for loading specified providers as default providers.
diff --git a/doc/man/8/radosgw-admin.rst b/doc/man/8/radosgw-admin.rst
index 163dcc89e0d8..c21daf56efd6 100644
--- a/doc/man/8/radosgw-admin.rst
+++ b/doc/man/8/radosgw-admin.rst
@@ -83,6 +83,10 @@ as follows:
   list its objects. Adding --allow-unordered
   removes the ordering requirement, possibly generating results more
   quickly for buckets with large number of objects.
+  Use --marker to paginate through object listings (requires ordered listing;
+  do not use with --allow-unordered). For versioned buckets, also specify
+  --object-version with the instance/version ID to resume from a specific version
+  (e.g., ``--marker=obj1 --object-version=abc123``).
 
 :command:`bucket limit check`
   Show bucket sharding stats.