Delete a connection

Deleting a VPN connection permanently removes the IPSec tunnels between your STACKIT VPN gateway and the remote peer. This action releases the associated virtual resources and stops any active traffic flow.

If you proceed with the action described here, your data will be lost irrevocably.

Please check carefully,

• which of your data are affected,
• if those data are still in use or otherwise required to be present in your organization,
• and if a backup on your side is necessary, if it exists and if it is up to date and in usable condition.

Do not proceed unless you have checked the above points thoroughly and are authorized within your organization to delete the data.

Prerequisites

Before you delete a connection, ensure the following:

• You have the projectId, region, gatewayId and connectionId of the resource you want to remove.
• You have notified any affected teams, as this action immediately terminates the encrypted tunnel.

API

Identify the connection

To delete a specific connection, you need its unique identifier.

1. Retrieve a list of all connections for your gateway:

   GET /v1beta1/projects/{projectId}/regions/{region}/gateways/{gatewayId}/connections

2. Locate the connection in the response and copy the id value.

Delete the connection

To remove the resource, send a DELETE request to the connection endpoint.

1. Send the request to the following endpoint:

   DELETE /v1beta1/projects/{projectId}/regions/{region}/gateways/{gatewayId}/connections/{connectionId}

Portal

Visit the STACKIT Portal, select your desired project and follow these steps:

1. In the sidebar under Networking, click on VPN.
2. Locate the VPN Gateway you want to delete a connection from and open its details by clicking on the respective gateway.
3. In the sidebar click on Connections.
4. Locate the VPN Connection you want to delete and open its details or use the actions menu.
5. Click Delete and confirm the deletion in the dialog.

Once confirmed, the VPN Connection will be removed shortly. You can see the lifecycle state of the VPN Connection in the VPN Connection overview.

CLI

CLI functions not yet available.

Terraform

Terraform functions not yet available.

Verify deletion

Once the request is sent, the system initiates the deprovisioning process.

• Check the status: The connection status transitions to DELETING.
• Final confirmation: After the process completes, the connection is removed from the list.

If the status remains in DELETING for an extended period or transitions to ERROR, please contact the STACKIT support team.