Object Storage - Premiers pas avec la gestion de versions

Objectif

Ce guide explique comment activer et gérer la gestion de versions pour vos buckets de stockage d'objets OVHcloud en utilisant les API.

Prérequis

• Un projet Public Cloud dans votre compte OVHcloud
• Etre connecté à l'espace client OVHcloud
• Un utilisateur Object Storage déjà créé
• AWS CLI installé et configuré

En pratique

Concept

La gestion de versions vous permet de conserver plusieurs variantes d'un objet dans le même bucket. Cette fonctionnalité aide à préserver, récupérer et restaurer chaque version de chaque objet stocké dans vos buckets, facilitant ainsi la récupération en cas d'actions involontaires des utilisateurs ou de défaillances des applications. Par défaut, la gestion de versions est désactivée sur les buckets, et vous devez l'activer explicitement.

Informations générales

Un bucket de stockage d'objets peut être dans l'un des trois états suivants :

1. Non versionné (état par défaut) : aucune version n'est conservée pour les objets.
2. Versioning activé : plusieurs versions de chaque objet sont conservées.
3. Versioning suspendu : les versions ne sont pas créées pour les nouveaux objets, mais les versions existantes sont conservées.

L'activation et la suspension du versioning se font au niveau du bucket. Une fois activé, tous les objets dans le bucket recevront un identifiant de version unique. Les objets existants auront un identifiant de version nul jusqu'à ce qu'ils soient modifiés.

Fonctionnement de la gestion de versions

La gestion de versions ajoute une couche de protection à vos données en conservant plusieurs versions d'un objet dans le même bucket. Lorsque vous activez la gestion de versions pour un bucket, chaque objet dans le bucket obtient un identifiant de version unique. Cela signifie qu'à chaque fois qu'un objet est modifié ou supprimé, une nouvelle version est créée et l'ancienne version est conservée. Cela vous permet de récupérer les versions précédentes d'un objet si nécessaire.

• Téléchargement de nouveaux objets : un identifiant de version unique est attribué à chaque objet.
• Modification des objets : un nouvel identifiant de version est généré et la version précédente est conservée.
• Suppression des objets : l'opération de suppression crée un marqueur de suppression mais ne supprime pas les versions précédentes. L'objet peut être restauré en supprimant le marqueur de suppression.

Identifiants de versions

Chaque objet a un identifiant de version unique, que le versioning soit activé ou non. Dans un bucket avec versioning activé, cet identifiant de version distingue une version des autres versions du même objet.

• Version actuelle : la version la plus récemment créée d'un objet (avec la valeur de métadonnée LastModifiedDate la plus récente).
• Versions non actuelles : versions créées précédemment (avec leurs propres identifiants de version uniques).

Lorsque le versioning n'est pas activé :

• Il n'y a pas de versions non actuelles car le stockage d'objets OVHcloud écrasera toujours la version actuelle avec la dernière version créée lorsque vous téléchargez le même objet (c'est-à-dire avec la même clé).

• Si vous supprimez un objet, il sera supprimé de manière permanente car une seule version de votre objet existe à tout moment.

Avec le versioning activé

Lorsque le versioning est activé :

• Chaque fois que vous téléchargez le même objet, une version non actuelle de l'objet est créée et la dernière version créée devient la version actuelle. Les anciennes versions sont conservées et les données sont protégées contre les suppressions accidentelles ou les défaillances des applications. Vous pouvez les récupérer à tout moment.

• Si vous supprimez un objet, par défaut, OVHcloud créera un marqueur de suppression (DM) comme nouvelle version actuelle et toutes les versions précédentes resteront. L'objet est ainsi considéré comme « supprimé » et une opération GET object sur cet objet renverra une erreur 404.

• Vous pouvez toujours télécharger ou supprimer une version spécifique d'un objet en spécifiant un identifiant de version. Veuillez noter que la suppression d'un objet en spécifiant un numéro de version est irréversible.

Comment activer le versioning

aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled

Comment suspendre la gestion des versions

aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Suspended

Gérer et accéder aux versions d’objets

Afficher les versions d'objets

Afficher les différentes versions d'un objet

Télécharger une version actuelle ou antérieure d’un objet

Suppression d’objets : suppression simple, définitive et gestion des Delete Markers

aws s3api delete-object --bucket <bucket_name> --key <object_key>

aws s3api list-object-versions --bucket <bucket_name> --prefix <object_key>

aws s3api delete-object --bucket <bucket_name> --key <object_key> --version-id <version_id>

aws s3api list-object-versions --bucket <bucket_name> --prefix <object_key> \
  --query "DeleteMarkers" --output json

aws s3api delete-object \
  --bucket <bucket_name> \
  --key <object_key> \
  --version-id <delete_marker_version_id>

Considérations importantes

• Coûts de stockage : chaque version d'un objet est stockée comme un objet complet, ce qui entraîne des coûts de stockage Object Storage - Standard.
• Application : lorsque le versioning est activé, il s'applique à tous les objets dans le bucket, y compris ceux ajoutés avant l'activation du versioning.
• Suspension : la suspension du versioning ne supprime pas les versions existantes. Elle empêche seulement la création de nouvelles versions.
• Permissions : seul le propriétaire du bucket peut activer ou suspendre le versioning.

Aller plus loin

Échangez avec notre communauté d'utilisateurs.