NLB löschen

STACKIT Network Load Balancer (NLBs) können über das STACKIT Portal, die STACKIT API oder den STACKIT Terraform Provider gelöscht werden.

Vorbereitung

Bevor Sie einen NLB löschen, beachten Sie Folgendes, um unbeabsichtigte Ausfälle zu vermeiden:

• Auswirkungen auf den Datenverkehr: Das Löschen eines NLB stoppt die Weiterleitung des Datenverkehrs sofort. Planen Sie die Umstellung und aktualisieren Sie DNS-, Client- oder Firewall-Regeln entsprechend.
• IP-Adressen: Wenn der NLB eine separat verwaltete Public IP verwendet hat, entscheiden Sie, ob Sie diese trennen und wiederverwenden oder löschen möchten. Private Adressen sind kurzlebig.
• Sicherheitsgruppen und Regeln: Wenn Sie die Sicherheitsgruppe des NLB in anderen Regeln referenziert haben, bereinigen Sie diese nach dem Löschen.
• Observability-Anmeldedaten: Alle Observability-Anmeldedaten, die Sie speziell für diesen NLB erstellt haben, können unabhängig davon entfernt werden, wenn sie nicht mehr benötigt werden.

Ablauf

Folgen Sie den nachstehenden Schritten, um einen NLB mit Ihrer bevorzugten Methode zu löschen:

Über das Portal

Besuchen Sie das STACKIT Portal, wählen Sie Ihr gewünschtes Projekt aus und folgen Sie diesen Schritten:

1. Klicken Sie in der Seitenleiste unter Networking auf Network Load Balancer.
2. Suchen Sie den NLB, den Sie löschen möchten, und öffnen Sie dessen Details oder verwenden Sie das Aktionsmenü.
3. Klicken Sie auf Delete und bestätigen Sie die Löschung im Dialog.

Nach der Bestätigung werden der NLB und seine zugehörigen Knoten und Sicherheitsgruppen in Kürze entfernt.

Über die API

Voraussetzungen

Um einen STACKIT Network Load Balancer über die API zu löschen, benötigen Sie ein temporäres Bearer-Token zur Authentifizierung unter einem Service-Konto.

• Lesen Sie Dienste mit einem Service-Konto nutzen, um zu erfahren, wie Sie ein Service-Konto erstellen und ein Bearer-Token generieren.
• Lesen Sie den STACKIT CLI Authentication Guide, um mehr über CLI- und Umgebungskonfigurationen zu erfahren, mit denen Sie Bearer-Tokens erhalten können.
• Beachten Sie die STACKIT Network Load Balancer API-Dokumentation für Endpunkt-Details.

Anfragedetails

Methode: DELETE

Endpunkt-URL:

https://load-balancer.api.stackit.cloud/v2/projects/{projectId}/regions/{region}/load-balancers/{name}

Header:

• Authorization: Bearer <Ihr_Bearer_Token>

Beispiel mit cURL:

curl -X DELETE \
    "https://load-balancer.api.stackit.cloud/v2/projects/$PROJECT_ID/regions/$REGION/load-balancers/$LB_NAME" \
    -H "Authorization: Bearer $TOKEN"

Bei Erfolg gibt die API 200 OK mit einem leeren Body zurück. Der NLB wird kurz nach der Annahme der Anfrage gelöscht.

Über Terraform

Wenn Sie Ihre Infrastruktur deklarativ mit Terraform und dem offiziellen STACKIT Terraform Provider verwalten, löschen Sie den NLB, indem Sie die Ressource aus dem Code entfernen oder direkt zerstören.

Minimale Ressourcendefinition als Referenz:

resource "stackit_loadbalancer" "example" {
    project_id = "Ihre-Projekt-UUID"
    name       = "example-load-balancer"

    networks = [
        {
            network_id = "Ihre-Netzwerk-UUID"
            role       = "ROLE_LISTENERS_AND_TARGETS"
        }
    ]
    options = {
        private_network_only = true
    }

    target_pools = [
        {
            name        = "example-pool"
            target_port = 80
            targets = [
                {
                    display_name = "target-1"
                    ip           = "10.0.0.1"
                }
            ]
        }
    ]

    listeners = [
        {
            display_name = "example-listener"
            port         = 80
            protocol     = "PROTOCOL_TCP"
            target_pool  = "example-pool"
        }
    ]
}

Sie können den NLB auf zwei gängige Arten löschen:

1. Entfernen Sie die stackit_loadbalancer-Ressource aus Ihrem Terraform-Code und führen Sie terraform apply aus, um den Zustand abzugleichen.
2. Führen Sie eine gezielte Löschung aus: terraform destroy -target=stackit_loadbalancer.example.

Wenn Sie eine separate stackit_public_ip oder andere zugehörige Ressourcen erstellt haben, entscheiden Sie, ob Sie diese im Rahmen der Bereinigung behalten oder ebenfalls löschen möchten.