RGW-RESTORE-BUCKET-INDEX(8)

✨ NAME ✨

rgw-restore-bucket-index — bestie, this is the tool that tries to restore a bucket's objects back into its bucket index 🫶 (it's rgw-restore-bucket-index(8) from the Ceph manual, and she's experimental)

---

🌸 SYNOPSIS 🌸

rgw-restore-bucket-index

---

💖 DESCRIPTION 💖

rgw-restore-bucket-index is an EXPERIMENTAL RADOS gateway user administration utility. She scans the data pool for objects that belong to a given bucket and tries to add those objects back to the bucket index. Basically she's the "we lost the whole index, it's giving catastrophe" last-resort girlie. So please, please, thoroughly review the Warnings down below before you do anything. 🙈

She works with regular (i.e., un-versioned) buckets, versioned buckets, and buckets where versioning has been suspended. Versatility queen. 👑

---

⚠️ WARNINGS ⚠️

• This utility is currently considered EXPERIMENTAL. Like, she's still in her testing era.
• The results are unpredictable if the bucket is in active use while this utility is running. Do not be doing other stuff to that bucket at the same time, no cap.
• The results are unpredictable if only some of a bucket's objects are missing from the bucket index. In that case, consider using the "object reindex" subcommand of radosgw-admin to restore objects to the bucket index one-by-one instead.
• For objects in versioned buckets: if the latest version is a delete marker, it will be restored. But if a delete marker has been written over with a new version, then that delete marker will not be restored. This should have minimal impact on results, in that it recovers the latest version and previous versions are all accessible.

💀 Unpredictable means unpredictable, bestie. Read these twice.

---

🎀 COMMAND-LINE ARGUMENTS 🎀

• -b <bucket> — Specify the bucket to be reindexed. This one's the main character, you literally cannot skip her.
• -p <pool> — Optional ✨ — specify the data pool containing head objects for the bucket. If you omit it, the utility will try to determine the data pool on its own. She's independent like that.
• -r <realm-name> — Optional ✨ — specify the realm, if the restoration is not being applied to the default realm.
• -g <zonegroup-name> — Optional ✨ — specify the zonegroup, if the restoration is not being applied to the default zonegroup.
• -z <zone-name> — Optional ✨ — specify the zone, if the restoration is not being applied to the default zone.
• -l <rados-ls-output-file> — Optional ✨ — specify a file containing the output of a rados listing of the data pool. Since listing the data pool can be an expensive and time-consuming operation, if you're trying to recover the indices for multiple buckets, it could be more efficient to re-use the same listing. Recycle, reduce, reuse 🍓
• -t <temporary-directory> — Optional ✨ — specify a directory in which to store temporary files. The size of the temporary files is highly dependent on the number of bucket entries involved, so the partition on which the temporary directory exists should be of suitable size. Check your disk space first, fr fr.
• -y — Optional ✨ — proceed without further prompting. Without this option, the utility will display some information and prompt the user as to whether to proceed. When provided, the utility will simply proceed. Please use caution when using this option. 🚨

---

🌈 EXAMPLES 🌈

Attempt to restore the index for a bucket named summer-2023-photos:

$ rgw-restore-bucket-index -b summer-2023-photos

---

🦋 AVAILABILITY 🦋

rgw-restore-bucket-index is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at <https://docs.ceph.com> for more information. 📚

---

⭐ SEE ALSO ⭐

• radosgw-admin <>(8)

---

👑 Copyright 👑

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)

---

Okay that's the whole page, you ate that 💅 This was RGW-RESTORE-BUCKET-INDEX(8) from the dev manual, dated Aug 19, 2026 — go forth and restore those indices, bestie, and pls back up your bucket index next time 🎀✨💖