Getting Started with Scaleway Object Storage

Object Storage Overview

Scaleway Object Storage is an Object Storage service based on Simple Storage Solution (S3), a protocol created by Amazon for its own object storage service, and the most used in the world.

Object Storage allows you to host files regardless of their number, size or organization and to distribute them instantly, anywhere in the world. The massively scalable nature of the service, as well as its pay-per-use billing model and the fact that is easily accessible via http requests, makes it ideal to be used with Content Delivery Networks (CDN), to store logs and backups and for file distribution.

You can manage Object Storage directly from the Scaleway Console.

In this tutorial you will learn how to:

Requirements:

How to create your first bucket

To get started with Object Storage, you must first create a bucket. Objects are gathered into buckets. Each bucket represents a space where objects are stored.

1 . Click on Object Storage on the left side menu of the console.

The Object Storage dashboard displays.

2 . Click on + Create a bucket.

The bucket creation page displays.

3 . Enter a name for your bucket in the box, as instructed.

The bucket name is used as a unique identifier which allows us to provide features such as the bucket location and geo-replication.

Note: the bucket name must:

  • be unique

  • contain only alphanumeric and lowercase characters

Learn more about bucket name limitations on our dedicated FAQ page.

4 . Select the geographical location in which your bucket will be created.

Scaleway Object Storage is currently available in three Availability Zones (AZ/Region).

  • Amsterdam, The Netherlands:
    • Region: nl-ams
  • Paris, France:
    • Region: fr-par
  • Warsaw, Poland:
    • Region: pl-waw

5 . Check Public or Private to define the bucket visibility.

The bucket visibility specifies whether everyone can see the list of objects in the bucket or not. It does not affect object visibility. You can change the visibility settings at a later time in the Object Storage dashboard.

Note:

  • A file uploaded to a public bucket is private by default.

  • A private file in a public bucket cannot be accessed publicly.

  • You can change the visibility settings at any time from the Object Storage bucket dashboard.

6 . Verify that all information about your bucket is correct in the Summary before clicking Create a bucket to confirm.

A list of your buckets displays, showing the newly created bucket.

You can find more information about your bucket by clicking on its name in the buckets list and then on the Bucket Settings tab.

How to upload files into a bucket

1 . Click on the bucket name into which you want to upload your file.

2 . Click on the grey area to select the files you want to upload into the bucket. Alternatively you can also drag and drop your files into the grey area.

3 . Select the files to upload from the file browser tool of your operating system.

Important: Before uploading your files, make sure the file name is in accordance with the AWS s3 Object key naming guidelines.

4 . Select the Storage Class of your object.

Scaleway Object Storage allows you to associate storage classes with each of your objects. You can choose the storage class depending on your use-case:

  • STANDARD: The Standard class for any upload; suitable for on-demand content like streaming or CDN.
  • GLACIER: Archived storage; prices are lower, but it needs to be restored first to be accessed.

Notes:

  • Pricing depends on the storage class you have selected.

  • It is possible to change storage classes at any time from the Object Storage bucket dashboard. Learn more about the specificities of GLACIER class in the C14 Cold Storage documentation page.

A list of the bucket’s objects displays including the newly uploaded objects.

How to download files from a bucket

1 . Click on the name of your selected bucket in the buckets list.

A list of your objects displays.

2 . Run your cursor over the name of the object you wish to download.

The download button appears.

3 . Click on it to begin the download of the object into your local file system.

Alternatively, you can click on the button for your selected object and click on Download.

How to manage object visibility

1 . Click on the name of your selected bucket in the buckets list.

A list of your objects displays.

2 . Click on the button next to the selected object name.

3 . Click on Visibility.

A pop-up appears.

4 . Check Public or Private according to your preference.

5 . Click on Update Object visibility to confirm.

How to access objects via web browser

If you have set your bucket or specific objects’ visibility to Public, it is possible to access objects via a public https link.

1 . Click on the name of your selected bucket in the buckets list.

A list of your objects displays.

2 . Click on the button next to the selected object name.

3 . Then, click on Get public link.

A pop up appears.

4 . Define an expiration date and time and fill in the boxes accordingly.

5 . Click on Generate link to confirm.

Your temporary public link displays.

6 . Click on Copy URL to copy the link.

