Skip to main content
Versioning
Last update:

Versioning

Versioning allows you to store and, if necessary, restore previous versions of objects — for example, if an object was accidentally deleted.

Enable versioning can be enabled in an existing container or when when creating a container.

Object versions⁠

A version of an object is an object with the same name that has been re-loaded.

The current version is the object that was loaded last, or the object that was restored from a previous version.Other versions of the object are previous versions.There can be only one current version, the number of previous versions is unlimited.

If versioning is enabled, when loading a new version of an object, the previous version of the object is not overwritten, but is added to the object's version list with the and the same object name.Each version is assigned a unique identifier.

The previous version of the object can be restored — made current.

Versions can be managed as normal objects (except for versions with the Deleted tag ).If an access policy is created in the container, it must allow appropriate actions on versions.

View the list of object versions⁠

  1. In the Control Panel, on the top menu, click Products and select Object Storage.
  2. Go to the Containers section.
  3. Open the container page → Objects tab.
  4. Turn on the Versions toggle switch.
  5. Under the object string, look at its versions — they are marked with and have the same names.

Version ID⁠

When versioning is enabled, each version is assigned a version ID (version_id) — a unique identifier.With its help you can manage any version of the object.You can view the version ID in the control panel.

If versioning is paused, new objects will not be assigned a version ID — the value will be null.Older versions of objects will still have a version ID.

View Version ID⁠

  1. In the Control Panel, on the top menu, click Products and select Object Storage.
  2. Go to the Containers section.
  3. Open the container page → Objects tab.
  4. Turn on the Versions toggle switch.
  5. In the version row, look for the identifier in the Version ID column.

Enable versioning⁠

  1. In the Control Panel, on the top menu, click Products and select Object Storage.
  2. Go to the Containers section.
  3. Open the container page → Configuration tab.
  4. In the Versioning block, select Enabled.

Suspend versioning⁠

Once versioning is suspended, existing versions of objects will not be deleted.

When a new version is loaded, it will overwrite the current version and will not be saved in the version list.

  1. In the Control Panel, go to the top menu, click Products, and select Object Storage.
  2. Go to the Containers section.
  3. Open the container page → Configuration tab.
  4. In the Versioning block, select Suspended.
  5. Click Save.

Tariffication⁠

Each version takes up storage space, and its storage capacity is charged. Deleted versions and versions that have been moved to another container do not take up space, but are displayed in the version list with the tag Deleted.