Skip to content

docs(BLK): add macros to reuse content MTA-6164 #5212

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 1 commit into from
Jul 4, 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
9 changes: 9 additions & 0 deletions macros/block-storage/block-storage-volume-types.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
macro: block-storage-volume-types
---

| Volume type | IOPS | Underlying hardware | Latency | Max volume size | Recommended use cases | Availability & resilience |
|-----------------------------------|----------|--------------------------------|---------------------|----------------------|-------------------------|----------------------------|
| `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 |
| `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 |
| `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 |
129 changes: 129 additions & 0 deletions macros/compute/instances-block-bandwidth-overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,129 @@
---
macros: instances-block-bandwidth-overview
---

This guide provides a complete overview of internet and Block Storage bandwidth for Scaleway Instances.
Understanding these specifications is crucial for optimizing your infrastructure for performance and compatibility.

### Why bandwidth matters

Bandwidth impacts how your applications perform and interact with other systems.
- **Internet bandwidth**: Affects how fast your Instance can send or receive data over the internet.
- **Block bandwidth**: Determines the read/write speed to Block Storage, essential for storage-heavy workloads like databases and analytics.

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

<Message type="tip">
To maximize compatibility with [Block Storage Low Latency 15k](/block-storage/), select an Instance with **at least 3 GiB/s** of Block bandwidth.
</Message>

## COPARM1 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| COPARM1-2C-8G | 200 Mbit/s | 80 MiB/s |
| COPARM1-4C-16G | 400 Mbit/s | 160 MiB/s |
| COPARM1-8C-32G | 800 Mbit/s | 320 MiB/s |
| COPARM1-16C-64G | 1.6 Gbit/s | 640 MiB/s |
| COPARM1-32C-128G | 3.2 Gbit/s | 1.25 GiB/s |

## DEV1 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| DEV1-S | 200 Mbit/s | 100 MiB/s |
| DEV1-M | 300 Mbit/s | 150 MiB/s |
| DEV1-L | 400 Mbit/s | 200 MiB/s |
| DEV1-XL | 500 Mbit/s | 250 MiB/s |

## ENT1 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| ENT1-XXS | 400 Mbit/s | 400 MiB/s |
| ENT1-XS | 800 Mbit/s | 800 MiB/s |
| ENT1-S | 1.6 Gbit/s | 1.56 GiB/s |
| ENT1-M | 3.2 Gbit/s | 3.12 GiB/s |
| ENT1-L | 6.4 Gbit/s | 6.25 GiB/s |
| ENT1-XL | 12.8 Gbit/s | 12.5 GiB/s |

## GP1 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| GP1-XS | 500 Mbit/s | 300 MiB/s |
| GP1-S | 800 Mbit/s | 500 MiB/s |
| GP1-M | 1.5 Gbit/s | 800 MiB/s |
| GP1-L | 5 Gbit/s | 1 GiB/s |
| GP1-XL | 10 Gbit/s | 2 GiB/s |

## PLAY2 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| PLAY2-PICO | 100 Mbit/s | 40 MiB/s |
| PLAY2-NANO | 200 Mbit/s | 80 MiB/s |
| PLAY2-MICRO | 400 Mbit/s | 160 MiB/s |

## PRO2 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| PRO2-XXS | 350 Mbit/s | 125 MiB/s |
| PRO2-XS | 700 Mbit/s | 250 MiB/s |
| PRO2-S | 1.5 Gbit/s | 500 MiB/s |
| PRO2-M | 3 Gbit/s | 1 GiB/s |
| PRO2-L | 6 Gbit/s | 2 GiB/s |

## POP2 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-2C-8G | 400 Mbit/s | 400 MiB/s |
| POP2-4C-16G | 800 Mbit/s | 800 MiB/s |
| POP2-8C-32G | 1.6 Gbit/s | 1.56 GiB/s |
| POP2-16C-64G | 3.2 Gbit/s | 3.12 GiB/s |
| POP2-32C-128G | 6.4 Gbit/s | 5.5 GiB/s |
| POP2-64C-256G | 12.8 Gbit/s | 5.5 GiB/s |

## POP2-WIN range (Windows Server OS)

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-2C-8G-WIN | 400 Mbit/s | 400 MiB/s |
| POP2-4C-16G-WIN | 800 Mbit/s | 800 MiB/s |
| POP2-8C-32G-WIN | 1.6 Gbit/s | 1.56 GiB/s |
| POP2-16C-64G-WIN | 3.2 Gbit/s | 3.12 GiB/s |
| POP2-32C-128G-WIN | 6.4 Gbit/s | 5.5 GiB/s |

## POP2-HC range (High Compute)

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-HC-2C-4G | 400 Mbit/s | 400 MiB/s |
| POP2-HC-4C-8G | 800 Mbit/s | 800 MiB/s |
| POP2-HC-8C-16G | 1.6 Gbit/s | 1.56 GiB/s |
| POP2-HC-16C-32G | 3.2 Gbit/s | 3.12 GiB/s |
| POP2-HC-32C-64G | 6.4 Gbit/s | 5.5 GiB/s |
| POP2-HC-64C-128G | 12.8 Gbit/s | 5.5 GiB/s |

## POP2-HM range (High Memory)

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-HM-2C-16G | 400 Mbit/s | 400 MiB/s |
| POP2-HM-4C-32G | 800 Mbit/s | 800 MiB/s |
| POP2-HM-8C-64G | 1.6 Gbit/s | 1.56 GiB/s |
| POP2-HM-16C-128G | 3.2 Gbit/s | 3.12 GiB/s |
| POP2-HM-32C-256G | 6.4 Gbit/s | 5.5 GiB/s |
| POP2-HM-64C-512G | 12.8 Gbit/s | 5.5 GiB/s |

## POP2-HN range (High Network)

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-HN-3 | 3 Gbit/s | 400 MiB/s |
| POP2-HN-5 | 5 Gbit/s | 800 MiB/s |
| POP2-HN-10 | 10 Gbit/s | 800 MiB/s |
6 changes: 1 addition & 5 deletions pages/block-storage/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,7 @@ Block Storage allows you to create bigger volumes and those volumes are persiste

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

| Volume type | IOPS | Underlying hardware | Latency | Max volume size | Recommended use cases | Availability & resilience |
|-----------------------------------|----------|--------------------------------|---------------------|----------------------|-------------------------|----------------------------|
| `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 |
| `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 |
| `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 |
<Macro id="block-storage-volume-types" />

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Scaleway is transitioning the management of all Block Storage volumes and snapsh

