Versioning

Preserve previous versions of objects in a Stook Bucket and recover overwritten or deleted data.

Configure Versioning to preserve previous versions of objects when they are overwritten or deleted in a Stook Bucket.

Versioning provides three modes: Off, On, and Suspended. When Versioning is enabled, previous object versions remain available until they are permanently deleted.

After Versioning has been enabled, it cannot be switched back to Off. You can set it to Suspended, which stops creating new versions while preserving existing versions.

For complete request parameters, response schemas, and error responses, see Bucket Settings API.

How Versioning Works

Versioning supports the following modes:

Mode	Behavior
Off	Overwrites the previous copy of an object.
On	Preserves previous versions when objects are overwritten or deleted.
Suspended	Stops creating new versions while preserving existing versions.

Previous object versions consume storage capacity while they remain in the Stook Bucket.

When a versioned object is deleted without specifying a version ID, the object is hidden by a delete marker. Previous versions remain stored and can be restored.

Versioning Dependencies

Versioning must be On to use:

• MFA Delete

• Object Lock

Versioning cannot be suspended while MFA Delete or Object Lock is enabled.

Configure Versioning

1

Open the Stook Bucket

In the Medianova Control Panel, select Stook Object Storage → Buckets, then select the Stook Bucket you want to configure.

2

Open Versioning

On the Bucket configuration page, select Versioning.

3

Select the Versioning mode

Select one of the available modes:

• Off — overwrite the previous copy.

• On — keep every previous version.

• Suspended — stop creating new versions while keeping existing versions.

4

Save the configuration

Select Save Changes.

Work with Object Versions

Use an S3-compatible client, such as the AWS CLI, to list, download, restore, and permanently delete object versions.

Listing object versions and downloading an earlier version require the master key or an access key with All S3 Actions. The Versioning permission category does not include these actions.

Permanently removing an object version requires the Delete Object Version permission. See Manage Access Keys.

List Object Versions

aws s3api --endpoint-url https://<ENDPOINT_URL> \
  list-object-versions \
  --bucket <BUCKET_NAME> \
  --prefix <OBJECT_KEY>

This command lists the stored versions and delete markers associated with the specified object key.

Download an Earlier Version

aws s3api --endpoint-url https://<ENDPOINT_URL> \
  get-object \
  --bucket <BUCKET_NAME> \
  --key <OBJECT_KEY> \
  --version-id <VERSION_ID> \
  <LOCAL_FILE>

This command downloads the specified object version to the local file path without changing the current version stored in the Stook Bucket.

Restore a Deleted Object

A deleted object is hidden by a delete marker. To restore the object, identify the delete marker with list-object-versions, then remove that delete marker:

aws s3api --endpoint-url https://<ENDPOINT_URL> \
  delete-object \
  --bucket <BUCKET_NAME> \
  --key <OBJECT_KEY> \
  --version-id <DELETE_MARKER_VERSION_ID>

This command permanently removes the specified delete marker. Removing the delete marker makes the previous object version available again.

Permanently Delete an Object Version

aws s3api --endpoint-url https://<ENDPOINT_URL> \
  delete-object \
  --bucket <BUCKET_NAME> \
  --key <OBJECT_KEY> \
  --version-id <VERSION_ID>

This command permanently removes the specified object version. The deleted version cannot be recovered.

If MFA Delete is enabled, permanently deleting an object version or removing a delete marker also requires a code from the configured authenticator.

Configure Versioning with the API

Use the bucket settings endpoint to configure Versioning:

PATCH /api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/settings

To enable Versioning, send:

{
  "versioning": "enabled"
}

The versioning field supports the following values:

API value	Mode
unversioned	Off
enabled	On
suspended	Suspended

After Versioning has been enabled, unversioned can no longer be used for the Stook Bucket. Use suspended to stop creating new versions.

Troubleshooting

Versioning cannot be switched off

After Versioning has been enabled, it cannot return to Off.

Select Suspended instead. Existing versions remain available, but new versions are no longer created.

Versioning cannot be suspended while Object Lock is enabled

Object Lock requires Versioning to remain On.

Versioning cannot be suspended while Object Lock is enabled on the Stook Bucket.

Versioning cannot be suspended while MFA Delete is enabled

Disable MFA Delete before suspending Versioning.

Disabling MFA Delete requires a valid code from the configured authenticator.

Related Topics

• Bucket Configuration

• MFA Delete

• Object Lock

• Manage Access Keys