You can share the link with other collaborators until the expiration date is reached.

How to enable Bucket versioning

Once enabled, the versioning feature supports the retrieval of objects that are deleted or overwritten. It is a way to keep multiple variants of an object in the same bucket.

If the feature is enabled, you can list archived versions of an object or permanently delete an archived version. Once versioning is enabled, you cannot return to an un-versioned state of your bucket.

Important: If you enable versioning, you will have several object versions. Keep in mind that each version of an object stored in your bucket takes disk space and is billed at 0.01€/GB per month.

To enable versioning:

1 . Click on the name of your selected bucket in the buckets list.

2 . Click on the Bucket Settings tab.

3 . Scroll down the page and click on Enable versioning under Bucket Versioning.

A pop-up appears to disclaim the following message:

“Be careful ! Enabling bucket versioning allows you to store several objects on a single key (every versioned object is billed). The activation is currently permanent and you will not be able to cancel it”.

4 . Click on Enable versioning on this bucket if you agree and wish to proceed.

After confirmation, it is not possible to revert the action.

How to change Object Classes

You can move existing objects from STANDARD storage class to GLACIER directly using the Scaleway console.

1 . Log in to the Scaleway console.

2 . Click on Object Storage in the storage section of the side menu. The list of your object storage buckets displays.

3 . Click on the bucket name that contains the objects you want to transfer to GLACIER.

4 . The list of objects stored in the bucket displays. Click on the Snowflake icon next to the object that you want to transfer:

5 . Confirm the transfer of the object to the Glacier storage class by clicking on Send to S3 Glacier:

Your Object is now being transferred to the GLACIER storage class.

Alternatively, you can restore existing objects from GLACIER storage class to STANDARD directly using the Scaleway console.

1 . Log in to the Scaleway console.

2 . Click on Object Storage in the storage section of the side menu. The list of your object storage buckets displays.

3 . Click on the bucket name that contains the objects you want to restore in STANDARD storage class.

4 . The list of objects stored in the bucket displays. Click on the Restore icon next to the object that you want to restore:

5 . Choose the number of days you want to make the object available again in the STANDARD storage class and confirm by clicking Restore object from S3 Glacier:

Your object is now being restored. Depending on the size, the restoration process may take up to 6 hours. Your object will remain available in STANDARD storage class for the duration you have choosen during the restore process. It will be transferred automatically back to GLACIER once the configured period is over.

How to delete a bucket

Important: When you delete a bucket, every object stored inside it is deleted with it. The name of the bucket also becomes available to be used by other users.

1 . Click on the name of your selected bucket in the buckets list.

2 . Click on the Bucket Settings tab.

3 . Scroll to the end of the page and click on Delete bucket.

A pop-up appears warning that:

“Every object stored inside this bucket will be lost, and another customer will be allowed to reuse the name of this bucket. The deletion of your bucket will be triggered today at 11.59pm UTC.”

4 . If you understand and agree to the conditions, type DELETE in the box and click Delete this bucket

Alternatively, you can delete a bucket just by clicking on Delete in the dropdown menu next to the selected bucket name in the Bucket list.

Once the bucket is successfully deleted, it disappears from your bucket list.

Note: For operational reasons you have to wait 24h before creating a bucket with the same name as the one you have just deleted.

Take the next steps

Click on the tutorials to learn how to:

  • Use Object Storage with the API

  • Use Object Storage with AWS-CLI - The AWS-CLI is an open-source tool that provides commands for interacting with AWS services. With minimal configuration, you can start using all of the functionalities provided by the AWS Management with Object Storage.

  • Use Object Storage with s3cmd - S3cmd is a client for S3 Object Storage that allows you to create, list and delete buckets, download, upload, and delete objects inside the Object Storage.

  • Migrate your data with Object Storage and Rclone - Rclone provides a modern alternative to rSync. It communicates with any S3 compatible cloud storage provider as well as other storage plateforms, and can be used to migrate data from one region to another.

  • Deploy Nextcloud with Object Storage - Nextcloud is an open-source, self-hosted file share and communication platform. It allows you to manage and organize files by uploading and downloading them into a storage space of your choice manageable via web browser or phone and desktop applications. Combine Nextcloud with Object Storage to benefit from infinite storage space.

Discover the Cloud That Makes Sense