Skip to content

docs(bls): update how tos with new console experience MTA-5820 #4678

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Mar 25, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 14 additions & 12 deletions pages/block-storage/how-to/attach-a-volume.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,13 @@ content:
paragraph: This guide explains how to attach a Block Storage volume to a Scaleway Instance. Follow simple steps to manage your storage efficiently.
tags: attach block storage volume
dates:
validation: 2024-12-06
validation: 2025-03-24
posted: 2023-11-23
categories:
- block-storage
- storage
---

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).
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).

<Macro id="requirements" />

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


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

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

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

<Message type="important">
You can attach up to 15 volumes at a time to a single Instance.
</Message>
You can also attach a Block storage to an Instance the following way:

1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. Your volumes display.
2. Click the name of the volume you want to attach. An overview of your volume displays.
3. Click **Attach** under **Instance** in the **Volume information** section. A pop-up displays.
5. Select the Instance to which you want to attach your volume from the drop-down.
6. Click **Attach volume to Instance**.

<Message type="note">
To use **[Block Storage Low Latency](/block-storage/) 15k**, your Instance must have at least **3 GiB/s of block bandwidth**.
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.
Expand Down
20 changes: 16 additions & 4 deletions pages/block-storage/how-to/create-a-snapshot.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ content:
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.
tags: create snapshot block storage volume
dates:
validation: 2024-12-06
validation: 2025-03-24
posted: 2023-11-23
categories:
- block-storage
Expand All @@ -20,7 +20,6 @@ categories:
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- A [Block Storage volume](/block-storage/how-to/create-a-volume/)


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

1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu.
2. Click the **Snapshots** tab.
3. Click **Create snapshot**.
3. Click **+ Create snapshot**.
4. Enter a name for the new snapshot.
5. Select the volume you want to snapshot from the drop-down.
6. Click **Create snapshot**.
6. Click **Create snapshot**.

The new snapshot can be found in the **Snapshots** tab.

You can also create a snapshot the following way:

1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu.
2. Click the name of the volume you want to snapshot. An overview of your volume displays.
3. In the **Snapshots** tab, click **+ Create snapshot**. The **Create a Snapshot** menu displays.
4. Enter a name for the new snapshot.
5. Select the volume you want to snapshot from the drop-down.
6. Click **Create snapshot**.

The new snapshot can be found in the **Snapshots** tab.
28 changes: 8 additions & 20 deletions pages/block-storage/how-to/create-a-volume.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ content:
paragraph: Learn how to efficiently create a low-latency Block Storage volume with our detailed step-by-step guide. Enhance your storage performance seamlessly.
tags: create block storage volume add
dates:
validation: 2024-12-06
validation: 2025-03-21
posted: 2023-11-23
categories:
- block-storage
Expand All @@ -20,36 +20,24 @@ categories:
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization

<Message type="important">
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/).
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/).
</Message>

