Skip to content

Commit 6c4e5fd

Browse files
authored
Merge pull request #7943 from ovh/feat-improve-s3-optimizeperf
feat(s3 optimize perf guide): update guide to add upload not completed part
2 parents c09fe71 + 772882d commit 6c4e5fd

File tree

15 files changed

+405
-30
lines changed

15 files changed

+405
-30
lines changed

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

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Object Storage - Optimising Performance (EN)
33
excerpt: This guide walks you through various methods to optimise the performance of your Object Storage buckets, including using byte range fetches, multipart uploads and other methods
4-
updated: 2024-03-27
4+
updated: 2025-06-04
55
---
66

77
## Objective
@@ -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.en-asia.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Object Storage - Optimising Performance
33
excerpt: This guide walks you through various methods to optimise the performance of your Object Storage buckets, including using byte range fetches, multipart uploads and other methods
4-
updated: 2024-03-27
4+
updated: 2025-06-04
55
---
66

77
## Objective
@@ -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.en-au.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Object Storage - Optimising Performance
33
excerpt: This guide walks you through various methods to optimise the performance of your Object Storage buckets, including using byte range fetches, multipart uploads and other methods
4-
updated: 2024-03-27
4+
updated: 2025-06-04
55
---
66

77
## Objective
@@ -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.en-ca.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Object Storage - Optimising Performance
33
excerpt: This guide walks you through various methods to optimise the performance of your Object Storage buckets, including using byte range fetches, multipart uploads and other methods
4-
updated: 2024-03-27
4+
updated: 2025-06-04
55
---
66

77
## Objective
@@ -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.en-gb.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Object Storage - Optimising Performance
33
excerpt: This guide walks you through various methods to optimise the performance of your Object Storage buckets, including using byte range fetches, multipart uploads and other methods
4-
updated: 2024-03-27
4+
updated: 2025-06-04
55
---
66

77
## Objective
@@ -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.en-ie.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Object Storage - Optimising Performance
33
excerpt: This guide walks you through various methods to optimise the performance of your Object Storage buckets, including using byte range fetches, multipart uploads and other methods
4-
updated: 2024-03-27
4+
updated: 2025-06-04
55
---
66

77
## Objective
@@ -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.en-sg.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Object Storage - Optimising Performance
33
excerpt: This guide walks you through various methods to optimise the performance of your Object Storage buckets, including using byte range fetches, multipart uploads and other methods
4-
updated: 2024-03-27
4+
updated: 2025-06-04
55
---
66

77
## Objective
@@ -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.en-us.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Object Storage - Optimising Performance
33
excerpt: This guide walks you through various methods to optimise the performance of your Object Storage buckets, including using byte range fetches, multipart uploads and other methods
4-
updated: 2024-03-27
4+
updated: 2025-06-04
55
---
66

77
## Objective
@@ -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.es-es.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Object Storage - Optimising Performance (EN)
33
excerpt: This guide walks you through various methods to optimise the performance of your Object Storage buckets, including using byte range fetches, multipart uploads and other methods
4-
updated: 2024-03-27
4+
updated: 2025-06-04
55
---
66

77
## Objective
@@ -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

0 commit comments

Comments
 (0)