Skip to content

Commit 60bbf3f

Browse files
committed
feat(s3 optimize perf guide): update guide to add upload not completed part
1 parent d7e022a commit 60bbf3f

File tree

2 files changed

+52
-2
lines changed

2 files changed

+52
-2
lines changed

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

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -138,8 +138,33 @@ Where `mpu.json` is:
138138
```
139139

140140
> [!primary]
141-
> If you do not complete the multipart upload, your object will not be rebuilt and will not be visible BUT you still have to pay the storage costs of the parts.
142141
>
142+
> If a multipart upload is not completed, the final object will not be assembled and will remain invisible. Nevertheless, all uploaded parts remain stored and incur storage charges.
143+
>
144+
145+
To avoid unnecessary costs, you can abort the multipart upload using the following AWS CLI command:
146+
147+
```bash
148+
user@host:~$ aws s3api abort-multipart-upload \
149+
--bucket test-bucket \
150+
--key filename \
151+
--upload-id <upload-id>
152+
```
153+
154+
The upload ID is returned by the create-multipart-upload command or can be retrieved by listing ongoing multipart uploads:
155+
156+
```bash
157+
user@host:~$ aws s3api list-multipart-uploads --bucket my-bucket
158+
```
159+
160+
Example of aborting a specific multipart upload after retrieving its upload ID:
161+
162+
```bash
163+
user@host:~$ aws s3api abort-multipart-upload \
164+
--bucket my-bucket \
165+
--upload-id "OWZiZTA4YzUtODExZC00ZjE5LTkyMjUtZGVmNjcwNjBiYWQ1" \
166+
--key <my-file> # name or path of the object
167+
```
143168

144169
### Using other third party tools
145170

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

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,8 +143,33 @@ Où `mpu.json` est :
143143
```
144144

145145
> [!primary]
146-
> Si vous ne terminez pas le *multipart upload*, votre objet ne sera pas reconstruit et ne sera pas visible MAIS vous devrez tout de même payer les coûts de stockage des parties.
147146
>
147+
> Si le *multipart upload* n'est pas terminé, l'objet final ne sera pas assemblé et restera invisible. Néanmoins, toutes les pièces téléchargées restent stockées et entraînent des frais de stockage.
148+
>
149+
150+
Pour éviter des coûts inutiles, vous pouvez interrompre le téléchargement multipartite à l'aide de la commande CLI AWS suivante :
151+
152+
```bash
153+
user@host:~$ aws s3api abort-multipart-upload \
154+
--bucket test-bucket \
155+
--key filename \
156+
--upload-id <upload-id>
157+
```
158+
159+
L'ID du téléchargement est renvoyé par la commande create-multipart-upload ou peut être récupéré en listant les téléchargements multipartites en cours :
160+
161+
```bash
162+
user@host:~$ aws s3api list-multipart-uploads --bucket my-bucket
163+
```
164+
165+
Exemple d'interruption d'un téléchargement multipartite spécifique après avoir récupéré son ID de téléchargement :
166+
167+
```bash
168+
user@host:~$ aws s3api abort-multipart-upload \
169+
--bucket my-bucket \
170+
--upload-id "OWZiZTA4YzUtODExZC00ZjE5LTkyMjUtZGVmNjcwNjBiYWQ1" \
171+
--key <my-file> # name or path of the object
172+
```
148173

149174
### Via d'autres outils tiers
150175

0 commit comments

Comments
 (0)