How to manage Object Storage buckets

In Object Storage, files are stored in containers called buckets. You can create, modify, delete or restore them.

Prerequisites

Below are prerequisites for the AWS CLI and Nebius AI Cloud CLI. Other interfaces do not have any prerequisites.

To manage buckets, install and configure at least one of the command line interfaces (CLIs) supported by Nebius AI Cloud:

AWS CLI offers simple commands for bucket management, such as aws s3 mb to create buckets and aws s3 rb to delete them. For more advanced management, use aws s3api commands.
Nebius AI Cloud CLI supports all Object Storage features, as well as other Nebius AI Cloud resources, such as virtual machines and Managed Service for Kubernetes® clusters.

For the commands in this guide to work, configure the CLIs to work with Nebius AI Cloud. For example, in Nebius AI Cloud CLI commands (nebius), the ID of the parent project (--parent-id) is not included because it is expected to be set in the CLI profile:

nebius config set parent-id <project_ID>

You can also provide the project ID explicitly to creation commands, for example, nebius storage bucket create --parent-id <project_ID> ... For more information on installation and configuration, see the following guides:

How to create buckets

Web console
Nebius AI Cloud CLI
AWS CLI

In the sidebar, go to Storage → Object Storage.
Click Create bucket.
(Optional) Specify the bucket name. The bucket name must be unique across the region. For more information, see Naming.
Set the bucket parameters.
Click Create bucket.

To create a bucket, run the following command:

nebius storage bucket create --name <bucket_name>

You can extend this command with more parameters, see Bucket parameters and Examples.The bucket name must be unique across the region. For more information, see Naming.

aws s3 mb s3://<bucket_name>

The mb in the command stands for “make bucket.”The bucket name must be unique across the region. For more information, see Naming.

How to modify buckets

Web console
Nebius AI Cloud CLI

In the sidebar, go to Storage → Object Storage.
Open the page of the required bucket.
Go to the Settings tab.
Modify the bucket parameters.
Click Save changes.

To modify a bucket and change its parameters, run the following command:

nebius storage bucket update --id $NB_BUCKET_ID --max-size-bytes 268435456000

The bucket is patched by default. Only the parameters specified in the CLI command are changed. To perform a full update, add --full to the command. This will update all parameters with the values specified in the command or the default values.

Bucket parameters

When creating or modifying a bucket, you can set the following parameters for it:

Web console
Nebius AI Cloud CLI

Bucket size: Specify the bucket’s maximum size or select Unlimited to have an unlimited capacity.
Storage class: Select Standard for low-cost unlimited capacity or Enhanced Throughput for storage that requires high bandwidth and low latency access. For more information, see Storage classes in Object Storage.
Force storage class: Overrides the storage class specified explicitly when you upload an object to this bucket.
Versioning: Allows you to track and record all object changes.
Data plane Audit Logs: Configures data plane logging for the bucket, in addition to always-on control plane logging. To manage this setting, you need the admin role for the bucket, its parent project or tenant.

--versioning-policy enabled: Allows versioning of objects in the bucket. For more details, see Managing versioning of Object Storage objects.
--max-size-bytes 107374182400: Limits the total size of objects in the bucket.
--default-storage-class: Sets the default storage class for the objects uploaded to the bucket.
--force-storage-class: Makes the default storage class override storage classes that you specify explicitly when uploading objects to the bucket.
--lifecycle-configuration-rules '[{...}, {...}]': Adds object lifecycle rules to the bucket. For more information, see an example below and Lifecycle rules for objects in Object Storage.
--object-audit-logging <all|mutate_only|none>: Configures data plane logging for the bucket, in addition to always-on control plane logging. To manage this setting, you need the admin role for the bucket, its parent project or tenant.

After you enable versioning for an existing bucket for the first time, it may take up to 15 minutes to come into effect. We recommend waiting 15 minutes before performing any write operations (PUT or DELETE) to avoid issues with object visibility and version tracking. If you enable or suspend versioning when creating a bucket, it is available immediately with no waiting period.

How to delete buckets

Delete an empty bucket

Web console
Nebius AI Cloud CLI
AWS CLI

In the sidebar, go to Storage → Object Storage.
Find the bucket and then click → Delete.
Confirm the bucket deletion.

To delete an empty bucket, run the following command:

export NB_BUCKET_ID=$(nebius storage bucket get-by-name \
  --name <bucket_name> --format jsonpath='{.metadata.id}')
nebius storage bucket delete --id $NB_BUCKET_ID

The command uses jq to extract the bucket ID from the JSON output and pass it along.

