Skip to navigationSkip to main contentSkip to footerScaleway Docs

How to use bucket versioning

Versioning is a feature designed to keep multiple variants of an object in the same bucket. When enabled, it allows you to store, retrieve, and restore every version of your objects stored in a bucket.

Versioning allows you to easily recover your objects in case of unintended user actions or application failures.

Before you start

To complete the actions presented below, you must have:

How to enable versioning

  1. Click Object Storage in the Storage section of the side menu. A list of your buckets displays.
  2. Click the name of the bucket in which you want to enable versioning.
  3. Click the Bucket settings tab.
  4. Scroll down and click the toggle toggle icon under Bucket versioning. A pop-up appears.
  5. Type ENABLE to confirm your action, then click Enable bucket versioning to proceed.
Note

Once versioning is enabled, uploading an object with the same name as an existing object will create a new version of it. This new version consumes storage as well, which may lead to higher costs.

How to manage object versions

  1. Click Object Storage in the Storage section of the side menu. A list of your buckets displays.

  2. Click the name of your selected bucket. A list of the objects it contains appears.

  3. Click more icon next to the object you want to manage, then click Versioning. A list of the object versions displays.

  4. Click more icon next to a non-current object version to download it, or permanently delete it.

Note

To restore an object to a previous version, download the desired non-current version and upload it again. This action will replace the current version with the uploaded one.

How to suspend versioning

  1. Click Object Storage in the Storage section of the side menu. A list of your buckets displays.
  2. Click the name of your selected bucket.
  3. Click the Bucket settings tab.
  4. Scroll down and click the toggle toggle icon under Bucket versioning. A pop-up appears.
  5. Type SUSPEND to confirm your action, then click Suspend bucket versioning to proceed.
Important

Once versioning is suspended, no new object versions will be created. Versions created up until this point will remain stored and billable. Uploading an object with the same name as an existing object will overwrite it.

Still need help?

Create a support ticket
No Results