Skip to content

Commit 7f53346

Browse files
docs(s3): update lifecycle rule & MPU documentation MTA-5049 (#3697)
* docs(s3): update lifecycle rule & MPU documentation MTA-5049 * docs(s3): update * docs(s3): update * Apply suggestions from code review Co-authored-by: nerda-codes <[email protected]> * docs(s3): update --------- Co-authored-by: nerda-codes <[email protected]>
1 parent 8266aca commit 7f53346

File tree

4 files changed

+89
-34
lines changed

4 files changed

+89
-34
lines changed

menu/navigation.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4082,6 +4082,10 @@
40824082
"label": "Manage lifecycle rules",
40834083
"slug": "manage-lifecycle-rules"
40844084
},
4085+
{
4086+
"label": "View and abort incomplete multipart uploads",
4087+
"slug": "abort-incomplete-mpu"
4088+
},
40854089
{
40864090
"label": "Monitor your consumption",
40874091
"slug": "monitor-consumption"

storage/object/api-cli/multipart-uploads.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -274,6 +274,10 @@ If the multipart upload is not completed, the parts will not be assembled and no
274274

275275
In case these parts are no longer needed, it is possible to clear them by aborting the multipart upload session.
276276

277+
<Message type="note">
278+
You can also abort incomplete multipart uploads manually using the [Scaleway console](https://console.scaleway.com/), or automatically using [lifecycle rules](/storage/object/how-to/manage-lifecycle-rules).
279+
</Message>
280+
277281
To abort an active multipart upload session, send a `DELETE` request to the platform, as follows:
278282

279283
```
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
meta:
3+
title: How to view and abort incomplete multipart uploads from the console
4+
description: Steps to view and abort incomplete multipart uploads from the Scaleway console.
5+
content:
6+
h1: How to view and abort incomplete multipart uploads from the console
7+
paragraph: Steps to view and abort incomplete multipart uploads from the Scaleway console.
8+
tags: object storage object-storage mpu multipart upload abort
9+
dates:
10+
validation: 2024-09-13
11+
posted: 2024-09-13
12+
categories:
13+
- storage
14+
- object-storage
15+
---
16+
17+
The [Scaleway console](https://console.scaleway.com/) lists your Object Storage incomplete multipart uploads to allow you to consult them and manually abort them to clear storage space and optimize your storage costs.
18+
19+
<Message type="note">
20+
Incomplete multipart uploads are charged even though they are not finished as they use storage space.
21+
</Message>
22+
23+
You can automate the process of aborting incomplete multipart uploads using [lifecycle rules](/storage/object/how-to/manage-lifecycle-rules).
24+
25+
<Macro id="requirements" />
26+
27+
- A Scaleway account logged into the [console](https://console.scaleway.com)
28+
- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
29+
- An [Object Storage bucket](/storage/object/how-to/create-a-bucket/)
30+
- At least one incomplete [multipart upload](/storage/object/api-cli/multipart-uploads/)
31+
32+
## How to view the information of an incomplete multipart upload
33+
34+
1. Click **Object Storage** in the **Storage** section of the side menu. The list of your buckets displays.
35+
2. Click the name of your bucket. The list of your objects displays.
36+
3. Click the **Incomplete MPU** tab. A list of your incomplete multipart uploads displays.
37+
4. Click <Icon name="more" /> next to the object you want to consult.
38+
5. Click **More info**. The information page of the incomplete multipart upload displays.
39+
40+
From this page, you can consult the following elements of an incomplete multipart upload:
41+
- Name
42+
- Upload ID
43+
- Creation date
44+
- Storage class
45+
- List of parts uploaded so far
46+
47+
Refer to the [dedicated documentation](/storage/object/api-cli/multipart-uploads/) for more information on how to create and manage multipart uploads.
48+
49+
## How to abort an incomplete multipart upload
50+
51+
1. Click **Object Storage** in the **Storage** section of the side menu. The list of your buckets displays.
52+
2. Click the name of your bucket. The list of your objects displays.
53+
3. Click the **Incomplete MPU** tab. A list of your incomplete multipart uploads displays.
54+
4. Click <Icon name="more" /> next to the object you want to abort.
55+
5. Click **Abort**. A confirmation pop-up displays.
56+
6. Type **ABORT** then click **Abort multipart upload** to confirm your action.
57+
58+
<Message type="note">
59+
This action will permanently delete the upload, and all the parts uploaded so far. You can also abort an incomplete multipart upload from its [information page](#how-to-view-the-information-of-an-incomplete-multipart-upload).
60+
</Message>

storage/object/how-to/manage-lifecycle-rules.mdx

Lines changed: 21 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ meta:
55
content:
66
h1: How to manage lifecycle rules from the console
77
paragraph: Set and manage lifecycle rules for Object Storage.
8-
tags: object storage object-storage lifecycle lifecycle-rule
8+
tags: object storage object-storage lifecycle lifecycle-rule abort incompelte multipart upload expire version
99
dates:
10-
validation: 2024-06-14
10+
validation: 2024-09-13
1111
posted: 2021-05-27
1212
categories:
1313
- storage
@@ -16,6 +16,8 @@ categories:
1616

1717
With the Scaleway console, you can use lifecycle rules to [manually](/storage/object/how-to/edit-storage-class/) or automatically change the storage class of your objects. These rules also allow users to set expiration dates for objects and their versions.
1818

19+
Lifecycle rules also allow you to automatically abort incomplete [multipart uploads](/storage/object/api-cli/multipart-uploads/).
20+
1921
<Macro id="requirements" />
2022

2123
- A Scaleway account logged into the [console](https://console.scaleway.com)
@@ -28,44 +30,29 @@ With the Scaleway console, you can use lifecycle rules to [manually](/storage/ob
2830
3. Click **Lifecycle rules**.
2931
4. Click **+ Create Lifecycle rule** to add a rule.
3032
5. Enter a name for the rule.
31-
6. Filter the objects you want the rule to be applied to by one or both of the following criteria:
32-
- [**Prefix**](/storage/object/concepts/#prefix): based on the object name and path. The defined rule will be applied to all objects with the same name [prefix](/storage/object/concepts/#prefix).
33-
- [**Tags**](/storage/object/concepts/#tags): comprised of a **key** and an associated **value**. These tags should be defined before rule creation, for either a bucket or an object. You can add one or more tags to your filter.
34-
35-
<Lightbox src="scaleway-transition-rules.webp" alt="" />
36-
37-
<Message type="important">
38-
Lifecycle rules are limited to 500,000 jobs per day. Beyond this limit, you can [transition](/storage/object/how-to/edit-storage-class/) or [delete](/storage/object/how-to/delete-an-object/) your objects manually.
39-
</Message>
33+
6. Select the scope of the lifecycle rule:
34+
- Apply the rule to all the objects contained in the bucket.
35+
- Filter the objects you want the rule to be applied to by one or both of the following criteria:
36+
- [**Prefix**](/storage/object/concepts/#prefix): based on the object name and path. The defined rule will be applied to all objects with the same name [prefix](/storage/object/concepts/#prefix).
37+
- [**Tags**](/storage/object/concepts/#tags): comprised of a **key** and an associated **value**. These tags should be defined before rule creation, for either a bucket or an object. You can add one or more tags to your filter.
38+
7. Configure the behavior of the lifecycle rule:
39+
- Automatically transition the current version of your objects to another storage class after a specified number of days.
40+
- Automatically delete the current version of your objects after a specified number of days.
41+
- Automatically abort [incomplete multipart uploads](/storage/object/api-cli/multipart-uploads/#aborting-a-multipart-upload) after a specified number of days.
4042

41-
## How to configure transition rules
43+
8. Click **Next Step** to proceed.
4244

43-
If you wish to change the [storage class](/storage/object/concepts/#storage-class) of two or more objects at a time, you can set up a transition rule that will automate the process.
44-
45-
1. Click <Icon name="toggle" /> **Change object class** to transfer the current version of the objects to a different storage class.
46-
2. Select the new storage class.
47-
3. Enter the desired number of days before transition.
48-
4. Click **Next step** to proceed.
49-
5. Make sure all the information is correct, then click **Create Lifecycle rule** to confirm.
45+
9. Review the summary of your lifecycle rule, then click **Create lifecycle rule** to confirm.
5046

5147
<Message type="important">
52-
Lifecycle rules only allow the following transitions:
53-
- Standard -> Onezone IA
54-
- Standard -> Glacier
55-
- Onezone IA -> Glacier
48+
- Lifecycle rules are limited to 500,000 jobs per day. Beyond this limit, you can [transition](/storage/object/how-to/edit-storage-class/) or [delete](/storage/object/how-to/delete-an-object/) your objects manually.
5649

57-
Refer to the documentation on [how to manually change the storage class of your objects](/storage/object/how-to/edit-storage-class/) for more information.
50+
- Lifecycle rules only allow the following transitions:
51+
- Standard -> Onezone IA
52+
- Standard -> Glacier
53+
- Onezone IA -> Glacier
5854
</Message>
5955

60-
## How to configure expiration rules
61-
62-
If you wish to delete an object after a set number of days, you can set up an expiration rule that will automate the process.
63-
64-
1. Click <Icon name="toggle" /> **Delete after expiration** to define when the current version of your objects will be deleted.
65-
2. Enter the desired number of days before deletion.
66-
3. Click **Next step** to proceed.
67-
4. Check that all settings are correct and click **Create Lifecycle rule** to confirm.
68-
6956
## How to disable a lifecycle rule
7057

7158
1. Click **Object Storage** in the **Storage** section of the side menu. A list of your buckets displays.
@@ -76,7 +63,7 @@ If you wish to delete an object after a set number of days, you can set up an ex
7663
6. Click **Disable lifecycle rule** to confirm.
7764

7865
<Message type="note">
79-
Once disabled, the lifecycle rule remains listed and can be enabled again. Click <Icon name="more" /> > **Activate** to do so.
66+
Once disabled, the lifecycle rule remains listed and can be enabled again. Click <Icon name="more" />, then select **Activate** to re-enable it.
8067
</Message>
8168

8269
To permanently delete a rule, click <Icon name="more" />, then click **Delete**.

0 commit comments

Comments
 (0)