If the bucket has versioning enabled, it may appear empty but still contain old versions of some objects. Make sure that you delete all versions of all objects in the bucket before you run this command. For more details, see Managing objects in Object Storage buckets.

To delete an empty bucket, run the following command:

aws s3 rb s3://bucket-name

The rb in the command stands for “remove bucket.”

Delete a non-empty bucket after a delay

In the web console, you can delete a non-empty bucket immediately or after a delay. If you use other interfaces, you can delete a non-empty bucket only after a delay.

Web console
Nebius AI Cloud CLI

In the sidebar, go to Storage → Object Storage.
Locate the bucket and then click → Delete.
In the window that opens, select whether you want to delete the bucket now or later:
- If you delete the bucket now, you cannot restore its objects after that.
- If you want to delete the bucket later, this allows you to restore the bucket before the time elapses. When it elapses, the service deletes the bucket.
For the Delete later option, specify for how long Object Storage should postpone the bucket deletion.
Confirm the deletion.

If you selected the Delete later option, the bucket status changes to To be deleted. When the bucket is in this status, you cannot use or update it. The bucket is not visible in the AWS CLI.

Nebius AI Cloud still charges you for the bucket in the To be deleted status.

Get the bucket ID:

export NB_BUCKET_ID=$(nebius storage bucket get-by-name \
  --name <bucket_name> --format jsonpath='{.metadata.id}')

The command uses jq to extract the bucket ID from the JSON output and pass it to the next commands.

Run one of the following commands:
```
nebius storage bucket delete --id $NB_BUCKET_ID --ttl <delay_time>
```
```
nebius storage bucket delete --id $NB_BUCKET_ID --purge-at <timestamp>
```
- --purge-at specifies the timestamp when the bucket and all objects in it are deleted. For example: '2025-01-01T18:33:31.827636Z'.
- --ttl specifies the delay after which the bucket and all objects in it are deleted. For example: 1h20m30s. Specify 0s to delete the bucket immediately.

The bucket is put into the SCHEDULED_FOR_DELETION status, and after the specified time passes, it is deleted. When the bucket is in this status, you cannot use or update it, but you can restore it. The bucket is not visible in the AWS CLI.

Nebius AI Cloud still charges you for the bucket in the SCHEDULED_FOR_DELETION status.

Immediately delete a bucket scheduled for deletion

If you scheduled a bucket for deletion and you want to skip this schedule and delete the bucket immediately, do the following:

Web console
Nebius AI Cloud CLI

In the web console, go to Storage → Object Storage.
Locate the bucket and then click → Delete now.
Confirm the bucket deletion.

Run the following command:

nebius storage bucket purge --id $NB_BUCKET_ID

How to restore buckets

If you scheduled a bucket for deletion and you want to restore it, do the following:

Web console
Nebius AI Cloud CLI

In the sidebar, go to Storage → Object Storage.
Locate the bucket and then click Restore.
Confirm the bucket restoration.

Run the following command:

nebius storage bucket undelete --id $NB_BUCKET_ID

Examples

Nebius AI Cloud CLI

Creating a bucket with total objects size limited to 250 GiB (268,435,456,000 bytes):

nebius storage bucket create --name <bucket_name> \
  --max-size-bytes 268435456000

Creating a bucket with an object lifecycle rule that deletes objects 90 days after their creation:

nebius storage bucket create --name <bucket_name> \
  --lifecycle-configuration-rules '[{
    "id": "lifecycle-delete-90-days-objects",
    "status": "ENABLED",
    "filter": {
      "prefix": ""
    },
    "expiration": {
      "days": 90
    }
  }]'

Creating a bucket with a forced Standard default storage class that overrides the storage class that you select explicitly for any individual object uploaded to the bucket:
```
nebius storage bucket create --name <bucket_name> \
  --default-storage-class standard \
  --force-storage-class
```

Object Storage

Managed Service for PostgreSQL®

Container Registry

How to manage Object Storage buckets

Prerequisites

How to create buckets

How to modify buckets

Bucket parameters

How to delete buckets

Delete an empty bucket

Delete a non-empty bucket after a delay

Immediately delete a bucket scheduled for deletion

How to restore buckets

Examples

Object Storage

Managed Service for PostgreSQL®

Container Registry

​Prerequisites

​How to create buckets

​How to modify buckets

​Bucket parameters

​How to delete buckets

​Delete an empty bucket

​Delete a non-empty bucket after a delay

​Immediately delete a bucket scheduled for deletion

​How to restore buckets

​Examples

Prerequisites

How to create buckets

How to modify buckets

Bucket parameters

How to delete buckets

Delete an empty bucket

Delete a non-empty bucket after a delay

Immediately delete a bucket scheduled for deletion

How to restore buckets

Examples