Skip to main content
Versioning
Last update:

Versioning

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

Enable versioning can be in an existing container or with container creation.

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. The current version can be only one, the number of previous versions is unlimited.

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

The previous version of the object can be recover — to make it current.

Versions can be manage as regular objects (except for versions with the tag Deleted). If a container has been created access policy it must authorize the appropriate versioning.

View the list of object versions

  1. В control panels from the top menu, press Products and select Object Storage.
  2. Go to the section Containers.
  3. Open the container page → tab Objects.
  4. Turn on the toggle switch Versions.
  5. Under the object's line, look at its versions — they are labeled and have the same names.

Version ID

When versioning is enabled, each version is assigned a version ID (version_id) is a unique identifier. It can be used to control any version of the object. You can view version ID in the control panel.

If pause versioning, new objects will not be assigned a version ID — the value will be null. Older versions of objects will retain their version ID.

View Version ID

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

Enable versioning

  1. В control panels from the top menu, press Products and select Object Storage.
  2. Go to the section Containers.
  3. Open the container page → tab Configuration.
  4. In the block Versioning select Included.

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. В control panels go to the top menu, press Products and select Object Storage.
  2. Go to the section Containers.
  3. Open the container page → tab Configuration.
  4. In the block Versioning select Suspended.
  5. Click Save.

Tariffication

Each version takes up storage space, its storage capacity 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.