Skip to content

Commit c18b6bf

Browse files
SamyOubouazizjcirinosclwy
SamyOubouaziz
and
jcirinosclwy
authored
docs(bls): update how tos with new console experience MTA-5820 (#4678)
* docs(bls): update how tos with new console experience MTA-5820 * docs(bls): update * docs(bls): update * docs(bls): update * Update pages/block-storage/how-to/create-a-volume.mdx Co-authored-by: Jessica <[email protected]> * Update pages/block-storage/how-to/detach-a-volume.mdx Co-authored-by: Jessica <[email protected]> * Delete pages/instances/how-to/create-a-block-volume.mdx --------- Co-authored-by: Jessica <[email protected]>
1 parent 6178e1b commit c18b6bf

9 files changed

+99
-52
lines changed

‎pages/block-storage/how-to/attach-a-volume.mdx

+14-12
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,13 @@ content:
77
paragraph: This guide explains how to attach a Block Storage volume to a Scaleway Instance. Follow simple steps to manage your storage efficiently.
88
tags: attach block storage volume
99
dates:
10-
validation: 2024-12-06
10+
validation: 2025-03-24
1111
posted: 2023-11-23
1212
categories:
1313
- block-storage
1414
- storage
1515
---
16-
17-
You can attach a Block Storage volume to your Instance at any time, as long as they are both in the same [Availability Zone](/instances/concepts/#availability-zone).
16+
You can attach up to **15 volumes** at a time to a single Instance. You can attach a Block Storage volume to your Instance at any time, as long as they are both in the same [Availability Zone](/instances/concepts/#availability-zone).
1817

1918
<Macro id="requirements" />
2019

@@ -23,23 +22,26 @@ You can attach a Block Storage volume to your Instance at any time, as long as t
2322
- Created a [Block Storage volume](/block-storage/how-to/create-a-volume/)
2423
- At least one [Instance](/instances/how-to/create-an-instance/)
2524

26-
27-
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. Your volumes display.
28-
2. Click <Icon name="more" /> > **Attach to Instance** next to the volume of your choice. A pop-up displays.
25+
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. The Block Storage page displays.
26+
2. Click **Attach an Instance** under the **Linked Instance** section.
2927
3. Select the Instance to which you want to attach your volume from the drop-down.
3028
4. Click **Attach volume to Instance**.
3129

3230
Alternatively, you can attach a Block Storage volume the following way:
3331

34-
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. The Block Storage page displays.
35-
2. Click **Attach an Instance** under the **Linked Instance** section.
36-
<Lightbox src="scaleway-block-storage-attach-instance.webp" alt="" />
32+
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. Your volumes display.
33+
2. Click <Icon name="more" /> > **Attach to Instance** next to the volume of your choice. A pop-up displays.
3734
3. Select the Instance to which you want to attach your volume from the drop-down.
3835
4. Click **Attach volume to Instance**.
3936

40-
<Message type="important">
41-
You can attach up to 15 volumes at a time to a single Instance.
42-
</Message>
37+
You can also attach a Block storage to an Instance the following way:
38+
39+
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. Your volumes display.
40+
2. Click the name of the volume you want to attach. An overview of your volume displays.
41+
3. Click **Attach** under **Instance** in the **Volume information** section. A pop-up displays.
42+
5. Select the Instance to which you want to attach your volume from the drop-down.
43+
6. Click **Attach volume to Instance**.
44+
4345
<Message type="note">
4446
To use **[Block Storage Low Latency](/block-storage/) 15k**, your Instance must have at least **3 GiB/s of block bandwidth**.
4547
You can verify if an Instance type meets this requirement by consulting the [Scaleway Instances internet and Block Storage bandwidth overview](/instances/reference-content/instances-bandwidth-overview/) documentation.

‎pages/block-storage/how-to/create-a-snapshot.mdx

+16-4
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ content:
77
paragraph: Discover how to easily create a snapshot of a Block Storage volume. Follow our step-by-step guide to efficiently manage your storage resources.
88
tags: create snapshot block storage volume
99
dates:
10-
validation: 2024-12-06
10+
validation: 2025-03-24
1111
posted: 2023-11-23
1212
categories:
1313
- block-storage
@@ -20,7 +20,6 @@ categories:
2020
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
2121
- A [Block Storage volume](/block-storage/how-to/create-a-volume/)
2222

23-
2423
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu.
2524
2. Click <Icon name="more" /> > **Create snapshot** next to the volume of your choice. A pop-up displays.
2625
3. Enter a name for the new snapshot.
@@ -32,7 +31,20 @@ Alternatively, you can create a snapshot the following way:
3231

3332
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu.
3433
2. Click the **Snapshots** tab.
35-
3. Click **Create snapshot**.
34+
3. Click **+ Create snapshot**.
3635
4. Enter a name for the new snapshot.
3736
5. Select the volume you want to snapshot from the drop-down.
38-
6. Click **Create snapshot**.
37+
6. Click **Create snapshot**.
38+
39+
The new snapshot can be found in the **Snapshots** tab.
40+
41+
You can also create a snapshot the following way:
42+
43+
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu.
44+
2. Click the name of the volume you want to snapshot. An overview of your volume displays.
45+
3. In the **Snapshots** tab, click **+ Create snapshot**. The **Create a Snapshot** menu displays.
46+
4. Enter a name for the new snapshot.
47+
5. Select the volume you want to snapshot from the drop-down.
48+
6. Click **Create snapshot**.
49+
50+
The new snapshot can be found in the **Snapshots** tab.

‎pages/block-storage/how-to/create-a-volume.mdx

+8-20
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ content:
77
paragraph: Learn how to efficiently create a low-latency Block Storage volume with our detailed step-by-step guide. Enhance your storage performance seamlessly.
88
tags: create block storage volume add
99
dates:
10-
validation: 2024-12-06
10+
validation: 2025-03-21
1111
posted: 2023-11-23
1212
categories:
1313
- block-storage
@@ -20,36 +20,24 @@ categories:
2020
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
2121

2222
<Message type="important">
23-
This procedure refers to low latency block volumes. To create legacy block volumes, refer to the [dedicated documentation](/block-storage/how-to/create-a-volume/).
23+
This procedure refers to low latency block volumes. To create legacy block volumes, refer to the [dedicated documentation](/instances/how-to/create-a-block-volume/).
2424
</Message>
2525

26-
1. Click **Block Storage** in the **Storage** section of the [Scaleway console](https://console.scaleway.com) side menu. The Block Storage page displays.
26+
1. Click **Block Storage** in the **Storage** section of the side menu. The Block Storage page displays.
2727
2. Click **+ Create volume**.
2828
3. Follow the steps in the creation wizard:
29-
- Choose an [Availability Zone](/instances/concepts/#availability-zone).
29+
- Choose the same [Availability Zone](/instances/concepts/#availability-zone) as the Instance you want to attach your block to.
3030
- Configure the volume:
3131
- Enter a name for your volume or leave the automatically generated name.
32-
- Select an [IOPS](/block-storage/concepts/#iops).
33-
<Message type="important">
34-
You cannot edit the IOPS after you create your volume.
35-
</Message>
32+
- Select an [IOPS](/block-storage/concepts/#iops) option. You cannot edit the IOPS of a volume after its creation.
3633
<Message type="note">
3734
To use **[Block Storage Low Latency](/block-storage/) 15k**, your Instance must have at least **3 GiB/s of block bandwidth**.
3835
You can verify if an Instance type meets this requirement by consulting the [Scaleway Instances internet and Block Storage bandwidth overview](/instances/reference-content/instances-bandwidth-overview/) documentation.
3936

4037
Alternatively, use the [Instances API](https://www.scaleway.com/en/developers/api/instance/#path-instance-types-list-instance-types) to check the `block_bandwidth` field at `/instance/v1/zones/{zone}/products/servers`.
4138
This field provides detailed information about block bandwidth for each Instance type, helping you ensure compatibility with high-performance storage.
4239
</Message>
43-
44-
- Define a volume size.
45-
<Message type="important">
46-
The volume size must be at least 5GB.
47-
</Message>
48-
- Select an Instance from the drop-down to attach your volume. This step is optional.
49-
- Check the estimated cost.
40+
- Define a volume size of at least 5 GB.
41+
- Optionally, select an Instance from the drop-down to attach your volume.
42+
- Verify the estimated cost.
5043
4. Click **Create volume**. The volumes overview page displays.
51-
<Message type="important">
52-
The volume must be in the same Availability Zone as the Instance you want to connect it to.
53-
</Message>
54-
55-

‎pages/block-storage/how-to/create-volume-from-snapshot.mdx

+11-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ content:
77
paragraph: Discover how to efficiently create a Block Storage volume from a snapshot with our comprehensive step-by-step guide. Optimize your storage workflow effortlessly.
88
tags: create snapshot block storage volume
99
dates:
10-
validation: 2024-12-06
10+
validation: 2025-03-24
1111
posted: 2023-11-23
1212
categories:
1313
- block-storage
@@ -34,4 +34,14 @@ categories:
3434

3535
The new volume appears in your volumes list.
3636

37+
Alternatively, you can create a volume from a snapshot this way:
3738

39+
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. The Block Storage page displays.
40+
2. Click the **Snapshots** tab. A list of your snapshots displays.
41+
3. Click the name of the snapshot you want to use to create a new volume. The Snapshot overview displays.
42+
4. In the **Volume from snapshot** section, click **Create volume**.
43+
5. Enter a name for the new volume, or leave the suggested name.
44+
6. Select an [IOPS](/block-storage/concepts/#iops). You cannot edit the IOPS of a volume after its creation.
45+
7. Click **Create volume from snapshot**.
46+
47+
The new volume appears in your volumes list.

‎pages/block-storage/how-to/delete-a-snapshot.mdx

+11-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ content:
77
paragraph: This guide explains the steps to safely delete a volume snapshot from your Scaleway account.
88
tags: delete snapshot block volume storage
99
dates:
10-
validation: 2024-12-06
10+
validation: 2025-03-24
1111
posted: 2023-11-23
1212
categories:
1313
- block-storage
@@ -30,4 +30,14 @@ categories:
3030
This action permanently deletes your snapshot and all the data it contains. If you do not want to lose this data, make a backup before deleting the snapshot.
3131
</Message>
3232

33+
Alternatively, you can delete a Block Storage snapshot the following way:
3334

35+
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. The Block Storage page displays.
36+
2. Click the **Snapshots** tab. A list of your snapshots displays.
37+
3. Click the name of the snapshot you want to use to create a new volume. The Snapshot overview displays.
38+
4. Click **Delete snapshot** at the bottom of the page. A confirmation pop-up displays.
39+
5. Type `DELETE` to confirm.
40+
6. Click **Delete this snapshot**.
41+
<Message type="important">
42+
This action permanently deletes your snapshot and all the data it contains. If you do not want to lose this data, make a backup before deleting the snapshot.
43+
</Message>

‎pages/block-storage/how-to/delete-a-volume.mdx

+10-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ content:
77
paragraph: This guide explains the steps to safely delete a Block Storage volume from your Scaleway account.
88
tags: delete cancel terminate block volume storage
99
dates:
10-
validation: 2024-12-19
10+
validation: 2025-03-24
1111
posted: 2023-11-23
1212
categories:
1313
- block-storage
@@ -33,4 +33,13 @@ categories:
3333
This action permanently deletes your volume and all the data it contains. If you do not want to lose this data, make a backup before deleting the volume.
3434
</Message>
3535

36+
Alternatively, you can delete a Block Storage volume the following way:
3637

38+
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. A list of your volumes displays.
39+
3. Click the name of the volume you want to delete. The volume overview displays.
40+
4. Click **Delete volume** at the bottom of the page. A confirmation pop-up displays.
41+
5. Type `DELETE` to confirm.
42+
6. Click **Delete volume**.
43+
<Message type="important">
44+
This action permanently deletes your volume and all the data it contains. If you do not want to lose this data, make a backup before deleting the volume.
45+
</Message>

‎pages/block-storage/how-to/detach-a-volume.mdx

+14-4
Original file line numberDiff line numberDiff line change
@@ -7,24 +7,34 @@ content:
77
paragraph: Learn how to safely detach a Block Storage volume from your Scaleway Instance.
88
tags: detach unlock disconnect block storage volume
99
dates:
10-
validation: 2024-12-19
10+
validation: 2025-03-24
1111
posted: 2020-01-10
1212
categories:
1313
- block-storage
1414
- storage
1515
---
1616

17-
You can detach a Block Storage volume from your Instance at any time. It is important to [unmount the volume](/block-storage/api-cli/unmounting-a-volume/) from the operating system before detaching it to avoid data loss.
18-
17+
You can detach a Block Storage volume from your Instance at any time.
18+
<Message type="important">
19+
Always [unmount the volume](/block-storage/api-cli/unmounting-a-volume/) from the operating system of your Instance before detaching it to avoid data loss.
20+
</Message>
1921
<Macro id="requirements" />
2022

2123
- A Scaleway account logged into the [console](https://console.scaleway.com)
2224
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
2325
- Created a [Block Storage volume](/block-storage/how-to/create-a-volume/) that is [attached](/block-storage/how-to/attach-a-volume/) to an Instance
2426

25-
2627
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. The Block Storage page displays.
2728
2. Click <Icon name="more" /> > **Detach from Instance** next to the volume of your choice. A pop-up displays.
2829
3. Click **Detach volume from Instance** to confirm.
2930

31+
Your volume is now detached, and can be [attached](/block-storage/how-to/attach-a-volume/) again to an Instance.
32+
33+
You can also detach a Block storage volume from an Instance the following way:
34+
35+
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. Your volumes display.
36+
2. Click the name of the volume you want to detach. An overview of your volume displays.
37+
3. Click **Detach** under **Instance** in the **Volume information** section. A confirmation pop-up displays.
38+
5. Click **Detach this volume** to confirm your action.
3039

40+
Your volume is now detached, and can be [attached](/block-storage/how-to/attach-a-volume/) again to an Instance.

‎pages/block-storage/how-to/increase-block-volume.mdx

+14-8
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ content:
77
paragraph: Learn how to easily increase the size of your Scaleway Block Storage volumes for more storage capacity.
88
tags: block storage block-storage increase maximize expand volume size
99
dates:
10-
validation: 2024-12-19
10+
validation: 2025-03-24
1111
posted: 2023-11-23
1212
categories:
1313
- block-storage
@@ -20,17 +20,23 @@ categories:
2020
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
2121
- Created a [Block Storage volume](/block-storage/how-to/create-a-volume/)
2222

23-
2423
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. The Block Storage page displays.
2524
2. Click the <Icon name="more" /> icon next to the volume of your choice, then click **Increase size**. A pop-up displays.
26-
3. Increase the size according to your preference with the <Icon name="plus" /> button.
25+
3. Increase the size according to your preference with the <Icon name="plus" /> button, up to 10 TB.
2726
4. Click **Update volume size** to confirm.
28-
<Message type="note">
29-
The maximum size of a Block volume is 10 TB.
30-
</Message>
27+
28+
The new size of your volume displays in the **Size** column.
29+
30+
You can also increase the size of a Block storage volume the following way:
31+
32+
1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. Your volumes display.
33+
2. Click the name of the desired volume. An overview of your volume displays.
34+
3. Click **Increase** under **Size** in the **Volume information** section. A pop-up displays.
35+
4. Enter the new size of your volume up to 10 TB, then click **Increase volume size**.
36+
5. Click **Detach this volume** to confirm your action.
37+
38+
The new size of your volume displays under **Size** in the **Volume Information** section.
3139

3240
<Message type="tip">
3341
Refer to our [dedicated documentation](/block-storage/api-cli/managing-a-volume/#increasing-the-partition-size-of-the-volume-with-growpart) to find out how to increase your volume's partition size.
3442
</Message>
35-
36-

‎pages/block-storage/how-to/unmount-a-volume.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ content:
77
paragraph: This guide explains how to safely unmount a Block Storage volume from your Scaleway Instance to avoid data loss.
88
tags: unmount umount disconnect unlink block volume
99
dates:
10-
validation: 2024-12-06
10+
validation: 2025-03-24
1111
posted: 2019-11-29
1212
categories:
1313
- block-storage

0 commit comments

Comments
 (0)