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 upload files to buckets and download them.

​
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 upload

​
Uploading a single file

  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 where you want to upload a file.
  3. Upload a file:
    1. Click https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/plus.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=7c9efc69d65fc58db0eb73702fd81aa1 Add → Object.
    2. In the window that opens, select the file to upload.
    3. Click Upload.
  4. Check that the Objects tab shows the new object.

​
Uploading a folder

You can use the web console to create a folder in a bucket and upload files to it. With the AWS CLI, you can upload an entire local folder including its contents.
To create a folder:
  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 where you want to create the folder.
  3. Click https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/plus.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=7c9efc69d65fc58db0eb73702fd81aa1 Add → Folder.
  4. In the Create folder window, enter a name and click Create.
After you create the folder, you can add files to it.

​
How to download

You can download a single object from an Object Storage bucket with the web console or AWS CLI. The AWS CLI also lets you download all objects with a specified prefix.
  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. In the row of the object to download, click https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad → Download.

​
Example with the AWS CLI

Assume that you already have an Object Storage bucket named quickstart-bucket. The example below shows how to upload objects to your bucket and download them using the AWS CLI.
  1. Create a local folder from which you’ll upload files to your bucket: 
    mkdir lorem-ipsum
  2. Create the files to upload. Run the commands from the code block below: 
    echo 'Lorem ipsum odor amet, consectetuer adipiscing elit. Posuere ullamcorper hendrerit faucibus pellentesque sociosqu montes. Tempus ut sit rutrum etiam sodales, porttitor congue condimentum nulla. Facilisis sodales habitant mi justo duis. Hendrerit praesent sit facilisi congue felis primis lobortis mattis nibh. Augue netus laoreet magna class enim fringilla molestie ipsum. Quisque natoque ligula lobortis accumsan potenti? Convallis pellentesque magna enim suscipit risus mauris molestie parturient quam.' > lorem-ipsum/lorem.txt
echo 'Euismod porta phasellus bibendum urna dolor tincidunt dapibus eu maecenas. Aliquet eget gravida; tempus curae potenti class. Lectus nibh nam donec sagittis donec felis posuere libero. Suspendisse accumsan suscipit blandit orci platea iaculis ac. Suspendisse egestas aptent aliquam sapien ut maximus. Litora ridiculus augue mi, ut aliquam amet. Fusce dignissim nulla venenatis dis himenaeos habitasse. Blandit primis massa eros gravida rhoncus nascetur nulla' > lorem-ipsum/euismod.txt
echo 'Litora integer iaculis libero dui pretium porta scelerisque. Dis laoreet ipsum porta viverra ipsum sem feugiat. Arcu ex natoque commodo faucibus facilisis vivamus sagittis; ultricies quis. Senectus vivamus nec cras porttitor penatibus. Ipsum vitae integer elementum; sem gravida etiam. Vivamus purus nunc nunc et aenean class. Tempor sagittis sociosqu erat class laoreet iaculis nec. Tempus ligula pellentesque a molestie fames elit vivamus.' > lorem-ipsum/litora.txt
    This creates three text files in your new lorem-ipsum/ folder:
    • lorem.txt
    • euismod.txt
    • litora.txt
  3. Upload all the files from your lorem-ipsum/ folder to your Object Storage bucket with the lorem-ipsum prefix: 
    aws s3 cp lorem-ipsum/ s3://quickstart-bucket/lorem-ipsum/ --recursive

    upload: lorem-ipsum/lorem.txt to s3://quickstart-bucket/lorem-ipsum/lorem.txt
upload: lorem-ipsum/litora.txt to s3://quickstart-bucket/lorem-ipsum/litora.txt
upload: lorem-ipsum/euismod.txt to s3://quickstart-bucket/lorem-ipsum/euismod.txt
  4. List the objects with the lorem-ipsum prefix in your bucket: 
    aws s3 ls s3://quickstart-bucket/lorem-ipsum --recursive --human-readable --summarize

    YYYY-MM-DD HH:MM:SS  458 Bytes lorem-ipsum/euismod.txt
YYYY-MM-DD HH:MM:SS  442 Bytes lorem-ipsum/litora.txt
YYYY-MM-DD HH:MM:SS  505 Bytes lorem-ipsum/lorem.txt

Total Objects: 3
    Total Size: 1.4 KiB
  5. Download the lorem.txt file from your bucket to the local lorem-ipsum/ folder as lorem-download.txt: 
    aws s3 cp s3://quickstart-bucket/lorem-ipsum/lorem.txt lorem-ipsum/lorem-download.txt

    download: s3://quickstart-bucket/lorem-ipsum/lorem.txt to lorem-ipsum/lorem-download.txt
  6. Check if the downloaded file is there: 
    ls lorem-ipsum/

    euismod.txt        litora.txt         lorem-download.txt lorem.txt
  7. Delete all the files with the lorem-ipsum prefix from your Object Storage bucket: 
    aws s3 rm s3://quickstart-bucket/lorem-ipsum --recursive

    delete: s3://quickstart-bucket/lorem-ipsum/litora.txt
delete: s3://quickstart-bucket/lorem-ipsum/euismod.txt
delete: s3://quickstart-bucket/lorem-ipsum/lorem.txt
  8. Remove the lorem-ipsum/ folder from your computer: 
    rm -r lorem-ipsum/