diff --git a/pages/storage_and_backup/object_storage/cold_archive_getting_started/guide.en-gb.md b/pages/storage_and_backup/object_storage/cold_archive_getting_started/guide.en-gb.md index 7b397cb1398..f4bbab2b4c5 100644 --- a/pages/storage_and_backup/object_storage/cold_archive_getting_started/guide.en-gb.md +++ b/pages/storage_and_backup/object_storage/cold_archive_getting_started/guide.en-gb.md @@ -1,16 +1,15 @@ --- title: Cold Archive - Getting started with Cold Archive excerpt: This guide shows you how to manage your data with Cold Archive -updated: 2024-11-29 +updated: 2025-07-04 --- ## Objective -Cold Archive is a service for long-term data storage. -When archived, every object of a bucket is stored on physical tapes. -Restoration can take some time as it needs to be read on tapes. +Cold Archive provides long-term data storage by archiving bucket objects onto physical tapes. +Restoration may take some time since data is read from tapes. -**This guide explains how to set up storage on tapes with Cold Archive.** +**This guide explains how to set up and manage storage on tapes with Cold Archive, in coexistence with your Object Storage.** ## Requirements @@ -19,14 +18,25 @@ Restoration can take some time as it needs to be read on tapes. ## Instructions +> [!primary] +> +> You can find the Cold Archive storage presentation and workflow [here](/pages/storage_and_backup/object_storage/cold_archive_overview). +> + +This section explains the step-by-step process to configure, archive, restore, and delete buckets with Cold Archive, in coexistence with your Object Storage. + In this tutorial, **awscli aliases** are used to simplify the commands. +### Initial Setup: create AWS CLI Aliases + +To simplify commands, create or edit the ~/.aws/cli/alias file: + ```bash mkdir -p ~/.aws/cli touch ~/.aws/cli/alias ``` -Add this content to the file: +Add the following content: ```bash [toplevel] @@ -44,50 +54,41 @@ delete-ovh-archive = s3api delete-bucket-intelligent-tiering-configuration --id > > - `Id` is a string used to identify the S3 **\*** Intelligent-Tiering configuration. Its value is arbitrary and up to you. It will be necessary for further PUT, GET and DELETE operations on the intelligent-tiering configuration. > -> - `Status` and `Days` are mandatory but not used. +> - `Status` and `Days` are mandatory but not used. Days is only meaningful with certain access tiers. > -To retrieve an Intelligent tiering configuration, use the get-bucket-intelligent-tiering-configuration command: +### Check for Incomplete Multipart Uploads Before Archiving + +Run this command to ensure there are no incomplete multipart uploads on your bucket: ```bash -aws s3api get-bucket-intelligent-tiering-configuration --bucket example-bucket --id myid +aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api list-multipart-uploads --bucket <bucket_name> ``` -```json -{ - "Id": "myid", - "Status": "Enabled", - "Tierings": [ - {"Days": 999, "AccessTier": "OVH_ARCHIVE"} - ] -} -``` +### **Archive a Bucket** > [!primary] > -> If you have defined multiple profiles, add `--profile <profile>` to the command line. +> Before archiving a bucket, make sure there are no incomplete multipart uploads. > -### Bucket archiving - -Before archiving a bucket, make sure there are no incomplete multipart uploads. -This can be done with: - -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api list-multipart-uploads --bucket <bucket_name> -``` - -#### Archive a bucket - -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-archive <bucket_name> -``` +> [!tabs] +> Via the AWS S3api +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-archive <bucket_name> +>> ``` +>> +> Via the OVHcloud Control Panel +>> Click on` the three dots`{.action}, then select `Archive`{.action} +>> +>> {.thumbnail} +>> -After this request, the bucket is not archived yet.<br> -It will take some time before it is archived on the tapes.<br> -From this command and until a restoration, the bucket cannot accept any read or write requests on objects (listing objects is still allowed). +- The bucket status changes to Archiving. +- Objects cannot be read or written during this process; only listing is allowed. +- Archiving to tapes takes some time. -#### Archive a bucket with retention lock +### Archive a bucket with retention lock (WORM Compliance) By default, an archive is not locked i.e you can still delete an archive after it has been written to tapes. To ensure your archive follows the WORM (Write Once Read Many) model, you can set a retention period in your intelligent tiering configuration using the `OVH_ARCHIVE_LOCK` access tier and a number of days. The archive will be then locked until the current date + the number of days specified. @@ -113,7 +114,7 @@ By default, an archive is not locked i.e you can still delete an archive after i > Similarly, you cannot have multiple access tiers in your intelligent tiering configuration i.e either you use the `OVH_ARCHIVE` access tier or you use the `OVH_ARCHIVE_LOCK` access tier but not both. > -#### Lock a bucket after it is archived +### Lock an Already Archived Bucket If you have buckets that have been previously archived without using the `OVH_ARCHIVE_LOCK` access tier, you can still lock them by re-applying an intelligent tiering configuration to your bucket using the `OVH_ARCHIVE_LOCK` access tier and specifying a retention duration in days. @@ -135,30 +136,49 @@ If you want to edit the retention period, similarly, re-apply the intelligent ti > - OVHcloud Cold Archive will return an error because 2024-02-23 + 5 days < 2024-03-03. > -### Bucket restoring - -Restore a bucket: +### Restore a Bucket -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-restore <bucket_name> -``` +> [!tabs] +> Via the AWS S3api +>> Restore a bucket : +>> +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-restore <bucket_name> +>> ``` +>> +> Via the OVHcloud Control Panel +>> Click on the `three dots`{.action}, then select `Restore`{.action}. +>> +>> {.thumbnail} +>> -After this request, the bucket is not restored yet.<br> -It will take some time before it is restored and for the objects to be accessible in read-only (writing objects is forbidden). +- Bucket status changes to Restoring. +- Objects become accessible in read-only mode once restoration completes. -### Bucket deletion +### Delete an Archive > [!primary] > -> If you have locked your archive, trying to delete it before the end of the retention period will result in a 400 Bad Request error: +> If the bucket is locked, deletion before the retention period expires will fail. > `An error occurred (BadRequest) when calling the DeleteBucketIntelligentTieringConfiguration operation: Archive deletion is locked until 2124-01-19T15:24:56.000Z` > Delete an intelligent-tiering configuration and objects of a bucket: -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net delete-ovh-archive <bucket_name> -``` + +> [!tabs] +> Via the AWS S3api +>> Delete an Intelligent-Tiering configuration and the objects in a bucket: +>> +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net delete-ovh-archive <bucket_name> +>> ``` +>> +> Via the OVHcloud Control Panel +>> Click on the `three dots`{.action}, then select `Delete`{.action}. +>> +>> {.thumbnail} +>> After this request, the objects of the bucket are not deleted yet as the deletion is done asynchronously.<br> The operation will delete everything (on tapes and all objects if restored) and the bucket status will be in a "Deleting" status.<br> @@ -180,34 +200,43 @@ Once the deletion is completed: aws s3 rb s3://<bucket_name> ``` -### Bucket status +### Check Bucket Status and Retention Tags + +> [!tabs] +> Via the AWS S3api +>> Once an intelligent-tiering configuration has been pushed (via a `put-bucket-intelligent-tiering-configuration` operation) and until it is removed (via a `delete-bucket-intelligent-tiering-configuration` operation), the status of a bucket is readable through: +>> +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net >> s3api get-bucket-tagging --bucket <bucket_name> +>> ``` +>> +>> If you have locked your archive, you can check the retention period using the `get-bucket-tagging command`. +>> +>> - Example: +>> +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name> +>> +>> { +>> "TagSet": [ +>> { +>> "Key": "ovh:intelligent_tiering_status", +>> "Value": "Archived" +>> }, +>> { +>> "Key": "ovh:intelligent_tiering_archive_lock_until", +>> "Value": "2124-01-19T15:24:56.000Z" +>> } +>> ] +>> } +>> ``` +>> +> Via the OVHcloud Control Panel +>> You can check the status of your bucket by looking at the value in the `Status` column, as well as its retention period in the `Locked until` column. +>> +>> {.thumbnail} +>> -Once an intelligent-tiering configuration has been pushed (via a `put-bucket-intelligent-tiering-configuration` operation) and until it is removed (via a `delete-bucket-intelligent-tiering-configuration` operation), the status of a bucket is readable through: - -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name> -``` - -If you have locked your archive, you can check the retention period using the `get-bucket-tagging command`. - -- Example: - -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name> - -{ - "TagSet": [ - { - "Key": "ovh:intelligent_tiering_status", - "Value": "Archived" - }, - { - "Key": "ovh:intelligent_tiering_archive_lock_until", - "Value": "2124-01-19T15:24:56.000Z" - } - ] -} -``` #### List of bucket statuses @@ -221,8 +250,20 @@ aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagg | `Deleting` | Objects deletion from tapes (and disks if restored) in progress. | Listing | | `Flushed` | Bucket is empty and can safely be removed. | Listing (empty bucket) | +### Advanced Verification: Inspect Intelligent Tiering Configuration + +To retrieve the full intelligent-tiering configuration JSON applied to your bucket: + +```bash +aws s3api get-bucket-intelligent-tiering-configuration --bucket <bucket_name> --id myid +``` + +This command returns detailed configuration info useful for debugging or verification. + ## Go further +Check out our dedicated Discord channel: <https://discord.gg/ovhcloud>. Ask questions, share feedback, and interact directly with the team behind our storage and backup services. + If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for assisting you on your specific use case of your project. Join our [community of users](/links/community). diff --git a/pages/storage_and_backup/object_storage/cold_archive_getting_started/guide.fr-fr.md b/pages/storage_and_backup/object_storage/cold_archive_getting_started/guide.fr-fr.md index 70ce74a3db7..c591cc0dcba 100644 --- a/pages/storage_and_backup/object_storage/cold_archive_getting_started/guide.fr-fr.md +++ b/pages/storage_and_backup/object_storage/cold_archive_getting_started/guide.fr-fr.md @@ -1,16 +1,15 @@ --- title: Cold Archive - Premiers pas avec Cold Archive excerpt: Ce guide vous montre comment gérer vos données avec Cold Archive -updated: 2024-11-29 +updated: 2025-07-04 --- ## Objectif -Cold Archive est un service de stockage de données à long terme. -Lorsqu'ils sont archivés, tous les objets d'un bucket sont stockés sur des bandes physiques. -La restauration peut prendre un certain temps car elle doit être lue sur des bandes. +Cold Archive fournit un stockage de données à long terme en archivant des objets de type « bucket » sur des bandes physiques. +La restauration peut prendre un certain temps car les données sont lues à partir des bandes. -**Ce guide explique comment configurer le stockage sur bandes avec Cold Archive.** +**Ce guide explique comment configurer et gérer le stockage sur bandes avec Cold Archive, en coexistence avec votre système de stockage d'objets.** ## Prérequis @@ -19,8 +18,19 @@ La restauration peut prendre un certain temps car elle doit être lue sur des ba ## En pratique +> [!primary] +> +> Vous pouvez retrouver la présentation du stockage Cold Archive ainsi que son workflow [ici](/pages/storage_and_backup/object_storage/cold_archive_overview). +> + +Cette section explique la procédure étape par étape pour configurer, archiver, restaurer et supprimer des buckets avec Cold Archive, en coexistence avec votre stockage d'objets. + Dans ce guide, les **alias awscli** sont utilisés pour simplifier les commandes. +### Configuration initiale : créer des alias AWS CLI + +Pour simplifier les commandes, créez ou éditez le fichier ~/.aws/cli/alias : + ```bash mkdir -p ~/.aws/cli touch ~/.aws/cli/alias @@ -44,57 +54,48 @@ delete-ovh-archive = s3api delete-bucket-intelligent-tiering-configuration --id > > - `Id` est une chaîne utilisée pour identifier la configuration de l'Intelligent-Tiering S3 **\***. Sa valeur est arbitraire et vous pouvez la modifier. Elle sera nécessaire pour les opérations ultérieures PUT, GET et DELETE sur la configuration de l'Intelligent-Tiering. > -> - `Status` et `Days` sont obligatoires mais non utilisés. +> - `Status` et `Days` sont obligatoires mais non utilisés. Les jours ne sont significatifs que pour certains niveaux d'accès. > -Pour récupérer une configuration de Intelligent-Tiering, utilisez la commande get-bucket-intelligent-tiering-configuration : +### Vérifier les téléchargements multipartites incomplets avant l'archivage + +Exécutez cette commande pour vous assurer qu'il n'y a pas d'uploads multipart incomplets sur votre bucket : ```bash -aws s3api get-bucket-intelligent-tiering-configuration --bucket example-bucket --id myid +aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api list-multipart-uploads --bucket <nom_du_bucket> ``` -```json -{ - "Id": "myid", - "Status": "Enabled", - "Tierings": [ - {"Days": 999, "AccessTier": "OVH_ARCHIVE"} - ] -} -``` +### **Archiver un Bucket** > [!primary] > -> Si vous avez défini plusieurs profils, ajoutez `--profile <profile>` à la ligne de commande. +> Avant d'archiver un panier, assurez-vous qu'il n'y a pas de téléchargements multipartites incomplets. > -### Archiver un bucket +> [!tabs] +> Via l'AWS S3api +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-archive <bucket_name> +>> ``` +>> +> Via l'espace client OVHcloud +>> Cliquez sur les `trois petits points`{.action}, puis sur `Archiver`{.action}. +>> +>> {.thumbnail} +>> -Avant d'archiver un bucket, il est nécessaire de s'assurer qu'il n'y a pas de parts de MPU non complétées. -Cela peut se faire avec la commande : +- Le statut du bucket passe à Archivage. +- Il n'est pas possible de lire ou d'écrire des objets au cours de ce processus ; seule l'énumération est autorisée. +- L'archivage sur bandes prend un certain temps. -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api list-multipart-uploads --bucket <bucket_name> -``` +### Archivage d'un bucket avec verrouillage de la rétention (conformité WORM) -#### Archiver un bucket - -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-archive <bucket_name> -``` - -Après cette requête, le bucket n'est pas encore archivé.<br> -L'archivage sur les bandes prendra un certain temps.<br> -A partir de cette commande et jusqu'à une restauration, le bucket ne peut accepter aucune requête de lecture ou d'écriture sur les objets (lister les objets est toujours autorisé). - -#### Archiver un bucket avec un verrou de rétention - -Par défaut, une archive n'est pas verrouillée, c'est-à-dire que vous pouvez toujours la supprimer après l'avoir écrite sur bandes magnétiques. Pour que votre archivage suive le modèle WORM (Write Once Read Many), vous pouvez définir une période de rétention dans votre configuration du intelligent tiering à l'aide du niveau d'accès `OVH_ARCHIVE_LOCK` et d'un nombre de jours. L'archive sera alors verrouillée jusqu'à la date du jour + le nombre de jours spécifié. +Par défaut, une archive n'est pas verrouillée, c'est-à-dire que vous pouvez toujours supprimer une archive après qu'elle ait été écrite sur des bandes. Pour vous assurer que votre archive suit le modèle WORM (Write Once Read Many), vous pouvez définir une période de rétention dans votre configuration de hiérarchisation intelligente en utilisant le niveau d'accès `OVH_ARCHIVE_LOCK` et un nombre de jours. L'archive sera alors verrouillée jusqu'à la date actuelle + le nombre de jours spécifié. > [!primary] > > Avec le niveau d'accès par défaut `OVH_ARCHIVE`, l'attribut `Days` n'a aucun effet. -> Contrairement à la configuration précédente du intelligent tiering, en utilisant le niveau d'accès `OVH_ARCHIVE_LOCK`, l'attribut `Days` sera pris en compte dans le calcul de la durée du verrouillage et doit être un entier positif. +> Contrairement à la configuration précédente, en utilisant le niveau d'accès `OVH_ARCHIVE_LOCK`, l'attribut `Days` sera pris en compte dans le calcul de la durée du verrou et doit être un nombre entier positif. > ```json @@ -109,117 +110,151 @@ Par défaut, une archive n'est pas verrouillée, c'est-à-dire que vous pouvez t > [!primary] > -> Vous ne pouvez pas avoir plusieurs configurations d'intelligent tiering sur votre archive. -> De même, vous ne pouvez pas avoir plusieurs niveaux d'accès dans votre configuration de intelligent tiering, c'est-à-dire que vous devez utiliser le niveau d'accès `OVH_ARCHIVE` ou le niveau d'accès `OVH_ARCHIVE_LOCK` mais pas les deux. +> Vous ne pouvez pas avoir plusieurs configurations de hiérarchisation intelligente sur votre archive. +> De même, vous ne pouvez pas avoir plusieurs niveaux d'accès dans votre configuration de hiérarchisation intelligente, c'est-à-dire que vous utilisez soit le niveau d'accès `OVH_ARCHIVE`, soit le niveau d'accès `OVH_ARCHIVE_LOCK`, mais pas les deux. > -#### Verrouiller un bucket après son archivage +### Verrouiller un panier déjà archivé -Si vous avez des buckets qui ont été précédemment archivés sans utiliser le niveau d'accès `OVH_ARCHIVE_LOCK`, vous pouvez toujours les verrouiller en réappliquant une configuration du intelligent tiering à votre bucket à l'aide du niveau d'accès `OVH_ARCHIVE_LOCK` et en spécifiant une durée de rétention en jours. +Si vous avez des buckets qui ont été précédemment archivés sans utiliser le niveau d'accès `OVH_ARCHIVE_LOCK`, vous pouvez toujours les verrouiller en réappliquant une configuration de hiérarchisation intelligente à votre bucket en utilisant le niveau d'accès `OVH_ARCHIVE_LOCK` et en spécifiant une durée de rétention en jours. > [!primary] > -> Pour verrouiller un bucket déjà archivé, il doit avoir le statut « Archived » ou « Restored ». -> Vous devez également utiliser le même « Id » de configuration d'intelligent tiering. +> Pour verrouiller un panier déjà archivé, il doit être dans l'état "Archivé" ou "Restauré". +> Vous devez également utiliser la même configuration de hiérarchisation intelligente "Id". > -De même, si vous souhaitez modifier la période de rétention, réappliquez la configuration du intelligent tiering en utilisant le même « Id ». +Si vous souhaitez modifier le délai de conservation, appliquez à nouveau la configuration de l'étagement intelligent en utilisant le même "Id". > [!primary] > -> Vous ne pouvez pas réduire une période de rétention préalablement définie, c'est-à-dire que la nouvelle période de rétention (date actuelle + nombre de jours) doit être supérieure à la période de rétention précédente. +> Vous ne pouvez pas réduire un délai de conservation précédemment défini, c'est-à-dire que le nouveau délai de conservation (date actuelle + nombre de jours) doit être supérieur au délai de conservation précédent. > Exemple : > -> - Le 22/02/2024 vous avez mis en place un verrou de 10 jours, la période de rétention sera jusqu'au 03/03/2024. -> - Le 23/02/2024, vous changez d'avis et décidez de régler la durée du verrouillage sur 5 jours. -> - OVHcloud Cold Archive retournera une erreur car 23/02/2024 + 5 jours < 03/03/2024. +> - Le 2024-02-22, vous avez mis en place un verrou de 10 jours, la période de rétention sera jusqu'au 2024-03-03. +> - Le 2024-02-23, vous changez d'avis et décidez de fixer la durée du verrouillage à 5 jours. +> OVHcloud Cold Archive retournera une erreur car 2024-02-23 + 5 jours < 2024-03-03. > -### Restauration d'un bucket - -Restaurer un bucket: +### Restorer un Bucket -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-restore <bucket_name> -``` +> [!tabs] +> Via l'AWS S3api +>> Restauration d'un bucket : +>> +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net put-ovh-restore <nom_du_bucket> +>> ``` +>> +> Via l'espace client OVHcloud +>> Cliquez sur les `trois petits points`{.action}, puis sur `Restaurer`{.action}. +>> +>> {.thumbnail} +>> -Après cette requête, le bucket n'est pas encore restauré.<br> -La restauration prendra du temps et l'accès aux objets sera en lecture seule (l'écriture est interdite). +- Le statut du bucket passe à Restauration. +- Les objets deviennent accessibles en mode lecture seule une fois la restauration terminée. -### Supression d'un bucket +### Supprimer une archive > [!primary] > -> Si vous avez verrouillé votre archive, toute tentative de suppression avant la fin de la période de rétention entraînera une erreur 400 Bad Request : -> `An error occurred (BadRequest) when calling the DeleteBucketIntelligentTieringConfiguration operation: Archive deletion is locked until 2124-01-19T15:24:56.000Z` +> Si le bucket est verrouillé, la suppression avant l'expiration de la période de rétention échouera. +> `Une erreur s'est produite (BadRequest) lors de l'appel de l'opération DeleteBucketIntelligentTieringConfiguration : La suppression de l'archive est bloquée jusqu'au 2124-01-19T15:24:56.000Z` > -Supprimer la configuration Intelligent-Tiering et les objets d'un bucket: - -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net delete-ovh-archive <bucket_name> -``` +> [!tabs] +> Via l'AWS S3api +>> Supprime une configuration d'Intelligent-Tiering et les objets d'un bucket : +>> +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net delete-ovh-archive <bucket_name> +>> ``` +>> +> Via l'espace client OVHcloud +>> Cliquez sur les `trois petits points`{.action}, puis sur `Supprimer`{.action}. +>> +>> {.thumbnail} +>> Après cette requête, les objets du bucket ne sont pas encore supprimés car la suppression est effectuée de manière asynchrone.<br> -L'opération supprimera tout (sur les bandes et tous les objets s'ils sont restaurés) et l'état du bucket sera en état `Deleting`.<br> +L'opération supprimera tout (sur les bandes et tous les objets s'ils sont restaurés) et le statut du bucket sera dans un statut "Deleting".<br> > [!primary] > -> Bien que la suppression des données soit effectuée de manière asynchrone, vous ne serez plus facturé à partir du moment où vous aurez demandé cette suppression.<br> -> La suppression est effectuée sur la base du *best effort* et il n'y a pas de durée d'engagement pour finir le traitement.<br> -> Dans l'état `Deleting`, le bucket est verrouillé et ne sera accessible uniquement qu'à la fin du traitement.<br> +> Bien que la suppression des données soit effectuée de manière asynchrone, la facturation est arrêtée dès que vous soumettez la demande!<br> +> La suppression est effectuée sur la base du meilleur effort et il n'y a pas de durée engagée.<br> +> Dans l'état "Deleting", le bucket est verrouillé et n'est pas accessible.<br> > -Une fois la suppression effectuée : +Une fois la suppression terminée : -- Le statut du compartiment sera "Flushed". -- Dans cet état, le bucket existe toujours (mais est vide et ne contient aucun objet) et les données ont été supprimées des bandes. -- Le bucket peut être débloqué et vous pouvez retirer votre bucket : +- L'état du bucket sera "Flushed". +- Dans cet état, le bucket existe toujours (mais il est vide et ne contient aucun objet) et les données ont été retirées des bandes. +- Le bucket peut être libéré et vous pouvez supprimer votre bucket : ```bash -aws s3 rb s3://<bucket_name> +aws s3 rb s3://<nom_du_bucket> ``` -### Statut d'un bucket - -Une fois qu'une configuration Intelligent-Tiering a été poussée (via une opération `put-bucket-intelligent-tiering-configuration`) et jusqu'à ce qu'elle soit retirée (via une opération `delete-bucket-intelligent-tiering-configuration`), l'état d'un bucket peut être lu via : +### Vérifier l'état des buckets et les étiquettes de rétention + +> [!tabs] +> Via l'AWS S3api +>> Une fois qu'une configuration d'Intelligent-tiering a été poussée (via l'opération `put-bucket-intelligent-tiering-configuration`) et jusqu'à ce qu'elle soit supprimée (via l'opération `delete-bucket-intelligent-tiering-configuration`), le statut d'un bucket est lisible à travers : +>> +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name> +>> ``` +>> +>> Si vous avez verrouillé votre archive, vous pouvez vérifier la période de rétention en utilisant la commande `get-bucket-tagging`. +>> +>> - Exemple: +>> +>> ```bash +>> aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name> +>> +>> { +>> "TagSet": [ +>> { +>> "Key": "ovh:intelligent_tiering_status", +>> "Value": "Archived" +>> }, +>> { +>> "Key": "ovh:intelligent_tiering_archive_lock_until", +>> "Value": "2124-01-19T15:24:56.000Z" +>> } +>> ] +>> } <> +>> ``` +>> +> Via l'espace client OVHcloud +>> Vous pouvez consulter le statut de votre bucket en regardant la valeur dans la colonne `Statut` ainsi que sa durée de rétention dans la colonne `Vérouillé jusqu'au` : +>> +>> {.thumbnail} +>> + +#### Liste des statuts des buckets + +| Statut | Description | Permissions sur les objets | +|-------------|----------------------------------------------------------------------------------|------------------------| +| `None` | Aucune configuration Intelligent-Tiering n'a encore été poussée sur le bucket. | Tous | +| `Archiving` | Archivage en cours sur les bandes. | Listing | +| `Archived` | Objets archivés sur bandes uniquement. | Listing | +| `Restoring` | Restauration en cours à partir des bandes. | Listing | +| `Restored` | Objets restaurés et accessibles. | Lecture seule + Listing | +| `Deleting` | Suppression d'objets des bandes (et des disques si restaurés) en cours. | +| `Flushed` | Le bac est vide et peut être supprimé en toute sécurité. | Listing (bucket vide) | + +### Vérification avancée : Inspecter la configuration d'Intelligent Tiering + +Pour récupérer la configuration complète de l’Intelligent-Tiering appliquée à votre bucket : ```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name> -``` - -Si vous avez verrouillé votre archive, vous pouvez vérifier la période de rétention à l'aide de la commande `get-bucket-tagging`. - -- Exemple : - -```bash -aws --endpoint-url https://s3.rbx-archive.io.cloud.ovh.net s3api get-bucket-tagging --bucket <bucket_name> - -{ - "TagSet": [ - { - "Key": "ovh:intelligent_tiering_status", - "Value": "Archived" - }, - { - "Key": "ovh:intelligent_tiering_archive_lock_until", - "Value": "2124-01-19T15:24:56.000Z" - } - ] -} +aws s3api get-bucket-intelligent-tiering-configuration --bucket <bucket_name> --id myid ``` -#### Liste des statuts d'un bucket - -| État de l'archive (= bucket) | Description | Autorisations d'objets | -| --- | --- | --- | -| **`None`** | Aucune configuration Intelligent-Tiering n'a encore été appliquée au bucket. | Tous | -| **`Archiving`** | Archivage en cours sur bandes. | Liste | -| **`Archived`** | Objets archivés sur bandes uniquement. | Liste | -| **`Restoring`** | Restauration en cours à partir des bandes. | Liste | -| **`Restored`** | Objets restaurés et accessibles. | Lecture seule + Liste | -| **`Deleting`** | Suppression des objets des bandes (et des disques si restaurés) en cours. | Liste | -| **`Flushed`** | Le bucket est vide et peut être retiré en toute sécurité. | Liste (bucket vide) | +Cette commande renvoie les détails complets de la configuration, utiles pour la vérification ou le débogage. ## Aller plus loin diff --git a/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_01.png b/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_01.png new file mode 100644 index 00000000000..f3418957803 Binary files /dev/null and b/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_01.png differ diff --git a/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_02.png b/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_02.png new file mode 100644 index 00000000000..4280d049039 Binary files /dev/null and b/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_02.png differ diff --git a/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_03.png b/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_03.png new file mode 100644 index 00000000000..9303dc44652 Binary files /dev/null and b/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_03.png differ diff --git a/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_04.png b/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_04.png new file mode 100644 index 00000000000..3a8f1fe885b Binary files /dev/null and b/pages/storage_and_backup/object_storage/cold_archive_getting_started/images/cold_archive_04.png differ