This change streamlines how storage resources are managed by consolidating them under the Block Storage API, providing enhanced management features and clearer storage class distinctions.

Local volumes will remain exclusively supported by the Instance API.
[Local volumes](/local-storage/) will remain exclusively supported by the Instance API.

## What is required from you in the context of the migration?

Expand Down Expand Up @@ -78,11 +78,7 @@ The Block Storage API supports a broader range of storage classes, including:

### Comparison of Block Storage volume types

| Volume type | IOPS | Underlying hardware | Latency | Max volume size | Recommended use cases | Availability & resilience |
|-----------------------------------|----------|--------------------------------|---------------------|----------------------|-------------------------|----------------------------|
| `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 |
| `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 |
| `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 |
<Macro id="block-storage-volume-types" />

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,10 @@ This page provides information about the differences between Block Storage and B

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

## Overview

<Macro id="block-storage-volume-types" />

## Underlying hardware

- **Block Storage 5K IOPS volumes**:
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
meta:
title: Scaleway Instances internet and Block Storage bandwidth overview
description: Find detailed information about the internet and Block Storage bandwidth for each Instance type at Scaleway.
content:
h1: Scaleway Instances internet and Block Storage bandwidth overview
paragraph: Find detailed information about the internet and Block Storage bandwidth for each Instance type at Scaleway.
tags: instance
dates:
validation: 2025-06-30
posted: 2025-06-30
categories:
- compute
---

<Macro id="instances-block-bandwidth-overview" />
126 changes: 1 addition & 125 deletions pages/instances/reference-content/instances-bandwidth-overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,128 +13,4 @@ categories:
- compute
---

This guide provides a complete overview of internet and Block Storage bandwidth for Scaleway Instances.
Understanding these specifications is crucial for optimizing your infrastructure for performance and compatibility.

### Why bandwidth matters

Bandwidth impacts how your applications perform and interact with other systems.
- **Internet bandwidth**: Affects how fast your Instance can send or receive data over the internet.
- **Block bandwidth**: Determines the read/write speed to Block Storage, essential for storage-heavy workloads like databases and analytics.

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

<Message type="tip">
To maximize compatibility with [Block Storage Low Latency 15k](/block-storage/), select an Instance with **at least 3 GiB/s** of Block bandwidth.
</Message>

## COPARM1 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| COPARM1-2C-8G | 200 Mbit/s | 80 MiB/s |
| COPARM1-4C-16G | 400 Mbit/s | 160 MiB/s |
| COPARM1-8C-32G | 800 Mbit/s | 320 MiB/s |
| COPARM1-16C-64G | 1.6 Gbit/s | 640 MiB/s |
| COPARM1-32C-128G | 3.2 Gbit/s | 1.25 GiB/s |

## DEV1 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| DEV1-S | 200 Mbit/s | 100 MiB/s |
| DEV1-M | 300 Mbit/s | 150 MiB/s |
| DEV1-L | 400 Mbit/s | 200 MiB/s |
| DEV1-XL | 500 Mbit/s | 250 MiB/s |

## ENT1 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| ENT1-XXS | 400 Mbit/s | 400 MiB/s |
| ENT1-XS | 800 Mbit/s | 800 MiB/s |
| ENT1-S | 1.6 Gbit/s | 1.56 GiB/s |
| ENT1-M | 3.2 Gbit/s | 3.12 GiB/s |
| ENT1-L | 6.4 Gbit/s | 6.25 GiB/s |
| ENT1-XL | 12.8 Gbit/s | 12.5 GiB/s |

## GP1 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| GP1-XS | 500 Mbit/s | 300 MiB/s |
| GP1-S | 800 Mbit/s | 500 MiB/s |
| GP1-M | 1.5 Gbit/s | 800 MiB/s |
| GP1-L | 5 Gbit/s | 1 GiB/s |
| GP1-XL | 10 Gbit/s | 2 GiB/s |

## PLAY2 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| PLAY2-PICO | 100 Mbit/s | 40 MiB/s |
| PLAY2-NANO | 200 Mbit/s | 80 MiB/s |
| PLAY2-MICRO | 400 Mbit/s | 160 MiB/s |

## PRO2 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| PRO2-XXS | 350 Mbit/s | 125 MiB/s |
| PRO2-XS | 700 Mbit/s | 250 MiB/s |
| PRO2-S | 1.5 Gbit/s | 500 MiB/s |
| PRO2-M | 3 Gbit/s | 1 GiB/s |
| PRO2-L | 6 Gbit/s | 2 GiB/s |

## POP2 range

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-2C-8G | 400 Mbit/s | 400 MiB/s |
| POP2-4C-16G | 800 Mbit/s | 800 MiB/s |
| POP2-8C-32G | 1.6 Gbit/s | 1.56 GiB/s |
| POP2-16C-64G | 3.2 Gbit/s | 3.12 GiB/s |
| POP2-32C-128G | 6.4 Gbit/s | 5.5 GiB/s |
| POP2-64C-256G | 12.8 Gbit/s | 5.5 GiB/s |

## POP2-WIN range (Windows Server OS)

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-2C-8G-WIN | 400 Mbit/s | 400 MiB/s |
| POP2-4C-16G-WIN | 800 Mbit/s | 800 MiB/s |
| POP2-8C-32G-WIN | 1.6 Gbit/s | 1.56 GiB/s |
| POP2-16C-64G-WIN | 3.2 Gbit/s | 3.12 GiB/s |
| POP2-32C-128G-WIN | 6.4 Gbit/s | 5.5 GiB/s |

## POP2-HC range (High Compute)

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-HC-2C-4G | 400 Mbit/s | 400 MiB/s |
| POP2-HC-4C-8G | 800 Mbit/s | 800 MiB/s |
| POP2-HC-8C-16G | 1.6 Gbit/s | 1.56 GiB/s |
| POP2-HC-16C-32G | 3.2 Gbit/s | 3.12 GiB/s |
| POP2-HC-32C-64G | 6.4 Gbit/s | 5.5 GiB/s |
| POP2-HC-64C-128G | 12.8 Gbit/s | 5.5 GiB/s |

## POP2-HM range (High Memory)

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-HM-2C-16G | 400 Mbit/s | 400 MiB/s |
| POP2-HM-4C-32G | 800 Mbit/s | 800 MiB/s |
| POP2-HM-8C-64G | 1.6 Gbit/s | 1.56 GiB/s |
| POP2-HM-16C-128G | 3.2 Gbit/s | 3.12 GiB/s |
| POP2-HM-32C-256G | 6.4 Gbit/s | 5.5 GiB/s |
| POP2-HM-64C-512G | 12.8 Gbit/s | 5.5 GiB/s |

## POP2-HN range (High Network)

| Instance Type | Internet Bandwidth (up to) | Block Bandwidth (up to) |
|-----------------------|-------------------------|---------------------|
| POP2-HN-3 | 3 Gbit/s | 400 MiB/s |
| POP2-HN-5 | 5 Gbit/s | 800 MiB/s |
| POP2-HN-10 | 10 Gbit/s | 800 MiB/s |
<Macro id="instances-block-bandwidth-overview" />
Loading