Skip to content

Feature: Bucket Compare

When to use

Use this guide when you need to compare bucket states before migration or remediation.

Prerequisites

  • Access to /manager/bucket-compare.
  • bucket_compare_enabled set to true.
  • A UI user with Manager > Bucket compare access enabled.
  • Context with bucket management capability.

Before you start

Choose the comparison source and target deliberately. Compare results are only useful when the source and target contexts, bucket names, and optional modified-after cutoff match the remediation plan.

Steps

  1. Open Manager > Tools > Compare.
  2. Select source and target bucket scope.
  3. Optionally set Ignore objects modified after to exclude recently changed objects from the diff and remediation scope.
  4. Run comparison.
  5. Expand only the result rows you need to inspect; results stay collapsed by default.
  6. Review object-level details: key, size, modification date, ETag, storage class, Browser links, and direct download actions. Browser links open in a new tab so the comparison result stays available.
  7. Apply remediation actions only after validation.

Expected result

You get an actionable diff view to support controlled bucket alignment. Manager remediation actions apply only the exact object keys present in the current content diff section or object row.

Object keys are used exactly as selected, including leading/trailing spaces, whitespace-only names, and distinct Unicode spellings. For example, "report.txt" and " report.txt " are different objects; remediation never trims or normalizes their names. Partial-failure samples retain those exact keys.

You are done when

The result summary is reviewed, the relevant rows are expanded, and any remediation action is limited to the exact object keys you intended to align.

If you do not see this action

Check bucket_compare_enabled, your Manager tool access, and whether the selected context can manage buckets.

Limits / feature flags

Note

Tool visibility depends on the global feature flag, per-user Manager tool access, and context requirements.

Visual example

Bucket compare result showing detected differences and remediation actions Bucket compare result showing detected differences and remediation actions