1. Click **Block Storage** in the **Storage** section of the [Scaleway console](https://console.scaleway.com) side menu. The Block Storage page displays.
1. Click **Block Storage** in the **Storage** section of the side menu. The Block Storage page displays.
2. Click **+ Create volume**.
3. Follow the steps in the creation wizard:
- Choose an [Availability Zone](/instances/concepts/#availability-zone).
- Choose the same [Availability Zone](/instances/concepts/#availability-zone) as the Instance you want to attach your block to.
- Configure the volume:
- Enter a name for your volume or leave the automatically generated name.
- Select an [IOPS](/block-storage/concepts/#iops).
<Message type="important">
You cannot edit the IOPS after you create your volume.
</Message>
- Select an [IOPS](/block-storage/concepts/#iops) option. You cannot edit the IOPS of a volume after its creation.
<Message type="note">
To use **[Block Storage Low Latency](/block-storage/) 15k**, your Instance must have at least **3 GiB/s of block bandwidth**.
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.

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`.
This field provides detailed information about block bandwidth for each Instance type, helping you ensure compatibility with high-performance storage.
</Message>

- Define a volume size.
<Message type="important">
The volume size must be at least 5GB.
</Message>
- Select an Instance from the drop-down to attach your volume. This step is optional.
- Check the estimated cost.
- Define a volume size of at least 5 GB.
- Optionally, select an Instance from the drop-down to attach your volume.
- Verify the estimated cost.
4. Click **Create volume**. The volumes overview page displays.
<Message type="important">
The volume must be in the same Availability Zone as the Instance you want to connect it to.
</Message>


12 changes: 11 additions & 1 deletion pages/block-storage/how-to/create-volume-from-snapshot.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ content:
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.
tags: create snapshot block storage volume
dates:
validation: 2024-12-06
validation: 2025-03-24
posted: 2023-11-23
categories:
- block-storage
Expand All @@ -34,4 +34,14 @@ categories:

The new volume appears in your volumes list.

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

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

The new volume appears in your volumes list.
12 changes: 11 additions & 1 deletion pages/block-storage/how-to/delete-a-snapshot.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ content:
paragraph: This guide explains the steps to safely delete a volume snapshot from your Scaleway account.
tags: delete snapshot block volume storage
dates:
validation: 2024-12-06
validation: 2025-03-24
posted: 2023-11-23
categories:
- block-storage
Expand All @@ -30,4 +30,14 @@ categories:
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.
</Message>

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

1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. The Block Storage page displays.
2. Click the **Snapshots** tab. A list of your snapshots displays.
3. Click the name of the snapshot you want to use to create a new volume. The Snapshot overview displays.
4. Click **Delete snapshot** at the bottom of the page. A confirmation pop-up displays.
5. Type `DELETE` to confirm.
6. Click **Delete this snapshot**.
<Message type="important">
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.
</Message>
11 changes: 10 additions & 1 deletion pages/block-storage/how-to/delete-a-volume.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ content:
paragraph: This guide explains the steps to safely delete a Block Storage volume from your Scaleway account.
tags: delete cancel terminate block volume storage
dates:
validation: 2024-12-19
validation: 2025-03-24
posted: 2023-11-23
categories:
- block-storage
Expand All @@ -33,4 +33,13 @@ categories:
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.
</Message>

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

1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. A list of your volumes displays.
3. Click the name of the volume you want to delete. The volume overview displays.
4. Click **Delete volume** at the bottom of the page. A confirmation pop-up displays.
5. Type `DELETE` to confirm.
6. Click **Delete volume**.
<Message type="important">
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.
</Message>
18 changes: 14 additions & 4 deletions pages/block-storage/how-to/detach-a-volume.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,24 +7,34 @@ content:
paragraph: Learn how to safely detach a Block Storage volume from your Scaleway Instance.
tags: detach unlock disconnect block storage volume
dates:
validation: 2024-12-19
validation: 2025-03-24
posted: 2020-01-10
categories:
- block-storage
- storage
---

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.

You can detach a Block Storage volume from your Instance at any time.
<Message type="important">
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.
</Message>
<Macro id="requirements" />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- 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


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

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

You can also detach a Block storage volume from an Instance the following way:

1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. Your volumes display.
2. Click the name of the volume you want to detach. An overview of your volume displays.
3. Click **Detach** under **Instance** in the **Volume information** section. A confirmation pop-up displays.
5. Click **Detach this volume** to confirm your action.

Your volume is now detached, and can be [attached](/block-storage/how-to/attach-a-volume/) again to an Instance.
22 changes: 14 additions & 8 deletions pages/block-storage/how-to/increase-block-volume.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ content:
paragraph: Learn how to easily increase the size of your Scaleway Block Storage volumes for more storage capacity.
tags: block storage block-storage increase maximize expand volume size
dates:
validation: 2024-12-19
validation: 2025-03-24
posted: 2023-11-23
categories:
- block-storage
Expand All @@ -20,17 +20,23 @@ categories:
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- Created a [Block Storage volume](/block-storage/how-to/create-a-volume/)


1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. The Block Storage page displays.
2. Click the <Icon name="more" /> icon next to the volume of your choice, then click **Increase size**. A pop-up displays.
3. Increase the size according to your preference with the <Icon name="plus" /> button.
3. Increase the size according to your preference with the <Icon name="plus" /> button, up to 10 TB.
4. Click **Update volume size** to confirm.
<Message type="note">
The maximum size of a Block volume is 10 TB.
</Message>

The new size of your volume displays in the **Size** column.

You can also increase the size of a Block storage volume the following way:

1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. Your volumes display.
2. Click the name of the desired volume. An overview of your volume displays.
3. Click **Increase** under **Size** in the **Volume information** section. A pop-up displays.
4. Enter the new size of your volume up to 10 TB, then click **Increase volume size**.
5. Click **Detach this volume** to confirm your action.

The new size of your volume displays under **Size** in the **Volume Information** section.

<Message type="tip">
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.
</Message>


2 changes: 1 addition & 1 deletion pages/block-storage/how-to/unmount-a-volume.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ content:
paragraph: This guide explains how to safely unmount a Block Storage volume from your Scaleway Instance to avoid data loss.
tags: unmount umount disconnect unlink block volume
dates:
validation: 2024-12-06
validation: 2025-03-24
posted: 2019-11-29
categories:
- block-storage
Expand Down
47 changes: 0 additions & 47 deletions pages/instances/how-to/create-a-block-volume.mdx

This file was deleted.