As an alternative or complement to this documentation page, check out our video: What is Object Storage? Quickstart guide with use cases.
Object Storage - Quickstart
Scaleway Object Storage is an Object Storage service based on the S3 protocol. It allows you to store any objects (documents, images, videos, etc.) and access them anytime from anywhere in the world. You can manage your storage directly from the Scaleway console. On the control panel, you can easily upload, download, and visualize the objects in your buckets. In addition, you can integrate many existing libraries or CLI clients into your application or scripts.
Before you start
To complete the actions presented below, you must have:
- A Scaleway account logged into the console
- Owner status or IAM permissions allowing you to perform actions in the intended Organization
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.
- Click Object Storage on the left side menu of the console. The Object Storage dashboard displays.
- Click + Create bucket. The bucket creation page displays.
- Select the geographical location in which to create your bucket. Scaleway Object Storage is currently available in three Regions.
- Amsterdam, The Netherlands:
- Region:
nl-ams
- Region:
- Paris, France:
- Region:
fr-par
- Region:
- Warsaw, Poland:
- Region:
pl-waw
- Region:
- Amsterdam, The Netherlands:
- Check Public or Private to define the bucket visibility. The bucket visibility specifies whether everyone can see the list of objects in the bucket. It does not affect object visibility.
Note
A file uploaded to a public bucket is private by default. A private file stored in a public bucket is not publicly accessible. You can change the bucket visibility at any time from the Bucket settings tab.
- Select a use case for your bucket.
- Enter a name for your bucket.
- Optionally, you can use the cost estimator to simulate your Object Storage costs.
- Click Create 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
-
Click Object Storage in the Storage section of the side menu. A list of your buckets displays.
-
Click the bucket name into which you want to upload your file.
-
Click the gray area to select the files you want to upload into the bucket. Alternatively, you can also drag and drop your files into the uploading area.
-
Select the files to upload from the file browser tool of your operating system.
ImportantBefore uploading your files, make sure the file name follows the AWS S3 Object key naming guidelines.
-
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 is Multi-AZ, and is available in all regions. It is suitable for any use case, such as on-demand content, like streaming or CDN. - One Zone - IA: The
One Zone - IA
class is available in all regions, and is a good choice for storing secondary backup copies or easily re-creatable data. - Glacier: Archived storage. Your data needs to be restored first to be accessed. This class is available in the
fr-par
andnl-ams
regions.
Note- Pricing depends on the storage class you have selected.
- It is possible to edit the storage classes at any time from the Object Storage bucket dashboard.
- Standard: The
A list of the bucket’s objects displays including the newly uploaded objects.
How to download files from a bucket
-
Click the name of your selected bucket in the buckets list. A list of your objects displays.
-
Run your cursor over the name of the object you wish to download. The «Download Icon» icon appears.
-
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.
-
Click Object Storage in the Storage section of the side menu. The list of your buckets displays.
-
Click the name of your selected bucket in the buckets list.
-
Click the Bucket settings tab.
-
Scroll to the end of the page and click Delete bucket.
A pop-up appears warning that:
ImportantEvery 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.59 pm UTC.
-
If you understand and agree to the conditions, type DELETE in the box and click Delete bucket.
Alternatively, you can delete a bucket by clicking the «See more Icon» icon and then Delete in your bucket list.
Once the bucket is deleted, it disappears from your bucket list.
For operational reasons, you have to wait 24 hours before creating a bucket with the same name as the one you have just deleted.