docs(bls): second batch

nerda-codes · nerda-codes · commit 44c430d96b24 · 2024-12-19T15:44:28.000+01:00
diff --git a/faq/blockstorage.mdx b/faq/blockstorage.mdx
@@ -54,7 +54,7 @@ The Block Storage billing scheme is not the same as for Object Storage. You are
 
 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?
+## How can I convert a Block Storage legacy volume into a Block Storage Low Latency volume?
 
 For better performance, you can convert your Block Storage legacy volumes into Block Storage Low Latency volumes.
 
@@ -66,4 +66,6 @@ To convert your volume you need to:
 
 - Import the data: restore or transfer the data from the backup or intermediary storage into the newly created volume.
 
-Find out [how to migrate](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) your Block Storage legacy volumes to Block Storage Low Latency volumes.
+Find out how to [migrate your Block Storage legacy 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](advantages-migrating-to-sbs) from the Instance API to the Block Storage API.
diff --git a/macros/storage/block-storage-migration.mdx b/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 Storage legacy 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](advantages-migrating-to-sbs) from the Instance API to the Block Storage API.
+ - Find out how to [migrate your Block Storage legacy volumes and snapshots](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) from the Instance API to the Block Storage API.
+</Message>
diff --git a/menu/navigation.json b/menu/navigation.json
@@ -4559,6 +4559,10 @@
                     "label": "Create a Block Storage volume from a snapshot",
                     "slug": "create-volume-from-snapshot"
                   },
+                  {
+                    "label": "Identify a volume and snapshot type",
+                    "slug": "identify-volume-snapshot-type"
+                  },
                   {
                     "label": "Detach a volume",
                     "slug": "detach-a-volume"
@@ -4585,6 +4589,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"
@@ -4598,6 +4606,10 @@
                   {
                     "label": "Differences between Block Storage volumes and Block Storage Low Latency volumes",
                     "slug": "differences-between-5kiops-volumes"
+                  },
+                  {
+                    "label": "Advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage Low Latency",
+                    "slug": "advantages-migrating-to-sbs"
                   }
                 ],
                 "label": "Additional Content",
diff --git a/storage/block/api-cli/identifying-volume-snapshot-api.mdx b/storage/block/api-cli/identifying-volume-snapshot-api.mdx
@@ -1,9 +1,9 @@
 ---
 meta:
-  title: Identify the API managing your Block Storage volumes and snapshots
+  title: Identifying the API managing Block Storage volumes and snapshots
   description: Learn how to determine which API (Instance or Block Storage) manages your volumes and snapshots on Scaleway using CLI and API commands.
 content:
-  h1: Identify the API managing your Block Storage volumes and snapshots
+  h1: Identifying the API managing Block Storage volumes and snapshots
   paragraph: Determine whether your Block Storage volumes and snapshots are managed by the Instance API or Block Storage API.
 dates:
   validation: 2025-01-03
@@ -14,7 +14,7 @@ categories:
 
 This page shows you how to identify the API managing your Block Storage volumes and snapshots, using the API and CLI.
 
-Find out [how to migrate](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) your Block Storage legacy volumes to Block Storage Low Latency volumes.
+<Macro id="block-storage-migration" />
 
 <Macro id="requirements" />
 
diff --git a/storage/block/how-to/identify-volume-snapshot-type.mdx b/storage/block/how-to/identify-volume-snapshot-type.mdx
@@ -1,11 +1,11 @@
 ---
 meta:
   title: How to identify your volume and snapshot type
-  description: Learn how to identify your volume and snapshot type from the Scaleway console.
+  description: Learn how to identify the API managing your volumes and snapshots using the Scaleway console.
 content:
   h1: How to identify your volume and snapshot type
-  paragraph: Learn how to identify your volume and snapshot type from the Scaleway console.
-tags: identify-volume-type identify-snapshot bssd sbs volume snapshot
+  paragraph: Learn how to identify the API managing your volumes and snapshots using the Scaleway console.
+tags: identify-volume-type identify-snapshot bssd sbs volume snapshot api
 dates:
   validation: 2025-01-03
   posted: 2025-01-03
