diff --git a/faq/objectstorage.mdx b/faq/objectstorage.mdx index b035456d6f..d32608e67d 100644 --- a/faq/objectstorage.mdx +++ b/faq/objectstorage.mdx @@ -232,7 +232,7 @@ Find out [how to restore an object from Glacier](/storage/object/how-to/restore- ## Can I upload an object directly to Glacier? -Yes, you can select the storage class (`STANDARD`, `One Zone IA`, or `GLACIER`) when uploading objects using the Scaleway console. It is also possible to do so using the API. For more information, refer to our [dedicated documentation](/storage/object/how-to/edit-storage-class/). +Yes, you can select the storage class (`Standard`, `One Zone IA`, or `GLACIER`) when uploading objects using the Scaleway console. It is also possible to do so using the API. For more information, refer to our [dedicated documentation](/storage/object/how-to/edit-storage-class/). ## Why are Glacier objects stored in Paris DC4? Is it accessible from buckets in all locations? diff --git a/local_404.txt b/local_404.txt deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/storage/object/api-cli/enable-sse-c.mdx b/storage/object/api-cli/enable-sse-c.mdx index fe80ce3e89..80e38da80c 100644 --- a/storage/object/api-cli/enable-sse-c.mdx +++ b/storage/object/api-cli/enable-sse-c.mdx @@ -129,12 +129,16 @@ The [AWS S3 CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/refere 2. Run the command below to copy a local file to your Object Storage bucket. Make sure to replace the placeholders with the appropriate values. ```sh - aws s3 cp s3:/// --sse-c AES256 --sse-c-key fileb://ssec.key + aws s3 cp s3:/// \ + --sse-c AES256 \ + --sse-c-key fileb://ssec.key ``` 3. Run the command below to download the file from your Object Storage bucket to your local file system. Make sure to replace the placeholders with the appropriate values. ```sh - aws s3 cp s3:/// --sse-c AES256 --sse-c-key fileb://ssec.key + aws s3 cp s3:/// \ + --sse-c AES256 \ + --sse-c-key fileb://ssec.key ``` diff --git a/storage/object/api-cli/managing-lifecycle-cliv2.mdx b/storage/object/api-cli/managing-lifecycle-cliv2.mdx index df8185b9ff..5ebc95e354 100644 --- a/storage/object/api-cli/managing-lifecycle-cliv2.mdx +++ b/storage/object/api-cli/managing-lifecycle-cliv2.mdx @@ -7,14 +7,14 @@ content: paragraph: Manage object lifecycles in Scaleway Object Storage using CLI v2 commands. tags: object storage object-storage rclone s3cmd minio client mc cliv2 cli scw dates: - validation: 2024-06-14 + validation: 2024-12-23 posted: 2021-08-05 categories: - storage - object-storage --- -[Scaleway Object Storage](/storage/object/concepts/#object-storage) is a service based on the Amazon S3 protocol. It allows you to store different types of objects (documents, images, videos, etc.) and distribute them instantly, anywhere in the world. You can create and manage your Object Storage resources from the [console](https://console.scaleway.com/login), or via the [Scaleway Command Line Interface](/developer-tools/scaleway-cli/quickstart/) that uses external tools such as `rclone`, `s3cmd` and `mc`. +[Scaleway Object Storage](/storage/object/concepts/#object-storage) is a service based on the Amazon S3 protocol. It allows you to store different types of objects (documents, images, videos, etc.) and distribute them instantly, anywhere in the world. You can create and manage your Object Storage resources from the [console](https://console.scaleway.com/login), or via the [Scaleway Command Line Interface](/developer-tools/scaleway-cli/quickstart/) that uses external tools such as [S3cmd](https://github.com/s3tools/s3cmd), [Rclone](https://rclone.org/downloads/) or [MinIO Client (mc)](https://github.com/minio/mc). ## Scaleway Command Line Interface Overview @@ -27,23 +27,26 @@ categories: - A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/) - An [Object Storage bucket](/storage/object/how-to/create-a-bucket/) - Installed and initialized the [Scaleway CLI](/developer-tools/scaleway-cli/quickstart/) -- Downloaded [S3cmd](https://github.com/s3tools/s3cmd), [rclone](https://rclone.org/downloads/) and [mc](https://github.com/minio/mc) +- Downloaded [S3cmd](https://github.com/s3tools/s3cmd), [Rclone](https://rclone.org/downloads/) and [MinIO Client (mc)](https://github.com/minio/mc) +## Previewing an Object Storage configuration file for the Scaleway CLI -## Creating a configuration file for the Scaleway CLI +The `scw object config get` command allows you to output the content of the configuration file in a terminal and preview the different fields. - - Unless you add a region argument to your commands, the configuration file will be set for the default region. + + For more information about generating a configuration file, type the following command in your terminal: + ``` + scw object config get --help + ``` -1. Run the following command in a terminal to create a configuration file with `rclone`: - + + +Run the following command in a terminal to preview the configuration file for Rclone: ``` scw object config get type=rclone ``` - An output similar to the following displays: - ``` # Generated by scaleway-cli command # Configuration file for rclone https://rclone.org/s3/#scaleway @@ -52,8 +55,8 @@ categories: type = s3 env_auth = false endpoint = s3.nl-ams.scw.cloud - access_key_id = SCW85PRCA6HD4PDEWS5M - secret_access_key = 8bd5d8ce-d476-4bd5-b97d-2d97e04c3c4d + access_key_id = SCWEXAMPLED4PDEWS5M + secret_access_key = example-d476-4bd5-b97d-2d97e04c3c4d region = nl-ams location_constraint = acl = private @@ -61,7 +64,9 @@ categories: server_side_encryption = storage_class = ``` -2. Run the following command in a terminal to create a configuration file with `s3cmd`: + + +Run the following command in a terminal to preview the configuration file for S3cmd: ``` scw object config get type=s3cmd @@ -73,58 +78,65 @@ categories: # Configuration file for s3cmd https://s3tools.org/s3cmd # Default location: $HOME/.s3cfg [default] - access_key = SCW85PRCA6HD4PDEWS5M + access_key = SCWEXAMPLED4PDEWS5M bucket_location = nl-ams host_base = s3.nl-ams.scw.cloud host_bucket = %(bucket)s.s3.nl-ams.scw.cloud - secret_key = 12345678-1234-1234-4321-123456789123 + secret_key = example-d476-4bd5-b97d-2d97e04c3c4d use_https = True ``` -3. Run the following command in a terminal to create a configuration file with `mc`: + + +Run the following command in a terminal to preview the configuration file for MinIO Client (mc): ``` scw object config get type=mc ``` - An output similar to the following displays: - ``` - {"version":"9","hosts":{"scaleway":{"url":"https://s3.nl-ams.scw.cloud","accessKey":"SCW1111111111111","secretKey":"12345678-1234-1234-4321-123456789123","api":"S3v4"}}} + {"version":"9","hosts":{"scaleway":{"url":"https://s3.nl-ams.scw.cloud","accessKey":"SCWEXAMPLED4PDEWS5M","secretKey":"example-d476-4bd5-b97d-2d97e04c3c4d","api":"S3v4"}}} ``` - - - For more information about generating a configuration file, type the following command in your terminal: - ``` - scw object config get --help - ``` - + + ## Installing a configuration file for Amazon S3-compatible tools (s3cmd, rclone, and mc) -1. Run the following command in a terminal to install a configuration file for `s3cmd`: +The `scw object config install` allows you to create a configuration file for the selected third party tool based on your [Scaleway CLI configuration](/developer-tools/scaleway-cli/quickstart/). + + + Creating a new configuration file using `scw object config install` will overwrite the existing one for the specified third party tool. To update an existing configuration, [generate a preview](#previewing-an-object-storage-configuration-file-for-the-scaleway-cli) and manually edit the configuration file. + + + + +Run the following command in a terminal to install a configuration file for Rclone: + ``` - scw object config install type=s3cmd + scw object config install type=rclone ``` An output similar to the following displays: ``` - Configuration file successfully installed at /Users/yourusername/.s3cfg. + Configuration file successfully installed at /Users/yourusername/.config/rclone/rclone.conf. ``` -2. Run the following command in a terminal to install a configuration file for `rclone`: - + + +Run the following command in a terminal to install a configuration file for `s3cmd`: ``` - scw object config install type=rclone + scw object config install type=s3cmd ``` An output similar to the following displays: ``` - Configuration file successfully installed at /Users/yourusername/.config/rclone/rclone.conf. + Configuration file successfully installed at /Users/yourusername/.s3cfg. ``` -3. Run the following command in a terminal to install a configuration file for `mc`: + + +Run the following command in a terminal to install a configuration file for MinIO Client (mc): ``` - scw object config install type=mc` + scw object config install type=mc ``` An output similar to the following displays: @@ -132,82 +144,230 @@ categories: ``` Configuration file successfully installed at /Users/yourusername/.mc/config.json. ``` + + -## Adding an Object Storage bucket +## Creating an Object Storage bucket + + 1. Run the following command in a terminal to create a bucket: ``` - s3cmd mb s3://your-bucket + rclone mkdir scaleway:my-bucket ``` - An output similar to the following displays: +2. Run the following command to list your newly created bucket: + + ``` + rclone lsd scaleway: + ``` + An output similar to the following displays: ``` - Bucket 's3://your-bucket/' created + rclone lsd scaleway: + -1 2022-06-04 14:38:03 -1 my-bucket + -1 2023-12-23 12:10:57 -1 my-new-bucket ``` + + +Run the following command in a terminal to create a bucket: -2. Run the following command in a terminal to add an object to your bucket: + ``` + s3cmd mb s3://my-bucket + ``` + An output similar to the following displays: + ``` + Bucket 's3://my-bucket/' created + ``` + + +Run the following command in a terminal to add an object to your bucket: ``` - s3cmd put file /path/to/object/your-object s3://your-bucket/your-object` + mc mb scaleway/my-bucket ``` An output similar to the following displays: ``` - upload: '/path/to/object/your-object' -> 's3://your-bucket/your-object' [1 of 1] - 3259 of 3259 100% in 0s 8.47 KB/s done + Bucket created successfully `scaleway/my-bucket`. ``` + + -## Removing an object from a bucket +## Uploading an object to a bucket -Run the following command in a terminal to remove an object from your bucket: + + +1. In a terminal, access the folder containing the file you want to upload, then run the following command: + ``` + rclone copy /path/to/object/my-object scaleway:my-bucket + ``` +2. Run the command below to list the object you just uploaded: + ``` + rclone ls scaleway:my-bucket + ``` + An output similar to the following displays: + ``` + 0 my-object + ``` + + +In a terminal, access the folder containing the file you want to upload, then run the following command: ``` - s3cmd delete: s3://your-bucket/your-object + s3cmd put file /path/to/object/my-object s3://my-bucket/my-object ``` An output similar to the following displays: ``` - delete: 's3://your-bucket/your-object' + upload: '/path/to/object/my-object' -> 's3://my-bucket/my-object' [1 of 1] + 3259 of 3259 100% in 0s 8.47 KB/s done ``` + + +In a terminal, access the folder containing the file you want to upload, then run the following command: - - For more information about removing objects, run the following command in your terminal: - ``` - s3cmd --help - ``` - + ``` + mc cp /path/to/local/file/my-file alias/bucket-name + ``` -## Deleting an Object Storage bucket + An output similar to the following displays: - - This action will delete every object stored inside your bucket. Your bucket name will no longer be yours, and other users will be able to use it. - + ``` + .../my-file: 28 B / 28 B ░░░░░░░░░░░░░░░░░░░░░░▓ + ``` + + -1. Run the following command in a terminal to display your buckets: +## Downloading an object from a bucket + + +1. In a terminal, run the following command to download an object from a bucket: ``` - s3cmd ls + rclone copy scaleway:my-bucket/my-object /path/to/destination + ``` +2. Run the command below to list the object you just downloaded: + ``` + ls /path/to/destination ``` - An output similar to the following displays: - ``` - 2021-09-01 15:56 s3://your-bucket + my-object + ``` + + +1. In a terminal, run the following command to download an object from a bucket: ``` + s3cmd get s3://my-bucket/my-object /path/to/destination + ``` +2. Run the command below to list the object you just downloaded: + ``` + ls /path/to/destination + ``` + An output similar to the following displays: + ``` + my-object + ``` + + +1. In a terminal, run the following command to download an object from a bucket: + ``` + mc cp scaleway/my-bucket/my-object /path/to/destination + ``` +2. Run the command below to list the object you just downloaded: + ``` + ls /path/to/destination + ``` + An output similar to the following displays: + ``` + my-object + ``` + + + +## Removing an object from a bucket -2. Run the following command in a terminal to delete a bucket: + + +1. In a terminal, run the following command to remove an object from a bucket: + ``` + rclone delete scaleway:my-bucket/my-object + ``` +2. Run the command below to make sure the object has been removed: + ``` + rclone ls scaleway:my-bucket + ``` + The object no longer appears in the output. + + +1. In a terminal, run the following command to remove an object from a bucket: + ``` + s3cmd del s3://my-bucket/my-object + ``` +2. Run the command below to make sure the object has been removed: + ``` + s3cmd ls s3://my-bucket + ``` + The object no longer appears in the output. + + +1. In a terminal, run the following command to remove an object from a bucket: + ``` + mc rm scaleway/my-bucket/my-object + ``` +2. Run the command below to make sure the object has been removed: + ``` + mc ls scaleway/my-bucket + ``` + The object no longer appears in the output. + + - `s3cmd rb s3://your-bucket` +## Deleting an Object Storage bucket - An output similar to the following displays: + + This action will delete every object stored inside your bucket. The bucket name will no longer be yours, and other users will be able to use it. + + + +1. In a terminal, run the following command to delete a bucket: + ``` + rclone purge scaleway:my-bucket + ``` +2. Run the command below to make sure the bucket has been deleted: + ``` + rclone lsd scaleway: + ``` + The bucket no longer appears in the output. + + +1. In a terminal, run the following command to delete a bucket: + ``` + s3cmd rb s3://my-bucket + ``` +2. Run the command below to make sure the bucket has been deleted: + ``` + s3cmd ls + ``` + The bucket no longer appears in the output. + + +1. In a terminal, run the following command to delete a bucket: + ``` + mc rb scaleway/my-bucket + ``` +2. Run the command below to make sure the bucket has been deleted: ``` - Bucket 's3://your-bucket/' removed + mc ls scaleway ``` + The bucket no longer appears in the output. + + For more information about the Amazon S3-compatible tools used in this documentation, refer to the official [rclone](https://rclone.org/docs/), [s3cmd](https://s3tools.org/s3cmd-howto), and [mc](https://github.com/minio/mc) documentation. diff --git a/storage/object/api-cli/object-storage-aws-cli.mdx b/storage/object/api-cli/object-storage-aws-cli.mdx index 6131cfa15c..2dd57bf70e 100644 --- a/storage/object/api-cli/object-storage-aws-cli.mdx +++ b/storage/object/api-cli/object-storage-aws-cli.mdx @@ -49,6 +49,8 @@ The AWS-CLI is an open-source tool built on top of the [AWS SDK for Python (Boto region = nl-ams output = json services = scw-nl-ams + + [services scw-nl-ams] s3 = max_concurrent_requests = 100 max_queue_size = 1000 @@ -59,8 +61,7 @@ The AWS-CLI is an open-source tool built on top of the [AWS SDK for Python (Boto # to upload files up to 5 TB. multipart_chunksize = 10 MB - [services scw-nl-ams] - s3 = + s3api = endpoint_url = https://s3.nl-ams.scw.cloud ``` @@ -68,22 +69,36 @@ The AWS-CLI is an open-source tool built on top of the [AWS SDK for Python (Boto 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). - 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 endpoint from your default one: +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: ``` [default] region = nl-ams services = scw-nl-ams - ... - [profile two] region = fr-par services = scw-fr-par - ... ``` -5. Optionally, open the `~/.aws/credentials` file and create other profiles by adding a block to indicate their credentials as follows: +6. Configure additional services by adding a new block after `[service scw-nl-ams]`. For example, you can create a second services block called `[services scw-fr-par]`, as shown below: + + ``` + [services scw-fr-par] + s3 = + endpoint_url = https://s3.fr-par.scw.cloud + max_concurrent_requests = 100 + max_queue_size = 1000 + multipart_threshold = 50 MB + # Edit the multipart_chunksize value according to the file sizes that you + # want to upload. The present configuration allows to upload files up to + # 10 GB (1000 requests * 10 MB). For example, setting it to 5 GB allows you + # to upload files up to 5 TB. + multipart_chunksize = 10 MB + s3api = + endpoint_url = https://s3.fr-par.scw.cloud + +5. Open the `~/.aws/credentials` file and create other profiles by adding a block to indicate their credentials as follows: ``` [default] @@ -95,6 +110,10 @@ The AWS-CLI is an open-source tool built on top of the [AWS SDK for Python (Boto aws_secret_access_key= ``` + + The profile names from the configuration file (here, `[profile two]`) and from the credentials file (here, `[two]`) must be identical. + + 6. Run the following command to test your AWS CLI installation: ``` @@ -110,8 +129,4 @@ The AWS-CLI is an open-source tool built on top of the [AWS SDK for Python (Boto ``` - Refer to the [official documentation](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) for more information on how to configure and manage your AWS CLI v2 settings and credentials. - - - diff --git a/storage/object/how-to/create-a-bucket.mdx b/storage/object/how-to/create-a-bucket.mdx index 4db4ebf686..b43c756098 100644 --- a/storage/object/how-to/create-a-bucket.mdx +++ b/storage/object/how-to/create-a-bucket.mdx @@ -7,7 +7,7 @@ content: paragraph: Create a new bucket in Scaleway Object Storage. tags: object storage bucket object-storage dates: - validation: 2024-06-13 + validation: 2024-12-18 posted: 2021-05-27 categories: - storage @@ -21,12 +21,11 @@ Object Storage allows you to store different types of objects (documents, images - A Scaleway account logged into the [console](https://console.scaleway.com) - [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization - 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 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. +3. Select the [region](/storage/object/concepts/#region-and-availability-zone) in which to create your bucket: - Amsterdam, The Netherlands: - Region: `nl-ams` - Paris, France: @@ -42,8 +41,8 @@ To get started with Object Storage, you must first create a bucket. Objects are 5. Select a use case for your bucket. 6. Enable [bucket versioning](/storage/object/how-to/use-bucket-versioning/) if you want to store multiple versions of your objects (this may lead to higher storage costs). 7. If applicable, you can tick the **Activate 90-day free trial** to benefit from 750 GB of free [Multi-AZ class storage](/faq/objectstorage/#what-are-the-object-storage-classes-offered-by-scaleway) for buckets in your Organization, across all regions. Refer to our [dedicated FAQ](/faq/objectstorage/#how-can-i-benefit-from-the-object-storage-free-trial) for more information. -8. Enter a name for your bucket. +8. Enter a name for your bucket. 9. Optionally, you can use the cost estimator to simulate your Object Storage costs. 10. 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. +You can find more information about your bucket by clicking on its name in the **Buckets** list, and then on the **Bucket settings** tab. diff --git a/storage/object/how-to/delete-a-bucket.mdx b/storage/object/how-to/delete-a-bucket.mdx index 04130bb8f6..190a16df89 100644 --- a/storage/object/how-to/delete-a-bucket.mdx +++ b/storage/object/how-to/delete-a-bucket.mdx @@ -7,7 +7,7 @@ content: paragraph: Delete unwanted buckets from Scaleway Object Storage. tags: object storage object-storage bucket dates: - validation: 2024-06-13 + validation: 2024-12-19 posted: 2021-01-04 categories: - storage @@ -38,4 +38,3 @@ Alternatively, you can delete a bucket by clicking the icon Once the bucket is deleted, it disappears from your bucket list. - diff --git a/storage/object/how-to/manage-object-visibility.mdx b/storage/object/how-to/manage-object-visibility.mdx index dbcb348088..e83e23f9de 100644 --- a/storage/object/how-to/manage-object-visibility.mdx +++ b/storage/object/how-to/manage-object-visibility.mdx @@ -7,14 +7,14 @@ content: paragraph: Control visibility settings for objects in Object Storage. tags: object storage object-storage visibility dates: - validation: 2024-06-13 + validation: 2024-12-19 posted: 2021-05-27 categories: - storage - object-storage --- -Visibility specifies whether your object is visible to others or not. +Object visibility specifies whether your object is visible to others or not, independently from [bucket visibility](/storage/object/concepts/#visibility). @@ -26,6 +26,8 @@ Visibility specifies whether your object is visible to others or not. All objects are private by default, even if they are in a public bucket. A private file in a public bucket cannot be accessed publicly. +## Manage the visibility of a single object + 1. Click **Object Storage** in the **Storage** section of the side menu. The list of your buckets displays. 2. Click the name of your bucket. A list of your objects displays. 3. Click next to the selected object name. @@ -33,12 +35,30 @@ Visibility specifies whether your object is visible to others or not. 5. Check **Public** or **Private** according to your preference. 6. Click **Update object visibility** to confirm. - - You can only configure the visibility (public or private) of one object at a time. It is not possible to perform this action on an entire bucket, on which visibility is defined by default as private. Allowing public visibility of a bucket only allows the viewing of a list of objects that are stored in the bucket. - - -If you upload a file using the CLI, you can make it public by using the `--acl public-read` parameter. +If you upload a file using the CLI, you can make it public by using the `--acl public-read` parameter. However, [bucket policies](/storage/object/api-cli/bucket-policy/) take precedence over ACLs. +## Manage the visibility of multiple objects + +You can manage the visibility of multiple ojects at a time using a [bucket policy](/storage/object/api-cli/bucket-policy/) as shown below. By allowing [GetObject](/storage/object/api-cli/object-operations/#getobject) operations to everyone, the desired objects can be accessed by any person with the link to the object. +```json +{ + "Id": "object-visibility", + "Version": "2023-04-17", + "Statement": [ + { + "Sid": "make-objects-visible", + "Principal": "*", + "Action": [ + "s3:GetObject" + ], + "Effect": "Allow", + "Resource": [ + "my-bucket/public-objects" + ] + }, + ] +} +``` diff --git a/storage/object/how-to/restore-an-object-from-glacier.mdx b/storage/object/how-to/restore-an-object-from-glacier.mdx index 0a2931dfdc..3e51a8429f 100644 --- a/storage/object/how-to/restore-an-object-from-glacier.mdx +++ b/storage/object/how-to/restore-an-object-from-glacier.mdx @@ -7,7 +7,7 @@ content: paragraph: Retrieve objects from Glacier in Object Storage. tags: object-storage object storage glacier dates: - validation: 2024-06-13 + validation: 2024-12-19 posted: 2021-05-27 categories: - storage @@ -22,28 +22,26 @@ categories: - An object in [Glacier storage class](/storage/object/how-to/edit-storage-class/) - Objects in `Glacier` can only be restored to `Standard` class. + Objects in Glacier can only be restored to `Standard` class. - To facilitate the steps of restoration and ensure fast restitution of your data, we recommend you store average-sized files (larger than 1 MB) in `Glacier`, as opposed to several small files. + To facilitate the steps of restoration and ensure fast restitution of your data, we recommend you store average-sized files (larger than 1 MB) in Glacier, as opposed to several small files. ## How to restore an object 1. Click **Object Storage** in the **Storage** section of the side menu. The list of your buckets displays. -2. Click the bucket name that contains the objects you want to restore to `STANDARD` class. The list of objects displays. +2. Click the bucket name that contains the objects you want to restore to `Standard` class. The list of objects displays. -3. Click , then select **Restore** from the drop-down menu. +3. Click , then select **Restore** from the drop-down menu. A pop-up appears. - A pop-up appears. - -4. Enter the number of days after which the object will be transferred back to `Glacier`, or click the toggle to permanently restore the object. +4. Enter the number of days after which the object will be transferred back to Glacier, or click the toggle to permanently restore the object. 5. Click **Restore object from Glacier**. - Your object remains available in `Standard` class for the duration you specified. It will be transferred automatically back to `Glacier` once the configured period is over. + Your object remains available in `Standard` class for the duration you specified. It will be transferred automatically back to Glacier once the configured period is over. ## How to restore all objects in a bucket @@ -77,7 +75,7 @@ The time it takes to restore an object depends on the size of the object and if For multipart objects, each part is equivalent to one object. Consequently, the more parts your object has, the longer the restore time will be. -To determine how many parts a multipart object has, you can run the following `aws-cli` command: +To determine how many parts a multipart object has, run the following `aws-cli` command: ``` aws s3api --bucket --key b @@ -96,5 +94,3 @@ For a multipart object, the `Etag` includes a suffix that indicates the number o } ``` Therefore, in this example, the time it takes to restore the object (that has 14 parts) is equivalent to the time it takes to restore 14 objects. - - diff --git a/storage/object/how-to/upload-files-into-a-bucket.mdx b/storage/object/how-to/upload-files-into-a-bucket.mdx index 7605aa6c75..c7a839088c 100644 --- a/storage/object/how-to/upload-files-into-a-bucket.mdx +++ b/storage/object/how-to/upload-files-into-a-bucket.mdx @@ -7,7 +7,7 @@ content: paragraph: Upload files into your Scaleway Object Storage bucket. tags: bucket object-storage object storage dates: - validation: 2024-06-14 + validation: 2024-12-19 posted: 2021-05-27 categories: - storage diff --git a/storage/object/how-to/use-bucket-versioning.mdx b/storage/object/how-to/use-bucket-versioning.mdx index b8081007f9..f14c54ea6d 100644 --- a/storage/object/how-to/use-bucket-versioning.mdx +++ b/storage/object/how-to/use-bucket-versioning.mdx @@ -7,7 +7,7 @@ content: paragraph: Enable and manage bucket versioning for Object Storage. tags: object storage object-storage bucket versioning archived dates: - validation: 2024-06-13 + validation: 2024-12-19 posted: 2021-05-27 categories: - storage @@ -33,7 +33,7 @@ Versioning allows you to easily recover your objects in case of unintended user 5. Type **ENABLE** to confirm your action, then click **Enable bucket versioning** to proceed. -Once versioning is enabled, uploading an object with the same name as an existing object will create a new version of it, and will consume more storage, which may lead to higher costs. +Once versioning is enabled, uploading an object with the same name as an existing object will create a new version of it. This new version will consume more storage, which may lead to higher costs. ## How to manage object versions @@ -42,7 +42,7 @@ Once versioning is enabled, uploading an object with the same name as an existin 2. Click the name of your selected bucket. A list of the objects it contains appears. 3. Click next to the object you want to manage, then click **Versioning**. A list of the object versions displays. -4. Click next to a non-current object version to download or permanently delete it. +4. Click next to a non-current object version to download it, or permanently delete it. To restore an object to a previous version, download the desired non-current version and upload it again. This action will replace the current version with the uploaded one. @@ -59,5 +59,3 @@ To restore an object to a previous version, download the desired non-current ver Once versioning is suspended, no new object versions will be created. Versions created up until this point will remain stored and billable. Uploading an object with the same name as an existing object will overwrite it. - -