feat(bucket Object Storage): improve the version guide

Author: OvhValentin

pages/storage_and_backup/object_storage/s3_versioning/guide.en-gb.md

@@ -82,39 +82,81 @@ When versioning is enabled:
 
 ### How to Enable Versioning
 
-#### Using the AWS CLI
-
-To enable versioning on an Object Storage bucket, use the following command:
-
-```sh
-aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled
-```
-
-**Explanation:**
-
-- **put-bucket-versioning:** AWS CLI command to configure versioning.
-- **--bucket my-bucket:** Replace `my-bucket` with the name of your bucket.
-- **--versioning-configuration Status=Enabled:** Enables versioning for the specified bucket.
-
-After enabling versioning, all objects added to the bucket will have a unique version ID. This means that every time an object is modified or deleted, a new version is created, which can be restored if needed.
+> [!tabs]
+> Via AWS CLI
+>> To enable versioning on an Object Storage bucket, use the following command:
+>>
+>> ```sh
+>> aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled
+>> ```
+>>
+>> **Explications :**
+>>
+>> - **put-bucket-versioning :** AWS CLI command to configure version management.
+>> - **--bucket my-bucket :** replace `my-bucket` with the name of your bucket.
+>> - **--versioning-configuration Status=Enabled :** enable versioning for the specified bucket.
+>>
+>> After enabling versioning, all objects added to the bucket will have a unique version identifier. This means that each time an object is modified or deleted, a new version is created, which can be restored if necessary.
+>>
+> Via the OVHcloud Control Panel
+>> There are two ways to activate versioning on an Object Storage bucket:
+>>
+>> When creating the bucket, simply activate the versioning option in the associated step:
+>>
+>> ![OVHcloud control panel - versioning in bucket creation](images/bucket_creation_versioning.png){.thumbnail}
+>>
+>> On an existing bucket, by modifying its parameters via the OVHcloud dashboard.
+>>
+>> ![OVHcloud control panel - versioning in bucket modification](images/bucket_modification_versioning.png){.thumbnail}
+>>
 
 ### How to Suspend Versioning
 
