Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion pages/object-storage/api-cli/bucket-operations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ Authorization: authorization string

**CLI command**
```
aws s3api delete-bucket --bucket my-bucket --region nl-ams-1
aws s3api delete-bucket --bucket my-bucket --region nl-ams
```

## DeleteBucketCors
Expand Down
2 changes: 1 addition & 1 deletion pages/object-storage/api-cli/object-lock.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The feature uses a write-once-read-many (WORM) data protection model. This model
Setting object lock can only be achieved upon the creation of a bucket. In addition, versioning is automatically enabled on the bucket and cannot be disabled. You must enable object lock if you wish to write a lock configuration. You can use the `PutObjectLockConfiguration` request with the object lock flag set.

<Message type="note">
Object Lock can be used with `Standard Multi-AZ`, `Standard One Zone` (`fr-par`) and `Glacier` [storage classes](/object-storage/concepts/#storage-class).
Object Lock can be used with `Standard Multi-AZ`, `Standard One Zone` and `Glacier` [storage classes](/object-storage/concepts/#storage-class).
</Message>

<Requirements />
Expand Down
4 changes: 2 additions & 2 deletions pages/object-storage/api-cli/object-storage-aws-cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ The AWS-CLI is an open-source tool built on top of the [AWS SDK for Python (Boto
3. When prompted, enter the following elements:
- your API access key
- your API secret key
- your preferred default Object Storage region (`fr-par`, `nl-ams`, or `pl-waw`)
- your preferred default Object Storage region (`fr-par`, `nl-ams`, `pl-waw`, `it-mil`)
- `json` as the default output format

4. Open the `~/.aws/config` file in a code editor and edit it as follows:
Expand Down Expand Up @@ -62,7 +62,7 @@ The AWS-CLI is an open-source tool built on top of the [AWS SDK for Python (Boto
```

<Message type="note">
Set the `endpoint_url` and `region` corresponding to the geographical region of your bucket. It can either be `fr-par` (Paris, France), `nl-ams` (Amsterdam, The Netherlands) or `pl-waw` (Warsaw, Poland).
Set the `endpoint_url` and `region` corresponding to the geographical region of your bucket (`fr-par`, `nl-ams`, `pl-waw`, `it-mil`).
</Message>

5. Optionally, you can also configure additional profiles by adding new blocks under `[default]`. For example, you can add a second profile, `[profile two]`, to set a different region and services from your default one:
Expand Down
7 changes: 6 additions & 1 deletion pages/object-storage/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,9 @@ An endpoint represents one end of a communication channel. In the context of Obj
- Warsaw, Poland
- Region: `pl-waw`
- Endpoint: `https://s3.pl-waw.scw.cloud/`
- Milan, Italy
- Region: `it-mil`
- Endpoint: `https://s3.it-mil.scw.cloud/`

## Legal hold

Expand Down Expand Up @@ -175,8 +178,10 @@ Refer to the [dedicated documentation](/object-storage/api-cli/generate-aws4-aut

You can choose a storage class depending on your use case:

- **Standard Multi-AZ**: suitable for on-demand content like streaming or CDN. The [Standard Multi-AZ](/object-storage/faq/#what-are-the-object-storage-classes-offered-by-scaleway) is available in [all regions](#region-and-availability-zone).
- **Standard Multi-AZ**: suitable for on-demand content like streaming or CDN. The [Standard Multi-AZ](/object-storage/faq/#what-are-the-object-storage-classes-offered-by-scaleway) is available in the Paris, Amsterdam and Warsaw [regions](#region-and-availability-zone).

- **Standard One Zone**: the Standard One Zone class is a good choice for storing secondary backup copies or easily re-creatable data. It is available in [all regions](#region-and-availability-zone).

- **Glacier**: Archived storage - prices are lower, but it needs to be restored first to be accessed. It is available in the `fr-par` and `nl-ams` regions.

<Message type="note">
Expand Down
133 changes: 130 additions & 3 deletions pages/object-storage/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,15 +20,142 @@ Scaleway provides an integrated UI in the [console](https://console.scaleway.com

We provide an Amazon S3-compatible API for programmatic access or usage with any compatible software. Therefore, we recommend using dedicated tools such as `s3cmd` to manage large data sets.

## Offering and availability
## How am I billed for Object Storage?

| Type of consumption | Price |
|:-----------------------:|:--------------------------------------:|
| Standard Multi-AZ | €0.00002/GB/hour ~€0.0146/GB/month |
| Standard One Zone | €0,0000103/GB/hour ~€0.0075/GB/month |
| Requests | Included |
| Ingress | Included |
| Bucket websites feature | Free |
| Egress fees* | 75 GB free every month, then €0.01/GB |

\* Egress fees include external outgoing data transfer and inter-region data transfers (such as Paris\<->Amsterdam, or Amsterdam \<-> Warsaw). Intra-regional data transfers are free of charge.

Refer to our [Cold Storage FAQ](/object-storage/faq/#cold-storage) for more information on Scaleway Glacier billing.

<Message type="note">
Chia farming on Scaleway Object Storage that occurs without prior authorization will be billed at €0.08 per GB. [Read our blog post to learn more](https://www.scaleway.com/en/blog/scaleway-and-chia/).
</Message>

## How can I benefit from the Object Storage free trial?

As a new user, you benefit from a total 750 GB of free storage across the [Standard Multi-AZ and Standard One Zone classes](/object-storage/concepts/#storage-class) for buckets in your Organization, across all [regions](/object-storage/concepts/#region-and-availability-zone), for 90 days.

750 GB is the total amount of free storage, and can be split as desired between the Standard Multi-AZ and Standard One Zone classes. For Instance, you can store 300 GB using the Standard Multi-AZ class, and 450 GB using the Standard One Zone class.

If you exceed 750 GB of combined Standard Multi-AZ and Standard One Zone storage during the free trial period, you will only be billed for the excess data.

You can activate your free trial period from the Object Storage section of the [Scaleway console](https://console.scaleway.com). Once it is activated, **you cannot deactivate it** to resume it at a later time.

At the end of the 90-day trial period, you will be billed for regular Object Storage pricing.

<Message type="important">
To be eligible for this offer, you must have never used the Standard Multi-AZ class before November, 30th 2023, 23:59:59.
</Message>

## How can I monitor my Object Storage consumption?

You can monitor your Object Storage metrics and logs using [Scaleway Cockpit](/cockpit/quickstart/). Cockpit is available in all [regions](/object-storage/concepts/#region-and-availability-zone) for Object Storage. Refer to our dedicated [documentation](/object-storage/how-to/monitor-consumption/) for more information.

## Is there a limitation in the bucket name?

Bucket names must be unique and comply with the following:

- Must not contain uppercase characters or underscores.
- Must not be formatted as an IP address.
- Can contain lowercase letters, numbers, and hyphens.
- Can contain a set of the 63 alphabetic characters, a to z, and the 10 Arabic numerals, 0 to 9.

For buckets with a name containing a dot (.), users must use the canonical path. The subdomain form, for instance, `https://my.bucket.s3.nl-ams.scw.cloud` will not work as the SSL certificate `*.s3.nl-ams.scw.cloud` is not recursive.

In addition, when using buckets with Secure Sockets Layer (SSL), the SSL wildcard certificate only matches buckets that do not contain periods. Therefore, avoid using bucket names with multiple dots, as it will have an impact on accessing your bucket via HTTPS. Use **dashes** in your bucket names instead.

Bucket names are unique in our whole platform. This means **if a bucket exists already in one region, the name cannot be reused in another**.
The `“Bucket already exists”` error message is triggered when the name you intended to use for your bucket is already reserved by another user (or yourself).

<Message type="note">
When deleting a bucket, its name becomes available again. Anybody can reuse it on a first-come, first-served principle.
</Message>

## Can I use Object Storage as a CDN?

The Object Storage product delivers content for your applications and users from a single point in the region of your choice.
Our platform is designed to deliver very high performance, up to 100 Gbit/sec per bucket per region without performance loss.

If you want to deliver your content to several geographic locations with minimal latency, you can use Scaleway's [Edge Services](/object-storage/how-to/get-started-edge-services/) directly from your bucket.

## Can I access my files via HTTPS?

Yes, you can access your files via HTTPS by creating a public link from the Scaleway console. Follow the [How to access my files via HTTPS](/object-storage/how-to/access-objects-via-https/) documentation to do so.

## Can I change HTTP headers during upload?

Yes, you can change HTTP headers with tools such as `s3cmd`, but only `Cache-control` or headers prefixed by `x-amz-meta`.

To replace metadata using the `AWS CLI`, you can use the command below:
```
aws s3 cp s3://BUCKET/ s3://BUCKET/ --recursive --acl public-read --metadata-directive REPLACE --cache-control public,max-age=31536000
```

## Can I make an object public?

Yes. All objects are private by default, but you can change their visibility to public any time. Follow the [How to manage object visibility](/object-storage/how-to/manage-object-visibility/) documentation to do so.

## How can I upload large objects?

Object Storage supports multipart upload. We recommend uploading by chunks, with a limit of 1000 chunks.

The following technical specifications apply to multipart uploads:

- 1 to 1000 parts per object
- 5 MB to 5 GB per part (except for the last one)
- Each object stores up to 5 TB

For more information, refer to the [documentation](/object-storage/api-cli/multipart-uploads/).

## How many versions of a single object can I store?

You can store up to **1,000 versions** of a single object. Once this limit is reached, Scaleway Object Storage may no longer guarantee successful creation of new versions or optimal performance.

## Does my bucket remain available after deletion?

If your bucket has been deleted from the Scaleway console, our teams may, as a last option, be able to retrieve its data the same day it is deleted (excluding weekends).
Nevertheless, this measure applies on a case-by-case basis and is not guaranteed. Contact Scaleway's Support team if you need to recover data from a deleted bucket within this time frame.

If your bucket has been deleted via the API, it is deleted instantly.

## Does Object Storage provide read-after-write consistency?

Yes. Scaleway Object Storage provides `read-after-write` consistency for `PUT` and `DELETE` requests of objects in buckets in all regions. This applies to writes of new objects as well as requests overwriting existing objects and to DELETEs.

`Read-after-write` consistency guarantees that changes are immediately visible (reading data) right after making those changes (writing data), meaning that a newly-created object will be visible immediately, without any delay.
Scaleway Object Storage stores data across multiple storage systems to achieve high availability. Any read (`GET` or `LIST`) request initiated after a successful `PUT` request will immediately return the data written by the `PUT` request.

Examples:
- You upload a new object into your bucket and request a listing of the objects in it: The new object will be visible in the list.
- You delete an existing object in your bucket and try to immediately read it. Object Storage will not return any data as the object has been deleted.

## Will closing my web browser after requesting to delete a bucket stop the deletion process?

No. After you click the button to delete a bucket in the Scaleway console, the request is processed in our backend, and does not depend on your web browser. For more information on how to delete a bucket, refer to the [dedicated documentation](/object-storage/how-to/delete-a-bucket/).

## Can I create a bucket with the same name as a previously deleted one?

Yes. If you have deleted a bucket via the Scaleway console, you can create a new one with the same name after a delay of 24 hours.

## Is there a quota limit for Object Storage?

Each Scaleway Project can use up to 250 TB of Object Storage resources. If you wish to increase your Object Storage quota, [contact Scaleway's Support team](https://console.scaleway.com/support).

### Object Storage classes

#### What are the Object Storage classes offered by Scaleway?

Scaleway offers three storage classes:

- **Standard Multi-AZ**: your data is secured by distributing it across three different [Availability Zones (AZ)](/object-storage/concepts/#region-and-availability-zone). In the event of a complete data center failure in an AZ, we are still able to rebuild your data and make it accessible. This is the system we call Multi-AZ (one data center per AZ, three AZs per region). The Standard Multi-AZ class is available in [all regions](/object-storage/concepts/#region-and-availability-zone).
- **Standard Multi-AZ**: your data is secured by distributing it across three different [Availability Zones (AZ)](/object-storage/concepts/#region-and-availability-zone). In the event of a complete data center failure in an AZ, we are still able to rebuild your data and make it accessible. This is the system we call Multi-AZ (one data center per AZ, three AZs per region). The Standard Multi-AZ class is available in the `fr-par`, `nl-ams`, `pl-waw` [regions](/object-storage/concepts/#region-and-availability-zone).

- **Standard One Zone**: your data is stored across three different racks in a single [Availability Zone (AZ)](/object-storage/concepts/#region-and-availability-zone). This storage class is best suited for secondary backups and recreatable data. The Standard One Zone class is available in [all regions](/object-storage/concepts/#region-and-availability-zone).

Expand All @@ -38,7 +165,7 @@ Scaleway offers three storage classes:

When the Standard Multi-AZ storage class is launched in a region, it becomes possible to upload objects in the `STANDARD` class, that corresponds to the Standard Multi-AZ storage class.

To use this new class after its launch in a region, create a new bucket and migrate your objects previously stored using the Standard One Zone class (= One Zone IA) to this new bucket, using the new Standard Multi-AZ standard class (=Standard).
To use this new class after its launch in a region, create a new bucket and migrate your objects previously stored using the Standard One Zone class (= One Zone IA) to this new bucket, using the new Standard Multi-AZ standard class (= Standard).

#### Can I create a lifecycle rule to restore objects from Glacier class to Standard One Zone?

Expand Down
8 changes: 1 addition & 7 deletions pages/object-storage/how-to/create-a-bucket.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,7 @@ To get started with Object Storage, you must first create a bucket. Objects are

1. Click **Object Storage** on the left side menu of the console. The Object Storage dashboard displays.
2. Click **+ Create bucket**. The bucket creation page displays.
3. Select the [region](/object-storage/concepts/#region-and-availability-zone) in which to create your bucket:
- Amsterdam, The Netherlands:
- Region: `nl-ams`
- Paris, France:
- Region: `fr-par`
- Warsaw, Poland:
- Region: `pl-waw`
3. Select the [region](/object-storage/concepts/#region-and-availability-zone) in which to create your bucket.
4. 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](/object-storage/concepts/#visibility).
<Message type="note">
A file uploaded to a public bucket is private by default.
Expand Down
12 changes: 3 additions & 9 deletions pages/object-storage/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,13 +26,7 @@ To get started with Object Storage, you must first create a bucket. Objects are

1. Click **Object Storage** on the left side menu of the console. The Object Storage dashboard displays.
2. Click **+ Create bucket**. The bucket creation page displays.
3. 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`
- Paris, France:
- Region: `fr-par`
- Warsaw, Poland:
- Region: `pl-waw`
3. Select the geographical location in which to create your bucket.
4. 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](/object-storage/concepts/#visibility).
<Message type="note">
A file uploaded to a public bucket is private by default.
Expand All @@ -56,9 +50,9 @@ You can find more information about your bucket by clicking on its name in the *
Before uploading your files, make sure the file name follows the [AWS S3 Object key naming guidelines](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines).
</Message>
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 Multi-AZ](/object-storage/faq/#what-are-the-object-storage-classes-offered-by-scaleway), and is available in all regions. It is suitable for any use case, such as on-demand content, like streaming or CDN.
- [Standard Multi-AZ](/object-storage/faq/#what-are-the-object-storage-classes-offered-by-scaleway), and is available in Paris, Amsterdam and Warsaw. It is suitable for any use case, such as on-demand content, like streaming or CDN.
- [Standard One Zone](/object-storage/concepts/#storage-class): The `Standard One Zone` class is available in all regions, and is a good choice for storing secondary backup copies or easily re-creatable data.
- [Glacier](/object-storage/concepts/#storage-class): Archived storage. Your data needs to be restored first to be accessed. This class is available in the `fr-par` and `nl-ams` regions.
- [Glacier](/object-storage/concepts/#storage-class): Archived storage. Your data needs to be restored first to be accessed. This class is available in the Paris and Amsterdam regions.

<Message type="note">
- Pricing depends on the storage class you have selected.
Expand Down
Loading