feat(block-storage): migration documentation (#4131)

Author: nerda-codes

compute/instances/how-to/migrate-volumes-snapshots-to-sbs.mdx

@@ -23,8 +23,9 @@ During migration, unified snapshots will be converted into [Block Storage Low La
 
 This guide offers step-by-step instructions to migrate your volumes and snapshots using either the [Scaleway Command Line Interface (CLI)](/developer-tools/scaleway-cli/quickstart/) tool (recommended) or the [Instances API](https://www.scaleway.com/en/developers/api/instance/#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage).
 
-<Message type="tip">
-  The easiest way to migrate your Block Storage volumes and snapshots is by using the [Scaleway Command Line Interface (CLI)](/developer-tools/scaleway-cli/quickstart/) tool.
+<Message type="note">
+  - The easiest way to migrate your Block Storage volumes and snapshots is by using the [Scaleway Command Line Interface (CLI)](/developer-tools/scaleway-cli/quickstart/) tool
+  - If you encounter an error about quota limitations during the migration process, [contact our support team](https://console.scaleway.com/support/tickets/create) for assistance.
 </Message>
 
 <Macro id="requirements" />
@@ -91,7 +92,7 @@ This guide offers step-by-step instructions to migrate your volumes and snapshot
         $ scw instance volume apply-migration 369feb53-165f-437d-875e-188725df462b validation-key=30d129ca895c4cd59f4c429e12dab300 zone=fr-par-1
           ✅ Success
         ```
-    The volume migration is complete. You can now manage the migrated volume from the [Block Storage Volumes section](https://console.scaleway.com/block-storage/volumes) in the Scaleway console.
+    The volume migration is complete. You can now manage the migrated volume from the [Block Storage volumes section](https://console.scaleway.com/block-storage/volumes) in the Scaleway console.
   </TabsTab>
   <TabsTab label="API">
     <Message type="note">

faq/blockstorage.mdx

@@ -5,7 +5,7 @@ meta:
 content:
   h1: Block Storage
 dates:
-  validation: 2024-12-19
+  validation: 2025-01-07
 category: storage
 productIcon: BlockStorageProductIcon
 ---
@@ -52,4 +52,22 @@ The Block Storage billing scheme is not the same as for Object Storage. You are
 
 ## What other Scaleway resources are compatible with Block Storage?
 
-Block Storage volumes are compatible with [Scaleway Instances](/compute/instances/), [Managed Dabatase for PostgreSQL and MySQL](/managed-databases/postgresql-and-mysql/), and [Kubernetes](/containers/kubernetes/) Kapsule clusters.
+Block Storage volumes are compatible with [Scaleway Instances](/compute/instances/), [Managed Dabatase for PostgreSQL and MySQL](/managed-databases/postgresql-and-mysql/), and [Kubernetes](/containers/kubernetes/) Kapsule clusters.
+
+## How can I convert a Block Storage legacy volume into a Block Storage Low Latency volume?
+
+Currently, there is no direct way to change the storage class of a volume while preserving its ID.
+
+However, you can use the snapshot export/import feature as a temporary solution to transition a Block Storage legacy volume into a Block Storage Low Latency volume.
+
+    <Message type="important">
+      The process below requires manual intervention and **does not preserve the original volume's ID**.
+      While this approach allows you to transition to a Block Storage Low Latency volume, it is only a workaround.
+    </Message>
+
+1. [Export a snapshot of your Block Storage volume](/compute/instances/api-cli/snapshot-import-export-feature/#exporting-snapshots).
+2. [Import the snapshot into a new Low Latency volume](/compute/instances/api-cli/snapshot-import-export-feature/#importing-snapshots).
+
+Find out how to [migrate your Block Storage volumes and snapshots](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) from the Instance API to the Block Storage API.
+
+Find out about the [advantages of migrating the management of your volumes and snapshots](/storage/block/reference-content/advantages-migrating-to-sbs) from the Instance API to the Block Storage API.

macros/storage/block-storage-migration.mdx

@@ -0,0 +1,9 @@
+---
+macro: block-storage-migration
+---
+
+<Message type="important">
+ - Scaleway is transitioning the management of all block volumes and snapshots from the [Instance API](https://www.scaleway.com/en/developers/api/instance/) to the [Block Storage API](https://www.scaleway.com/en/developers/api/block/).
+ - Find out about the [advantages of migrating the management of your volumes and snapshots](/storage/block/reference-content/advantages-migrating-to-sbs/) from the Instance API to the Block Storage API.
+ - Find out how to [migrate your Block Storage volumes and snapshots](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) from the Instance API to the Block Storage API.
+</Message>

menu/navigation.json

@@ -4612,6 +4612,10 @@
                     "label": "Managing a volume",
                     "slug": "managing-a-volume"
                   },
+                  {
+                    "label": "Identifying the API managing Block Storage volumes and snapshots",
+                    "slug": "identifying-volume-snapshot-api"
+                  },
                   {
                     "label": "Unmounting a volume",
                     "slug": "unmounting-a-volume"
@@ -4625,6 +4629,10 @@
                   {
                     "label": "Differences between Block Storage volumes and Block Storage Low Latency volumes",
                     "slug": "differences-between-5kiops-volumes"
+                  },
+                  {
+                    "label": "Advantages of migrating from the Instance API to the Block Storage API for managing block volumes and snapshots",
+                    "slug": "advantages-migrating-to-sbs"
                   }
                 ],
                 "label": "Additional Content",