-#### Using the AWS CLI
-
-To suspend versioning, set the versioning configuration status to `Suspended`:
-
-```sh
-aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Suspended
-```
-
-**Explanation:**
-
-- **put-bucket-versioning:** AWS CLI command to configure versioning.
-- **--bucket my-bucket:** Replace `my-bucket` with the name of your bucket.
-- **--versioning-configuration Status=Suspended:** Suspends versioning for the specified bucket.
-
-Suspending versioning stops new objects from receiving a version ID. Existing objects and their versions remain unchanged, but new objects will not have version IDs until versioning is re-enabled.
+> [!tabs]
+> Via AWS CLI
+>> To suspend versioning, set the versioning configuration status to `Suspended`:
+>>
+>> ```sh
+>> aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Suspended
+>> ````
+>>
+>> **Explanations:**
+>>
+>> - **put-bucket-versioning :** AWS CLI command to configure versioning.
+>> - **--bucket my-bucket :** replace `my-bucket` with the name of your bucket.
+>> - **--versioning-configuration Status=Suspended :** suspend versioning for the specified bucket.
+>>
+>> Suspending versioning prevents new objects from receiving a version identifier. Existing objects and their versions remain unchanged, but new objects will not have version identifiers until versioning is reactivated.
+>>
+
+### Manage and access object versions
+
+#### View object versions
+
+> [!tabs]
+> Via the OVHcloud Control Panel
+>> You can show or hide object versions in an Object Storage bucket by `clicking`{.action} on the following button:
+>>
+>> [enable version objects](images/bucket_enable_versions.png)
+>>
+
+#### View the different versions of an object
+
+> ![tabs]
+> Via the OVHcloud Control Panel
+>> To view the different versions of an object, `click`{.action} directly on the object concerned. You'll be redirected to a page detailing the information and versions available for this object:
+>>
+>> ![information versions object](images/bucket_versions_object_details.png)
+>>
+
+#### Download a current or previous version of an object
+
+> [!tabs]
+> Via the OVHcloud Control Panel
+>> From the main page of your Object Storage bucket (if version display is enabled) or from the object details page (see previous step), you can download the desired version by `clicking`{.action} on the three dots, then on `Download`{.action}.
+>>
+>> ![download current or versioned objects](images/bucket_download_versions.png)
+>>
 
 ### Important Considerations
 

pages/storage_and_backup/object_storage/s3_versioning/guide.fr-fr.md

@@ -82,39 +82,82 @@ Lorsque le versioning est activé :
 
 ### Comment activer le versioning
 
-#### Via l'AWS CLI
-
-Pour activer le versioning sur un bucket Object Storage, utilisez la commande suivante :
-
-```sh
-aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled
-```
-
-**Explications :**
-
-- **put-bucket-versioning :** commande AWS CLI pour configurer la gestion des versions.
-- **--bucket my-bucket :** remplacez `my-bucket` par le nom de votre bucket.
-- **--versioning-configuration Status=Enabled :** active la gestion des versions pour le bucket spécifié.
-
-Après avoir activé la gestion des versions, tous les objets ajoutés au bucket auront un identifiant de version unique. Cela signifie que chaque fois qu'un objet est modifié ou supprimé, une nouvelle version est créée, pouvant être restaurée si nécessaire.
+> [!tabs]
+> Via l'AWS CLI
+>> Pour activer le versioning sur un bucket Object Storage, utilisez la commande suivante :
+>>
+>> ```sh
+>> aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled
+>> ```
+>>
+>> **Explications :**
+>>
+>> - **put-bucket-versioning :** commande AWS CLI pour configurer la gestion des versions.
+>> - **--bucket my-bucket :** remplacez `my-bucket` par le nom de votre bucket.
+>> - **--versioning-configuration Status=Enabled :** active la gestion des versions pour le bucket spécifié.
+>>
+>> Après avoir activé la gestion des versions, tous les objets ajoutés au bucket auront un identifiant de version unique. Cela signifie que chaque fois qu'un objet est modifié ou supprimé, une nouvelle version est créée, pouvant être restaurée si nécessaire.
+>>
+> Via l'espace client OVHcloud
+>> Pour activer le versioning sur un bucket Object Storage, deux possibilités s’offrent à vous :
+>>
+>> Lors de la création du bucket, activez simplement l’option de versioning dans l'étape associée:
+>>
+>> ![OVHcloud control panel - versioning in bucket creation](images/bucket_creation_versioning.png){.thumbnail}
+>>
+>> Sur un bucket existant, en modifiant ses paramètres via le tableau de bord OVHcloud.
+>>
+>> ![OVHcloud control panel - versioning in bucket modification](images/bucket_modification_versioning.png){.thumbnail}
+>>
 
 ### Comment suspendre la gestion des versions
 
-#### Via l'AWS CLI
-
-Pour suspendre la gestion des versions, définissez l'état de la configuration de la gestion des versions sur `Suspended` :
-
-```sh
-aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Suspended
-```
-
-**Explications :**
-
-- **put-bucket-versioning :** commande AWS CLI pour configurer le versioning.
-- **--bucket my-bucket :** remplacez `my-bucket` par le nom de votre bucket.
-- **--versioning-configuration Status=Suspended :**  suspend le versioning pour le bucket spécifié.
-
-La suspension du versioning empêche les nouveaux objets de recevoir un identifiant de version. Les objets existants et leurs versions restent inchangés, mais les nouveaux objets n'auront pas d'identifiants de version jusqu'à ce que le versioning soit réactivé.
+> [!tabs]
+> Via l'AWS CLI
+>>
+>> Pour suspendre la gestion des versions, définissez l'état de la configuration de la gestion des versions sur `Suspended` :
+>>
+>> ```sh
+>> aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Suspended
+>> ```
+>>
+>> **Explications :**
+>>
+>> - **put-bucket-versioning :** commande AWS CLI pour configurer le versioning.
+>> - **--bucket my-bucket :** remplacez `my-bucket` par le nom de votre bucket.
+>> - **--versioning-configuration Status=Suspended :**  suspend le versioning pour le bucket spécifié.
+>>
+>> La suspension du versioning empêche les nouveaux objets de recevoir un identifiant de version. Les objets existants et leurs versions restent inchangés, mais les nouveaux objets n'auront pas d'identifiants de version jusqu'à ce que le versioning soit réactivé.
+>>
+
+### Gérer et accéder aux versions d’objets
+
+#### Afficher les versions d'objets
+
+> [!tabs]
+> Via l'espace client OVHcloud
+>> Vous pouvez afficher ou masquer les versions des objets dans un bucket Object Storage en `cliquant`{.action} sur le bouton suivant :
+>>
+>> ![enable version objects](images/bucket_enable_versions.png)
+>>
+
+#### Afficher les différentes versions d'un objet
+
+> ![tabs]
+> Via l'espace client OVHcloud
+>> Pour consulter les différentes versions d’un objet, `cliquez`{.action} directement sur l’objet concerné. Vous serez redirigé vers une page détaillant les informations et versions disponibles pour cet objet :
+>>
+>> ![informations versions object](images/bucket_versions_object_details.png)
+>>
+
+#### Télécharger une version actuelle ou antérieure d’un objet
+
+> [!tabs]
+> Via l'espace client OVHcloud
+>> Depuis la page principale de votre bucket Object Storage (si l’affichage des versions est activé) ou depuis la page de détails d’un objet (voir étape précédente), vous pouvez télécharger la version souhaitée en `cliquant`{.action} sur les trois points, puis sur `Télécharger`{.action}.
+>>
+>> ![download current or versioned objects](images/bucket_download_versions.png)
+>>
 
 ### Considérations importantes