Skip to main content
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 or project; 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 Storage → Object Storage.
  2. Select the bucket where you want to upload a file.
  3. Upload a file:
    1. Click 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 Storage → Object Storage.
  2. Select the bucket where you want to create the folder.
  3. Click 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 Storage → Object Storage.
  2. Select the bucket that contains the object.
  3. In the row of the object to download, click → 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:
  2. Create the files to upload. Run the commands from the code block below:
    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:
  4. List the objects with the lorem-ipsum prefix in your bucket:
  5. Download the lorem.txt file from your bucket to the local lorem-ipsum/ folder as lorem-download.txt:
  6. Check if the downloaded file is there:
  7. Delete all the files with the lorem-ipsum prefix from your Object Storage bucket:
  8. Remove the lorem-ipsum/ folder from your computer: