Skip to content

Commit 5afc5bd

Browse files
committed
Proofreading
1 parent 0fd1e6a commit 5afc5bd

File tree

2 files changed

+44
-52
lines changed

2 files changed

+44
-52
lines changed

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

Lines changed: 23 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,9 @@
11
---
22
title: 'Object Storage - Getting Started with Versioning'
33
excerpt: 'Learn how to enable and manage versioning for your OVHcloud Object Storage buckets using APIs'
4-
updated: 2024-07-08
4+
updated: 2025-07-07
55
---
66

7-
> [!primary]
8-
> This guide documents API usage only. Future updates will cover the OVHcloud Control Panel.
9-
107
## Objective
118

129
**This guide explains how to enable and manage versioning for your OVHcloud Object Storage buckets using APIs.**
@@ -90,11 +87,11 @@ When versioning is enabled:
9087
>> aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled
9188
>> ```
9289
>>
93-
>> **Explications :**
90+
>> **Explanations:**
9491
>>
95-
>> - **put-bucket-versioning :** AWS CLI command to configure version management.
96-
>> - **--bucket my-bucket :** replace `my-bucket` with the name of your bucket.
97-
>> - **--versioning-configuration Status=Enabled :** enable versioning for the specified bucket.
92+
>> - `put-bucket-versioning`: AWS CLI command to configure version management.
93+
>> - `--bucket my-bucket`: replace `my-bucket` with the name of your bucket.
94+
>> - `--versioning-configuration Status=Enabled`: enable versioning for the specified bucket.
9895
>>
9996
>> 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.
10097
>>
@@ -118,13 +115,13 @@ When versioning is enabled:
118115
>>
119116
>> ```sh
120117
>> aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Suspended
121-
>> ````
118+
>> ```
122119
>>
123120
>> **Explanations:**
124121
>>
125-
>> - **put-bucket-versioning :** AWS CLI command to configure versioning.
126-
>> - **--bucket my-bucket :** replace `my-bucket` with the name of your bucket.
127-
>> - **--versioning-configuration Status=Suspended :** suspend versioning for the specified bucket.
122+
>> - `put-bucket-versioning`: AWS CLI command to configure versioning.
123+
>> - `--bucket my-bucket`: replace `my-bucket` with the name of your bucket.
124+
>> - `--versioning-configuration Status=Suspended`: suspend versioning for the specified bucket.
128125
>>
129126
>> 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.
130127
>>
@@ -135,54 +132,53 @@ When versioning is enabled:
135132
136133
> [!tabs]
137134
> Via the OVHcloud Control Panel
138-
>> You can show or hide object versions in an Object Storage bucket by `clicking`{.action} on the following button:
135+
>> You can show or hide object versions in an Object Storage bucket by clicking on the following button:
139136
>>
140-
>> [enable version objects](images/bucket_enable_versions.png)
137+
>> [enable version objects](images/bucket_enable_versions.png){.thumbnail}
141138
>>
142139
143140
#### View the different versions of an object
144141
145142
> ![tabs]
146143
> Via the OVHcloud Control Panel
147-
>> 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:
144+
>> To view the different versions of an object, click directly on the object concerned. You'll be redirected to a page detailing the information and versions available for this object:
148145
>>
149-
>> ![information versions object](images/bucket_versions_object_details.png)
146+
>> ![information versions object](images/bucket_versions_object_details.png){.thumbnail}
150147
>>
151148
152149
#### Download a current or previous version of an object
153150
154151
> [!tabs]
155152
> Via the OVHcloud Control Panel
156-
>> 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}.
153+
>> 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 clickin the `...`{.action} button, then on `Download`{.action}.
157154
>>
158-
>> ![download current or versioned objects](images/bucket_download_versions.png)
155+
>> ![download current or versioned objects](images/bucket_download_versions.png){.thumbnail}
159156
>>
160157
161158
### Object deletion: simple, permanent deletion and Delete Marker management
162159
163160
> [!primary]
164161
>
165-
> If versioning is enabled on your S3 bucket, deleting an object adds a Delete Marker: the object disappears from the default view, but remains visible via the View versions option.
162+
> If versioning is enabled on your S3 bucket, deleting an object adds a Delete Marker: the object disappears from the default view, but remains visible via the `View versions`{.action} option.
166163
>
167164
> This protection allows you to restore an object deleted by mistake.
168165
>
169166
170167
> [!tabs]
171-
> Via the OVHcloud customer area
172-
>> From the main page of your Object Storage bucket, or from the object details page, you can delete your object by clicking on `delete`{.action}.
173-
>>
174-
>> ![delete current or versioned objects](images/bucket_delete_object_versions.png)
168+
> Via the OVHcloud Control Panel
169+
>> From the main page of your Object Storage bucket, or from the object details page, you can delete your object by clicking on `Delete`{.action}.
175170
>>
171+
>> ![delete current or versioned objects](images/bucket_delete_object_versions.png){.thumbnail}
176172
>>
177-
>> To delete a version definitively, click on the `three dots`{.action}, then on `Delete`{.action}, and confirm the definitive deletion action.
173+
>> To delete a version permanently, click the `...`{.action} button, then on `Delete`{.action}, and confirm the definitive deletion action.
178174
>>
179175
>>
180176
> Via the AWS CLI
181177
>> To delete an object, use the following command:
182178
>>
183179
>> ```bash
184180
>> aws s3api delete-object --bucket <bucket> --key <objet>
185-
>> ````
181+
>> ```
186182
>>
187183
>> If you want to see the different versions of an object, use the following command:
188184
>>
@@ -200,11 +196,10 @@ When versioning is enabled:
200196
>>
201197
>> - List delete markers and identify the version-id of the delete marker:
202198
>>
203-
>>
204199
>> ```bash
205200
>> aws s3api list-object-versions --bucket my-bucket --prefix my-object. txt \
206201
>> --query "DeleteMarkers" --output json
207-
>> ````
202+
>> ```
208203
>>
209204
>> - Delete this delete marker:
210205
>>
@@ -213,7 +208,7 @@ When versioning is enabled:
213208
>> --bucket my-bucket \
214209
>> --key my-object.txt \
215210
>> --version-id <delete-marker-version-id>
216-
>> ````
211+
>> ```
217212
>>
218213
219214
### Important Considerations

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

