Skip to content

Commit 516b678

Browse files
RoRoJjcirinosclwy
authored andcommitted
fix(vpc): add troubleshooting guide (scaleway#4461)
* fix(vpc): add troubleshooting guide * Apply suggestions from code review Co-authored-by: Jessica <[email protected]> --------- Co-authored-by: Jessica <[email protected]>
1 parent 2f1ed7a commit 516b678

File tree

8 files changed

+97
-1
lines changed

8 files changed

+97
-1
lines changed

menu/navigation.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3207,6 +3207,10 @@
32073207
{
32083208
"label": "I am experiencing SSL/DNS errors and conflicts",
32093209
"slug": "pn-name"
3210+
},
3211+
{
3212+
"label": "I can't delete my VPC or Private Network",
3213+
"slug": "cant-delete-vpc-pn"
32103214
}
32113215
],
32123216
"label": "Troubleshooting",

pages/vpc/how-to/delete-private-network.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,4 +38,8 @@ categories:
3838

3939
4. Type **DELETE** and click **Delete Private Network**.
4040

41-
Your Private Network is deleted.
41+
Your Private Network is deleted.
42+
43+
<Message type="tip">
44+
If you experience any errors or difficulties deleting your Private Network, see our [troubleshooting guide](/vpc/troubleshooting/cant-delete-vpc-pn/).
45+
</Message>

pages/vpc/how-to/delete-vpc.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,4 +33,8 @@ You can only delete VPCs that:
3333

3434
3. Type **DELETE** in the box to confirm, then click **Delete VPC**.
3535

36+
<Message type="tip">
37+
If you experience any errors or difficulties deleting your VPC, see our [troubleshooting guide](/vpc/troubleshooting/cant-delete-vpc-pn/).
38+
</Message>
39+
3640

26.7 KB
Loading
42.2 KB
Loading
25.4 KB
Loading
24.3 KB
Loading
Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
meta:
3+
title: I can't delete my VPC or Private Network
4+
description: Resolve issues deleting your Scaleway VPC or Private Network with this troubleshooting guide. Find solutions to common errors and get back to managing your infrastructure.
5+
content:
6+
h1: I can't delete my VPC or Private Network
7+
paragraph: Resolve issues deleting your Scaleway VPC or Private Network with this troubleshooting guide. Find solutions to common errors and get back to managing your infrastructure.
8+
tags: vpc private-network delete resources ipam error
9+
dates:
10+
validation: 2025-02-21
11+
posted: 2025-02-21
12+
categories:
13+
- network
14+
---
15+
16+
You may want to delete a Private Network or a VPC if you are reorganizing your infrastructure, cleaning up after tests, or if you want to delete a Scaleway [Project](/organizations-and-projects/concepts/#project) or account.
17+
18+
This page helps you solve potential errors that prevent successful deletion.
19+
20+
## VPC vs Private Network
21+
22+
Understanding this difference is important for successful deletion.
23+
24+
- The deletion of a **V**irtual **P**rivate **C**loud (VPC) is prevented if it still contains Private Networks.
25+
- The deletion of a Private Network is prevented if it still has attached resources or reserved IPAM IPs.
26+
27+
Resources (Instances, Managed Databases, Elastic Metal servers, etc.) are attached to **Private Networks**, also known as subnets.
28+
29+
Private Networks are created inside a single VPC. One VPC can contain many Private Networks.
30+
31+
## I can't delete my VPC
32+
33+
### VPC deletion problems
34+
35+
You may be attempting to delete your VPC via the [Scaleway console](/vpc/how-to/delete-vpc/), [API](https://www.scaleway.com/en/developers/api/vpc/#path-vpcs-delete-a-vpc) or other developer tool, and see one of the following error messages:
36+
37+
- `resource_still_in_use`
38+
- `Detach resources from this VPC in order to delete it`
39+
- `VPC must be empty to be deleted`
40+
- `precondition failed: resource is still in use`
41+
42+
### VPC deletion solutions
43+
44+
The VPC must contain no Private Networks before you can delete it.
45+
46+
**Ensure you have deleted all the Private Networks inside the VPC**. You can see how many Private Networks are in your [VPC listing](https://console.scaleway.com/vpc/vpc) in the Scaleway console.
47+
48+
<Lightbox src="scaleway-vpc-pns.webp" alt="A screenshot of the Scaleway console highlights the Private Networks column on the VPC listing" />
49+
50+
In order to successfully delete a Private Network, you must ensure no resources are attached to it, and there are no private IPs reserved within the network. See the [information below](#i-cant-delete-my-private-network) for full details.
51+
52+
**Ensure you are not trying to delete a default VPC**. Each Scaleway Project has three auto-created default VPCs, one for each region. These VPCs cannot be deleted. They are free of charge. The existence of default VPCs does not block the deletion of a Scaleway account or Project, as long as the default VPCs do not contain Private Networks with associated/attached resources.
53+
54+
You can identify default VPCs by the **Default** badge in the VPC listing, even if you have changed the name of the VPC itself.
55+
56+
<Lightbox src="scaleway-default-vpcs.webp" alt="A screenshot of the Scaleway console highlights the DEFAULT badges next to certain VPCs on the VPC listing" />
57+
58+
## I can't delete my Private Network
59+
60+
### PN deletion problems
61+
62+
You may be attempting to delete a Private Network VPC via the [Scaleway console](/vpc/how-to/delete-private-network/), [API](https://www.scaleway.com/en/developers/api/vpc/#path-private-networks-delete-a-private-network) or other developer tool, and see one of the following error messages:
63+
64+
- `resource_still_in_use`
65+
- `Detach resources from this Private to delete it`
66+
- `Private Network must be empty to be deleted`
67+
- `precondition failed: resource_still_in_use`
68+
69+
### PN deletion solutions
70+
71+
The Private Network must have no attached or associated resources before you can delete it.
72+
73+
**Ensure you have detached all resources from the Private Network**. In the Scaleway console, you can see how many resources are attached to each Private Network in each VPC's **Private Networks** tab.
74+
75+
<Lightbox src="scaleway-pn-resources.webp" alt="A screenshot of the Scaleway console highlights the 'Resources' indicator next to each Private Network, in the Private Networks listing" />
76+
77+
If there are still attached resources, you must [detach them](/vpc/how-to/attach-resources-to-pn/#how-to-detach-a-resource-from-a-private-network) before proceeding.
78+
79+
**Ensure there are no reserved IPs in IPAM for the Private Network**. If the resource count displays as zero, but you still cannot delete your Private Network, this may be the problem.
80+
81+
- In the [IPAM section](https://console.scaleway.com/ipam/) of the Scaleway console, use the filters to select the region and VPC of your Private Network. If there are any private IPs reserved for the Private Network, release them.
82+
83+
<Lightbox src="scaleway-ipam-release-ip.webp" alt="A screenshot of the Scaleway console highlights the three dot menu next to a reserved private IP address in IPAM, with the 'Release IP' action" />
84+

0 commit comments

Comments
 (0)