@@ -14,7 +14,7 @@ categories:
   - storage
 ---
 
-This page shows you how to identify your volume and snapshot type using the Scaleway console. Find out [how to migrate](/compute/instances/how-to/migrate-volumes-snapshots-to-sbs/) your Block Storage legacy volumes to Block Storage Low Latency volumes.
+This page shows you how to identify the API that manages your volumes and snapshots using the Scaleway console. Refer to our [dedicated documentation](/storage/api-cli/identifying-volume-snapshot-api/) to learn how to identify the API managing your volumes and snapshots using the API and CLI.
 
 <Macro id="requirements" />
 
@@ -23,21 +23,23 @@ This page shows you how to identify your volume and snapshot type using the Scal
 - Created [Block Storage volumes](/storage/block/how-to/create-a-volume/)
 - Created [snapshots](/storage/block/how-to/create-a-snapshot/)
 
+<Macro id="block-storage-migration" />
+
 ## How to identify your volume type
 
 1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu. Your volumes display.
-2. Click the **API** drop-down and select either **Block Storage API** to filter for your volumes creates via the Block Storage API, or **Instance API** to filter for your volumes managed by the Instance API.
-3. Click the **Volume type** drop-down and select **Block Storage Low Latency 5K** and/or **Block Storage Low Latency 15K** to filter for 5K IOPS and/or 15K IOPS volumes.
+2. Leave the **Block Storage API** filter in the drop-down or select **Instance API** to display either your volumes managed by the Block Storage API, or the Instance API.
+3. Click the **Volume type** drop-down and select the volume type(s) to filter for.
 4. Click **Apply filters**. The volumes you have filtered for display.
-5. Optionally, click a specific volume to display the information page and verify the volume type next to the **Type** field.
+5. Optionally, click a specific volume to display its information page, and verify the volume type next to the **Type** field.
 6. Click **Clear filters** once you are done.
 
 ## How to identify your snapshot type
 
 1. Click **Block Storage** in the **Storage** section of the Scaleway console side menu.
 2. Click the **Snapshots** tab. Your snapshots display.
-3. Click the **API** drop-down and select either **Block Storage API** to filter for your volumes creates via the Block Storage API, or **Instance API** to filter for your volumes managed by the Instance API.
-4. Click the **Snapshot type** drop-down and select **Block Storage Low Latency 5K** and/or **Block Storage Low Latency 15K** to filter for snapshots of 5K IOPS and/or 15K IOPS volumes.
-5. Optionally, click the <Icon name="more" /> iconic next to a specific snapshot to display the information page and verify the type next to the **Type** field.
+3. Leave the **Block Storage API** filter in the drop-down or select **Instance API** to display either your snapshots managed by the Block Storage API, or the Instance API.
+4. Click the **Snapshot type** drop-down and select the snapshot type(s) to filter for.
+5. Optionally, click the <Icon name="more" /> icon next to a specific snapshot to display its information page, and verify the type next to the **Type** field.
 6. Click **Clear filters** once you are done.
 
diff --git a/storage/block/index.mdx b/storage/block/index.mdx
@@ -60,6 +60,11 @@ meta:
         url="/storage/block/api-cli/unmounting-a-volume/"
         label="Read more"
     />
+        <DefaultCard
+        title="Identify the API managing your Block Storage volumes and snapshots"
+        url="/storage/block/api-cli/identifying-volume-snapshot-api/"
+        label="Read more"
+    />
 </Grid>
 
 
diff --git a/storage/block/reference-content/advantages-migrating-to-sbs.mdx b/storage/block/reference-content/advantages-migrating-to-sbs.mdx
@@ -1,10 +1,10 @@
 ---
 meta:
-  title: Advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage low latency
-  description: Learn the key advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage low latency.
+  title: Advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage Low Latency
+  description: Learn the key advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage Low Latency.
 content:
-  h1: Advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage low latency
-  paragraph: Learn the key advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage low latency.
+  h1: Advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage Low Latency
+  paragraph: Learn the key advantages of migrating your Block Storage legacy volumes and snapshots to Block Storage Low Latency.
 tags: volumes block-storage 5kiops 10kiops sbs low-latency
 dates:
   validation: 2025-01-03
@@ -13,13 +13,11 @@ categories:
   - storage
 ---
 
-## Transitioning from the Instances API to the Block Storage API for volume and snapshot management
+## Transitioning from the Instance API to the Block Storage API for volume and snapshot management
 
-Scaleway is transitioning the management of all Block Storage legacy volumes and snapshots from the [Instances API](https://www.scaleway.com/en/developers/api/instance/) to the [Block Storage API](https://www.scaleway.com/en/developers/api/block/). This means that Block Storage volumes and snapshots will no longer be available from the [Compute section](https://console.scaleway.com/instance/) in the Scaleway console, but from the [Storage section](https://console.scaleway.com/block-storage).
+Scaleway is transitioning the management of all Block Storage legacy 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/). All Block Storage volumes and snapshots created via the [Scaleway console](https://console.scaleway.com) will no longer be available from the [Compute section](https://console.scaleway.com/instance/), but from the [Storage section](https://console.scaleway.com/block-storage).
 
-This change provides you with enhanced performance and advanced storage capabilities. If you have created volumes and snapshots via the Instances API, we strongly recommend migrating them to the Block Storage API to benefit from these improvements.
-
-All Block Storage volumes and snapshots created via the Scaleway console, whether from the Instances section or the Block Storage section, are now created using the Block Storage API.
+This change provides you with enhanced performance and advanced storage capabilities. If you have created volumes and snapshots via the Instance API, we **strongly recommend migrating them to the Block Storage API** to benefit from these improvements.
 
 Local volumes will remain exclusively supported by the Instance API.
 
@@ -30,25 +28,25 @@ By migrating your Block Storage volumes and snapshots to the Block Storage API,
 - **Low latency**: volumes managed by the Block Storage API leverage modern hardware, ensuring faster access times and smoother performance.
 - **Higher IOPS performance**: benefit from up to 5K IOPS (input/output operations per second) with Block Storage Low Latency volumes and 15K IOPS with higher-tier offerings. These performance improvements are ideal for applications requiring rapid data access and high-speed operations.
 
-## Differences between volumes managed by the Instances API and the Block Storage API
+## Differences between volumes managed by the Instance API and the Block Storage API
 
-Volumes created with the Instances API differ from those created with the Block Storage API in both hardware and performance characteristics:
+Volumes created with the Instance API differ from those created with the Block Storage API in both hardware and performance characteristics:
 
 ### Underlying hardware
 
-Instances API volumes are built on **older-generation SSDs**, resulting in **slower performance and have a higher latency**, which may impact the responsiveness of applications.
+Instance API volumes are built on **older-generation SSDs**, resulting in **slower performance and have a higher latency**, which may impact the responsiveness of applications.
 
 Block Storage API volumes are powered by **modern NVMe (Non-Volatile Memory Express) disks**, which are optimized for **high-speed operations**. They also have **advanced hardware** which ensures faster data access and lower latency.
 
 ### Performance
 
-Instances API volumes have a **limited performance** due to older SSD technology. They also have a **lower IOPS and slower data processing speed**.
+Instance API volumes have a **limited performance** due to older SSD technology. They also have a **lower IOPS and slower data processing speed**.
 
 Block Storage API volumes benefit from e**nhanced performance with up to 15K IOPS**.
 
 ### Latency
 
-Instances API volumes have a **higher latency**, making them less suitable for applications requiring quick data retrieval.
+Instance API volumes have a **higher latency**, making them less suitable for applications requiring quick data retrieval.
 
 Block Storage API volumes have a **reduced latency** which ensures faster application response times. They are ideal for workloads requiring rapid and reliable data access.
 