Lines changed: 21 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,9 @@
11
---
22
title: "Object Storage - Premiers pas avec la gestion de versions"
33
excerpt: "Découvrez comment activer et gérer la gestion de versions pour vos buckets de stockage d'objets OVHcloud en utilisant les API"
4-
updated: 2024-07-08
4+
updated: 2025-07-07
55
---
66

7-
> [!primary]
8-
> Ce guide documente l'utilisation via l'API. Les futures mises à jour de ce guide détailleront le fonctionnement via l'espace client OVHcloud.
9-
107
## Objectif
118

129
**Ce guide explique comment activer et gérer la gestion de versions pour vos buckets de stockage d'objets OVHcloud en utilisant les API.**
@@ -92,20 +89,20 @@ Lorsque le versioning est activé :
9289
>>
9390
>> **Explications :**
9491
>>
95-
>> - **put-bucket-versioning :** commande AWS CLI pour configurer la gestion des versions.
96-
>> - **--bucket my-bucket :** remplacez `my-bucket` par le nom de votre bucket.
97-
>> - **--versioning-configuration Status=Enabled :** active la gestion des versions pour le bucket spécifié.
92+
>> - `put-bucket-versioning` : commande AWS CLI pour configurer la gestion des versions.
93+
>> - `--bucket my-bucket` : remplacez `my-bucket` par le nom de votre bucket.
94+
>> - `--versioning-configuration Status=Enabled` : active la gestion des versions pour le bucket spécifié.
9895
>>
9996
>> 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.
10097
>>
10198
> Via l'espace client OVHcloud
10299
>> Pour activer le versioning sur un bucket Object Storage, deux possibilités s’offrent à vous :
103100
>>
104-
>> Lors de la création du bucket, activez simplement l’option de versioning dans l'étape associée:
101+
>> - Lors de la création du bucket, activez simplement l’option de versioning dans l'étape associée :
105102
>>
106103
>> ![OVHcloud control panel - versioning in bucket creation](images/bucket_creation_versioning.png){.thumbnail}
107104
>>
108-
>> Sur un bucket existant, en modifiant ses paramètres via le tableau de bord OVHcloud.
105+
>> - Sur un bucket existant, en modifiant ses paramètres via le tableau de bord OVHcloud :
109106
>>
110107
>> ![OVHcloud control panel - versioning in bucket modification](images/bucket_modification_versioning.png){.thumbnail}
111108
>>
@@ -123,9 +120,9 @@ Lorsque le versioning est activé :
123120
>>
124121
>> **Explications :**
125122
>>
126-
>> - **put-bucket-versioning :** commande AWS CLI pour configurer le versioning.
127-
>> - **--bucket my-bucket :** remplacez `my-bucket` par le nom de votre bucket.
128-
>> - **--versioning-configuration Status=Suspended :** suspend le versioning pour le bucket spécifié.
123+
>> - `put-bucket-versioning` : commande AWS CLI pour configurer le versioning.
124+
>> - `--bucket my-bucket` : remplacez `my-bucket` par le nom de votre bucket.
125+
>> - `--versioning-configuration Status=Suspended` : suspend le versioning pour le bucket spécifié.
129126
>>
130127
>> 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é.
131128
>>
@@ -136,46 +133,46 @@ Lorsque le versioning est activé :
136133
137134
> [!tabs]
138135
> Via l'espace client OVHcloud
139-
>> Vous pouvez afficher ou masquer les versions des objets dans un bucket Object Storage en `cliquant`{.action} sur le bouton suivant :
136+
>> Vous pouvez afficher ou masquer les versions des objets dans un bucket Object Storage en cliquant sur le bouton suivant :
140137
>>
141-
>> ![enable version objects](images/bucket_enable_versions.png)
138+
>> ![enable version objects](images/bucket_enable_versions.png){.thumbnail}
142139
>>
143140
144141
#### Afficher les différentes versions d'un objet
145142
146143
> ![tabs]
147144
> Via l'espace client OVHcloud
148-
>> 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 :
145+
>> Pour consulter les différentes versions d’un objet, cliquez directement sur l’objet concerné. Vous serez redirigé vers une page détaillant les informations et versions disponibles pour cet objet :
149146
>>
150-
>> ![informations versions object](images/bucket_versions_object_details.png)
147+
>> ![informations versions object](images/bucket_versions_object_details.png){.thumbnail}
151148
>>
152149
153150
#### Télécharger une version actuelle ou antérieure d’un objet
154151
155152
> [!tabs]
156153
> Via l'espace client OVHcloud
157-
>> 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}.
154+
>> 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 sur le bouton `...`{.action}, puis sur `Télécharger`{.action}.
158155
>>
159-
>> ![download current or versioned objects](images/bucket_download_versions.png)
156+
>> ![download current or versioned objects](images/bucket_download_versions.png){.thumbnail}
160157
>>
161158
162159
### Suppression d’objets : suppression simple, définitive et gestion des Delete Markers
163160
164161
> [!primary]
165162
>
166-
> Si le versioning est activé sur votre bucket S3, la suppression d’un objet ajoute un Delete Marker : l’objet disparaît de la vue par défaut, mais reste visible via l’option Voir les versions.
163+
> Si le versioning est activé sur votre bucket S3, la suppression d’un objet ajoute un Delete Marker : l’objet disparaît de la vue par défaut, mais reste visible via l’option `Voir les versions`{.action}.
167164
>
168165
> Cette protection permet de restaurer un objet supprimé par erreur.
169166
>
170167
171168
> [!tabs]
172169
> Via l'espace client OVHcloud
173-
>> Depuis la page principale de votre bucket Object Storage ou depuis la page de détails d’un objet, vous pouvez supprimer votre objet en cliquant sur `supprimer`{.action}.
170+
>> Depuis la page principale de votre bucket Object Storage ou depuis la page de détails d’un objet, vous pouvez supprimer votre objet en cliquant sur `Supprimer`{.action}.
174171
>>
175172
>> ![delete current or versioned objects](images/bucket_delete_object_versions.png)
176173
>>
177174
>>
178-
>> Pour supprimer définitivement une version, cliquez sur les `trois points`{.action}, puis sur `Supprimer`{.action}, et confirmez l’action de suppression définitive.
175+
>> Pour supprimer définitivement une version, cliquez sur le bouton `...`{.action} puis sur `Supprimer`{.action}, et confirmez l’action de suppression définitive.
179176
>>
180177
>>
181178
> Via l'AWS CLI
@@ -197,17 +194,17 @@ Lorsque le versioning est activé :
197194
>> aws s3api list-object-versions --bucket <bucket> --prefix <objet>
198195
>> ```
199196
>>
200-
>> Si vous souhiatez supprimer une étiquette `delete marker` pour récuperer votre version d'objet, procédez comme suit :
197+
>> Si vous souhaitez supprimer une étiquette `delete marker` pour récuperer votre version d'objet, procédez comme suit :
201198
>>
202-
>> - Lister les delete markers et identifier le version-id du delete marker.:
199+
>> - Listez les delete markers et identifiez le version-id du delete marker :
203200
>>
204201
>>
205202
>> ```bash
206203
>> aws s3api list-object-versions --bucket my-bucket --prefix my-object.txt \
207204
>> --query "DeleteMarkers" --output json
208205
>> ```
209206
>>
210-
>> - Supprimer ce delete marker :
207+
>> - Supprimez ce delete marker :
211208
>>
212209
>> ```bash
213210
>> aws s3api delete-object \

0 commit comments

Comments
 (0)