Versioning

The Wasabi versioning feature allows you to preserve, retrieve, and restore every version of every object stored in the same Wasabi bucket. Versioning offers an additional level of protection by providing a means of recovery if you accidentally overwrite or delete objects. This allows you to easily recover from unintended user actions and application failures. You can also use versioning for data retention and archiving.

When bucket versioning is enabled, every version of every object in the bucket will be stored. You can then retrieve and restore any version of an object in the bucket. This provides protection against inadvertent removal of an object (such as by overwriting or expiration). You can enable bucket versioning:

• While creating a bucket, as described in Bucket Versioning
• After a bucket has been created (that is, for an existing bucket displayed in the Buckets list), as described below

Once you enable versioning for a bucket, Wasabi preserves existing objects any time you perform a PUT, POST, COPY, or DELETE operation on them. By default, GET requests will retrieve the most recently written version. Older versions of an overwritten or deleted object can be retrieved by specifying a version in the request.

Enabling/Disabling Bucket Versioning

1. On the Buckets list, clickfor the desired bucket.
2. Select Settings.
3. On the PROPERTIES panel, open the Versioning drop-down.

   

4. Click the Versioning toggle to enable or disable the feature. When enabled, the toggle appears as:
   
   When disabled, the creation of object versions is suspended for all operations though existing object versions are preserved. When versioning is suspended, the toggle appears as:
   
5. Review the note about versioning. If you are enabling toggling, you will see:

   

   If you are disabling toggling, you will see:

   

6. If you are sure you want to enable versioning for the selected bucket, click Toggle.

Showing Versions in the Objects List

When versioning is enabled, you can show the versions in the Objects list by clicking Show Versions in the upper right of the list:Use this feature to toggle between displaying and hiding file versions in the list of objects.

When versions are shown, they appear as the current object (noted with a Version ID) and a version (indicated with). In the example, the file named, callout-2.png, has versions. The current version of the file is listed first and previous versions are shown beneath it with the marker.

Consider the example below. The bottom-most callout-2.png listed is the original file (dated Feb 16, 2024, 10:47 AM) has a version ID of null because it was not a version when originally uploaded. A version of callout-2.png was uploaded on Feb 16, 2024, 3:26 PM, and has a version ID, as does the current version (uploaded on Feb 17, 2024, 4:20 PM).

Note: As described in Step 2 in Getting Started: Working with a Bucket, objects in a bucket are listed with an icon that indicates the file type.