Managing bucket versioning

Written by

Yandex Cloud

Improved by

Tania L.

Updated at May 6, 2026

Bucket versioning enables keeping a history of an object through its versions.

Warning

You cannot disable versioning once you enable it; however, you can pause new version creation. After you pause versioning, new objects will be saved as null versions.

Note

With object version lock on, versioning cannot be paused.

To enable bucket versioning:

Management console

Yandex Cloud CLI

AWS CLI

Terraform

API

In the management console, select any folder.
Navigate to Object Storage.
Click the name of the bucket in question.
In the left-hand panel, select Settings.
Select the Versioning tab.
To enable or pause versioning, use Store object change history.
Click Save.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

See the description of the CLI command for editing a bucket ACL:
```
yc storage bucket update --help
```

Run this command:

yc storage bucket update --name <bucket_name> --versioning versioning-enabled

Result:

name: my-bucket
folder_id: csgeoelk7fl15********
default_storage_class: STANDARD
versioning: VERSIONING_ENABLED
max_size: "10737418240"
acl: {}
created_at: "2022-12-14T08:42:16.273717Z"

If you do not have the AWS CLI yet, install and configure it.

Run this command:

aws --endpoint https://storage.yandexcloud.net \
  s3api put-bucket-versioning \
  --bucket <bucket_name> \
  --versioning-configuration 'Status=Enabled'

Note

If you access Object Storage via Terraform under a service account, assign to the service account the relevant role, e.g., storage.admin, for the folder you are going to create the resources in.

If you do not have Terraform yet, install it and configure the Yandex Cloud provider.

Retrieve static access keys: a secret key and key ID used for Object Storage authentication.

Note

In addition to static access keys, you can use an IAM token for authentication in Object Storage. For more details, see Creating a bucket and the relevant provider documentation.

In the configuration file, describe the resources you want to create:

resource "yandex_iam_service_account" "sa" {
  name = "<service_account_name>"
}

// Assigning a role to a service account
resource "yandex_resourcemanager_folder_iam_member" "sa-admin" {
  folder_id = "<folder_ID>"
  role      = "storage.admin"
  member    = "serviceAccount:${yandex_iam_service_account.sa.id}"
}

// Creating a static access key
resource "yandex_iam_service_account_static_access_key" "sa-static-key" {
  service_account_id = yandex_iam_service_account.sa.id
  description        = "static access key for object storage"
}

resource "yandex_storage_bucket" "b" {
  bucket     = "<bucket_name>"
  access_key = yandex_iam_service_account_static_access_key.sa-static-key.access_key
  secret_key = yandex_iam_service_account_static_access_key.sa-static-key.secret_key
  acl        = "private"

  versioning {
    enabled = true
  }
}

Where:

bucket: Bucket name. This is a required setting.
access_key: Static access key ID.
secret_key: Secret access key value.
acl: ACL policy to apply. The default value is private. This is an optional setting.
versioning: Managing bucket versioning:
- enabled: Enables bucket versioning. This is an optional setting.

For more information about the yandex_storage_bucket properties in Terraform, see this provider guide.

Apply the changes:
1. In the terminal, navigate to the configuration file directory.
2. Make sure the configuration is correct using this command:
```
terraform validate
```
  If the configuration is valid, you will get this message:
```
Success! The configuration is valid.
```
3. Run this command:
```
terraform plan
```
  You will see a list of resources and their properties. No changes will be made at this step. Terraform will show any errors in the configuration.
4. Apply the configuration changes:
```
terraform apply
```
5. Type yes and press Enter to confirm the changes.
You can check the update using the management console.

To manage bucket versioning, use the update REST API method for the Bucket resource, the BucketService/Update gRPC API call, or the putBucketVersioning S3 API method.

Managing bucket versioning

Was the article helpful?