Jump toUpdate content

Quickstart

Reviewed on 26 May 2021Published on 26 May 2021

Scaleway Object Storage is an object storage service based on the S3 protocol. It allows you to store any kind of objects (documents, images, videos, etc.) and access them any time, from anywhere in the world. You can manage your storage directly from the Scaleway Console. When on the control panel, you can easily upload, download and visualize the objects in your buckets. In addition, many existing libraries or CLI clients can be integrated into your application or scripts.

Requirements:

How to create a 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 Object Storage on the left side menu of the console. The Object Storage dashboard displays.

  2. Click + Create a bucket. The bucket creation page displays.

  3. Enter a name for your bucket. 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 in relation to the whole platform
    • 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 Object Storage in the Storage section of the side menu. A list of your buckets displays.

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

  3. Click 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.

  4. 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.

  5. 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.

    Note:
    • 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.

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

How to download files from a bucket

  1. Click 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 Icon» icon appears.

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

Alternatively, you can click the «See more Icon» icon for your selected object and click Download.

How to delete a bucket

When you delete a bucket, every object stored inside it is deleted with it.

  1. Click Object Storage in the Storage section of the side menu. The list of your buckets displays.

  2. Click the name of your selected bucket in the buckets list.

  3. Click the Bucket Settings tab.

  4. Scroll to the end of the page and click Delete bucket.

    A pop-up appears warning that:

    Important:

    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.

  5. 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 the «See more Icon» icon and then Delete in your 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.