Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nebius.com/llms.txt

Use this file to discover all available pages before exploring further.

In Object Storage, you work with files and folders called objects and place them in containers called buckets. This guide will help you manage objects in buckets.

​
Prerequisites

Make sure you are in a group that has at least the editor role within your tenant; for example, the default editors group. You can check this in the Administration → IAM section of the web console.

​
Object naming requirements

Each Object Storage object has a key — object ID in a string format. This key can contain prefixes — they act similar to directories, organizing objects into groups. To avoid issues with your objects, follow these requirements:
  • Object keys can be up to 1024 bytes long, case sensitive.
  • Use UTF-8 alphanumeric characters, slashes (/) and certain special characters.
For more information on character usage and which characters to avoid, see the AWS object naming guidelines.

​
How to view objects

  1. In the sidebar, go to https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/storage.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=0a2dad6b48aea10e85f6f3e2343aee26 Storage → Object Storage.
  2. Select the bucket to view the objects in. The page shows a table with the following columns: Key, Size, Storage class and Last modified.
  3. To see the contents of a folder, click the folder name in the Key column.

​
How to verify object integrity

The web console does not show checksum metadata. Use the AWS CLI to upload objects with a checksum and to retrieve the checksum of stored objects.
Object Storage supports end-to-end integrity checks for the objects you upload. When you upload an object, you can provide its checksum along with the upload request. Object Storage then calculates the checksum of the stored object and compares it with the one you provided. If the checksums match, both the object and its checksum are stored, and the checksum can be retrieved later through HeadObject or GetObject requests. If the checksums don’t match, the upload fails with an error. Both simple and multipart uploads support integrity checks. If no checksum is sent with the upload, Object Storage still calculates and stores one for the object, but this checksum is not validated during the upload. The AWS CLI v2 automatically calculates and sends a checksum on every upload, using CRC64NVME by default, and verifies the checksum on every download. You only need to specify --checksum-algorithm if you want to use a different algorithm.

​
Supported checksum algorithms

  • CRC64NVME (default)
  • CRC32
  • CRC32C
  • SHA1
  • SHA256

​
Uploading an object with a checksum

To use a specific checksum algorithm, set the --checksum-algorithm parameter: 
aws s3 cp <local_file_path> s3://<bucket_name>/<object_key> --checksum-algorithm SHA256
Object Storage recalculates the checksum on receipt. If it doesn’t match the one sent by the AWS CLI, the upload fails.

​
Retrieving the checksum of an object

To retrieve the stored checksum of an existing object, use the head-object command with the --checksum-mode parameter set to ENABLED: 
aws s3api head-object \
    --bucket <bucket_name> \
    --key <object_key> \
    --checksum-mode ENABLED
The output includes a checksum field, where the field name indicates the checksum algorithm and the value is a Base64-encoded checksum. For example: 
{
    "ChecksumSHA256": "<base64_encoded_checksum>"
}

​
How to rename an object

Renaming objects is not supported in the web console.
You can rename an object in your Object Storage bucket using the following manual sequence:
  1. Copy the object in question with a new name. You can also update an object’s prefix: 
    aws s3 cp \
    s3://<bucket_name>/[<prefix_for_old_object_key>] \ # prefix and name of the object to rename
    s3://<bucket_name>/[<prefix_for_new_object_key>]   # desired prefix and name of the object
  2. Remove the old copy of the renamed object: 
    aws s3 rm s3://<bucket_name>/[<prefix_for_old_object_key>]

​
How to delete objects

​
Deleting a single object

  1. In the sidebar, go to https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/storage.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=0a2dad6b48aea10e85f6f3e2343aee26 Storage → Object Storage.
  2. Select the bucket that contains the object.
  3. Next to the object, click https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad → Delete.
  4. In the Delete object window, type the object name in the confirmation field and click Delete object.

​
Deleting multiple objects

  1. In the sidebar, go to https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/storage.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=0a2dad6b48aea10e85f6f3e2343aee26 Storage → Object Storage.
  2. Select the bucket that contains the objects.
  3. In the Select column, select the checkbox next to each object to delete. To select all the objects in the bucket, use the checkbox in the column header.
  4. In the banner that appears at the bottom of the page, click https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/trash-bin.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=b9b80db3d011e608480c36552df703a0 Delete.
  5. In the Delete objects window, type the bucket name in the confirmation field and click Delete objects.
When an object is deleted from a bucket in Object Storage, it becomes immediately inaccessible and cannot be restored. The actual object data is then physically deleted from Nebius AI Cloud servers within 4 days.

​
See also