Skip to content

Commit 0c84402

Browse files
SamyOubouazizSamyOubouaziz
committed
docs(blk): add macros to reuse content MTA-6252
1 parent e412693 commit 0c84402

File tree

7 files changed

+171
-10
lines changed

7 files changed

+171
-10
lines changed

‎macros/block-storage/block-storage-volume-types.mdx‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
macro: block-storage-volume-types
3+
---
4+
5+
| Volume type | IOPS | Underlying hardware | Latency | Max volume size | Recommended use cases | Availability & resilience |
6+
|-----------------------------------|----------|--------------------------------|---------------------|----------------------|-------------------------|----------------------------|
7+
| `b_ssd` (Block Storage 5K legacy) | 5,000 | Legacy SSDs | High | Up to 10 TB | General-purpose workloads that do not demand high IOPS or low latency | Data is replicated three times across multiple disks for high availability and integrity |
8+
| `sbs_5k` (Block Low Latency 5K) | 5,000 | Modern NVMe disks | Low | 5 GB to 10 TB | Development environments, web servers, and applications needing consistent performance | 99.99% SLA, triple-replicated data to safeguard against hardware failures |
9+
| `sbs_15k` (Block Low Latency 15K) | 15,000 | Modern NVMe disks | Very low | 5 GB to 10 TB | High-performance databases, transactional applications, and I/O-intensive workloads | 99.99% SLA, triple-replicated data to safeguard against hardware failures |

‎macros/compute/instances-block-bandwidth-overview.mdx‎

Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,129 @@
1+
---
2+
macros: instances-block-bandwidth-overview
3+
---
4+
5+
This guide provides a complete overview of internet and Block Storage bandwidth for Scaleway Instances.
6+
Understanding these specifications is crucial for optimizing your infrastructure for performance and compatibility.
7+
8+
### Why bandwidth matters
9+
10+
Bandwidth impacts how your applications perform and interact with other systems.
11+
- **Internet bandwidth**: Affects how fast your Instance can send or receive data over the internet.
12+
- **Block bandwidth**: Determines the read/write speed to Block Storage, essential for storage-heavy workloads like databases and analytics.
13+
14+
<Message type="important">
15+
Bandwidth specifications listed here are for informational purposes. To validate the exact bandwidth capacity of your Instance type, refer to the `block_bandwidth` field in the [Instances API](https://www.scaleway.com/en/developers/api/instance/#path-instance-types-list-instance-types). Use the endpoint `/instance/v1/zones/{zone}/products/servers` to retrieve Instance type specifications.
16+
</Message>
17+
18+
<Message type="tip">
19+
To maximize compatibility with [Block Storage Low Latency 15k](/block-storage/), select an Instance with **at least 3 GiB/s** of Block bandwidth.
20+
</Message>
21+
22+
## COPARM1 range
23+
24+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
25+
|-----------------------|-------------------------|---------------------|
26+
| COPARM1-2C-8G | 200 Mbit/s | 80 MiB/s |
27+
| COPARM1-4C-16G | 400 Mbit/s | 160 MiB/s |
28+
| COPARM1-8C-32G | 800 Mbit/s | 320 MiB/s |
29+
| COPARM1-16C-64G | 1.6 Gbit/s | 640 MiB/s |
30+
| COPARM1-32C-128G | 3.2 Gbit/s | 1.25 GiB/s |
31+
32+
## DEV1 range
33+
34+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
35+
|-----------------------|-------------------------|---------------------|
36+
| DEV1-S | 200 Mbit/s | 100 MiB/s |
37+
| DEV1-M | 300 Mbit/s | 150 MiB/s |
38+
| DEV1-L | 400 Mbit/s | 200 MiB/s |
39+
| DEV1-XL | 500 Mbit/s | 250 MiB/s |
40+
41+
## ENT1 range
42+
43+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
44+
|-----------------------|-------------------------|---------------------|
45+
| ENT1-XXS | 400 Mbit/s | 400 MiB/s |
46+
| ENT1-XS | 800 Mbit/s | 800 MiB/s |
47+
| ENT1-S | 1.6 Gbit/s | 1.56 GiB/s |
48+
| ENT1-M | 3.2 Gbit/s | 3.12 GiB/s |
49+
| ENT1-L | 6.4 Gbit/s | 6.25 GiB/s |
50+
| ENT1-XL | 12.8 Gbit/s | 12.5 GiB/s |
51+
52+
## GP1 range
53+
54+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
55+
|-----------------------|-------------------------|---------------------|
56+
| GP1-XS | 500 Mbit/s | 300 MiB/s |
57+
| GP1-S | 800 Mbit/s | 500 MiB/s |
58+
| GP1-M | 1.5 Gbit/s | 800 MiB/s |
59+
| GP1-L | 5 Gbit/s | 1 GiB/s |
60+
| GP1-XL | 10 Gbit/s | 2 GiB/s |
61+
62+
## PLAY2 range
63+
64+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
65+
|-----------------------|-------------------------|---------------------|
66+
| PLAY2-PICO | 100 Mbit/s | 40 MiB/s |
67+
| PLAY2-NANO | 200 Mbit/s | 80 MiB/s |
68+
| PLAY2-MICRO | 400 Mbit/s | 160 MiB/s |
69+
70+
## PRO2 range
71+
72+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
73+
|-----------------------|-------------------------|---------------------|
74+
| PRO2-XXS | 350 Mbit/s | 125 MiB/s |
75+
| PRO2-XS | 700 Mbit/s | 250 MiB/s |
76+
| PRO2-S | 1.5 Gbit/s | 500 MiB/s |
77+
| PRO2-M | 3 Gbit/s | 1 GiB/s |
78+
| PRO2-L | 6 Gbit/s | 2 GiB/s |
79+
80+
## POP2 range
81+
82+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
83+
|-----------------------|-------------------------|---------------------|
84+
| POP2-2C-8G | 400 Mbit/s | 400 MiB/s |
85+
| POP2-4C-16G | 800 Mbit/s | 800 MiB/s |
86+
| POP2-8C-32G | 1.6 Gbit/s | 1.56 GiB/s |
87+
| POP2-16C-64G | 3.2 Gbit/s | 3.12 GiB/s |
88+
| POP2-32C-128G | 6.4 Gbit/s | 5.5 GiB/s |
89+
| POP2-64C-256G | 12.8 Gbit/s | 5.5 GiB/s |
90+
91+
## POP2-WIN range (Windows Server OS)
92+
93+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
94+
|-----------------------|-------------------------|---------------------|
95+
| POP2-2C-8G-WIN | 400 Mbit/s | 400 MiB/s |
96+
| POP2-4C-16G-WIN | 800 Mbit/s | 800 MiB/s |
97+
| POP2-8C-32G-WIN | 1.6 Gbit/s | 1.56 GiB/s |
98+
| POP2-16C-64G-WIN | 3.2 Gbit/s | 3.12 GiB/s |
99+
| POP2-32C-128G-WIN | 6.4 Gbit/s | 5.5 GiB/s |
100+
101+
## POP2-HC range (High Compute)
102+
103+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
104+
|-----------------------|-------------------------|---------------------|
105+
| POP2-HC-2C-4G | 400 Mbit/s | 400 MiB/s |
106+
| POP2-HC-4C-8G | 800 Mbit/s | 800 MiB/s |
107+
| POP2-HC-8C-16G | 1.6 Gbit/s | 1.56 GiB/s |
108+
| POP2-HC-16C-32G | 3.2 Gbit/s | 3.12 GiB/s |
109+
| POP2-HC-32C-64G | 6.4 Gbit/s | 5.5 GiB/s |
110+
| POP2-HC-64C-128G | 12.8 Gbit/s | 5.5 GiB/s |
111+
112+
## POP2-HM range (High Memory)
113+
114+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
115+
|-----------------------|-------------------------|---------------------|
116+
| POP2-HM-2C-16G | 400 Mbit/s | 400 MiB/s |
117+
| POP2-HM-4C-32G | 800 Mbit/s | 800 MiB/s |
118+
| POP2-HM-8C-64G | 1.6 Gbit/s | 1.56 GiB/s |
119+
| POP2-HM-16C-128G | 3.2 Gbit/s | 3.12 GiB/s |
120+
| POP2-HM-32C-256G | 6.4 Gbit/s | 5.5 GiB/s |
121+
| POP2-HM-64C-512G | 12.8 Gbit/s | 5.5 GiB/s |
122+
123+
## POP2-HN range (High Network)
124+
125+
| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
126+
|-----------------------|-------------------------|---------------------|
127+
| POP2-HN-3 | 3 Gbit/s | 400 MiB/s |
128+
| POP2-HN-5 | 5 Gbit/s | 800 MiB/s |
129+
| POP2-HN-10 | 10 Gbit/s | 800 MiB/s |

‎pages/block-storage/faq.mdx‎

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ dates:
66
productIcon: BlockStorageProductIcon
77
---
88

9+
import BlockStorageVolumeTypes from '@macros/block-storage/block-storage-volume-types.mdx'
10+
911
## Why should I use Block Storage instead of Local Storage?
1012

1113
The size of Local Storage depends on your Instance type. With today's configurations, the maximum Local Storage available is 600 GB.
@@ -22,11 +24,7 @@ Block Storage allows you to create bigger volumes and those volumes are persiste
2224

2325
## What is the difference between Block Storage volume types?
2426

25-
| Volume type | IOPS | Underlying hardware | Latency | Max volume size | Recommended use cases | Availability & resilience |
26-
|-----------------------------------|----------|--------------------------------|---------------------|----------------------|-------------------------|----------------------------|
27-
| `b_ssd` (Block Storage 5K legacy) | 5,000 | Legacy SSDs | High | Up to 10 TB | General-purpose workloads that do not demand high IOPS or low latency | Data is replicated three times across multiple disks for high availability and integrity |
28-
| `sbs_5k` (Block Low Latency 5K) | 5,000 | Modern NVMe disks | Low | 5 GB to 10 TB | Development environments, web servers, and applications needing consistent performance | 99.99% SLA, triple-replicated data to safeguard against hardware failures |
29-
| `sbs_15k` (Block Low Latency 15K) | 15,000 | Modern NVMe disks | Very low | 5 GB to 10 TB | High-performance databases, transactional applications, and I/O-intensive workloads | 99.99% SLA, triple-replicated data to safeguard against hardware failures |
27+
<BlockStorageVolumeTypes />
3028

3129
You can attach a maximum of 16 volumes (including the mandatory boot volume) to a single Instance.
3230

‎pages/block-storage/reference-content/advantages-migrating-to-sbs.mdx‎

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ categories:
1010
---
1111
import BlockStorageNoMigrationForK8s from '@macros/storage/block-storage-no-migration-for-k8s.mdx'
1212

13+
import BlockStorageVolumeTypes from '@macros/block-storage/block-storage-volume-types.mdx'
1314

1415
This page explains why **Instance users** should migrate from the Instance API to the Block Storage API to create and manage block volumes and snapshots.
1516

@@ -76,11 +77,7 @@ The Block Storage API supports a broader range of storage classes, including:
7677

7778
### Comparison of Block Storage volume types
7879

79-
| Volume type | IOPS | Underlying hardware | Latency | Max volume size | Recommended use cases | Availability & resilience |
80-
|-----------------------------------|----------|--------------------------------|---------------------|----------------------|-------------------------|----------------------------|
81-
| `b_ssd` (Block Storage 5K legacy) | 5,000 | Legacy SSDs | High | Up to 10 TB | General-purpose workloads that do not demand high IOPS or low latency | Data is replicated three times across multiple disks for high availability and integrity |
82-
| `sbs_5k` (Block Low Latency 5K) | 5,000 | Modern NVMe disks | Low | 5 GB to 10 TB | Development environments, web servers, and applications needing consistent performance | 99.99% SLA, triple-replicated data to safeguard against hardware failures |
83-
| `sbs_15k` (Block Low Latency 15K) | 15,000 | Modern NVMe disks | Very low | 5 GB to 10 TB | High-performance databases, transactional applications, and I/O-intensive workloads | 99.99% SLA, triple-replicated data to safeguard against hardware failures |
80+
<BlockStorageVolumeTypes />
8481

8582
You can attach a maximum of 16 volumes (including the mandatory boot volume) to a single Instance.
8683

‎pages/block-storage/reference-content/differences-between-5kiops-volumes.mdx‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,18 @@ categories:
99
- storage
1010
---
1111

12+
import BlockStorageVolumeTypes from '@macros/block-storage/block-storage-volume-types.mdx'
13+
1214
When creating volumes from the Scaleway console, you are prompted to choose between [Block Storage Low Latency](/block-storage/) volumes, [block volumes (Block Storage)](/instances/concepts/#block-volumes), and [local volumes (Local Storage)](/instances/concepts/#volumes).
1315

1416
This page provides information about the differences between Block Storage and Block Storage Low Latency 5K [IOPS](/block-storage/concepts/#iops) volumes.
1517

1618
Refer to the [dedicated documentation](/instances/concepts/#volumes) to learn about the differences between Block Storage and Local Storage volumes.
1719

20+
## Overview
21+
22+
<BlockStorageVolumeTypes />
23+
1824
## Underlying hardware
1925

2026
- **Block Storage 5K IOPS volumes**:

‎pages/block-storage/reference-content/instances-bandwidth-overview.mdx‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
meta:
3+
title: Scaleway Instances internet and Block Storage bandwidth overview
4+
description: Find detailed information about the internet and Block Storage bandwidth for each Instance type at Scaleway.
5+
content:
6+
h1: Scaleway Instances internet and Block Storage bandwidth overview
7+
paragraph: Find detailed information about the internet and Block Storage bandwidth for each Instance type at Scaleway.
8+
tags: instance
9+
dates:
10+
validation: 2025-06-30
11+
posted: 2025-06-30
12+
categories:
13+
- compute
14+
---
15+
16+
import InstancesBLockBandwidthOverview from '@macros/compute/instances-block-bandwidth-overview.mdx'
17+
18+
<InstancesBLockBandwidthOverview />

‎pages/instances/reference-content/instances-bandwidth-overview.mdx‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,10 @@ categories:
99
- compute
1010
---
1111

12+
import InstancesBLockBandwidthOverview from '@macros/compute/instances-block-bandwidth-overview.mdx'
13+
14+
<InstancesBLockBandwidthOverview />
15+
1216
This guide provides a complete overview of internet and Block Storage bandwidth for Scaleway Instances.
1317
Understanding these specifications is crucial for optimizing your infrastructure for performance and compatibility.
1418

0 commit comments

Comments
 (0)