Instanzen löschen

Auf dieser Seite wird beschrieben, wie Sie Cloud SQL-Instanzen löschen.

Beachten Sie beim Löschen einer Instanz Folgendes:

  • Instanzen mit Replikaten können nicht gelöscht werden. Es müssen zuerst alle Replikate gelöscht werden.
  • Nach dem Löschen einer Instanz wird sie in Ihrem Projekt eventuell mit einer "unbekannten" Größe und mit dem Status "Wird gelöscht" angezeigt. Das ist normal und die Instanz verschwindet nach kurzer Zeit vollständig.
  • Es kann bis zu vier Tage dauern, bis die zugrunde liegenden Ressourcen einer Instanz vollständig gelöscht wurden. Eine Ausnahme sind Lesereplikate, die oft innerhalb weniger Minuten gelöscht werden.
  • Der gelöschte Instanzname kann sofort wiederverwendet werden, um eine neue Instanz zu erstellen.
  • Wenn der Löschschutz für eine Instanz aktiviert ist, müssen Sie diesen vor dem Löschen der Instanz deaktivieren.
  • Erstellen Sie im Notfall eine letzte Sicherung, um die gelöschte Instanz wiederherzustellen.

Erforderliche Berechtigungen

Standardmäßig haben nur Nutzer oder Dienstkonten mit der Rolle Cloud SQL Admin (roles/cloudsql.admin) oder Owner (roles/owner) die Berechtigung zum Löschen einer Cloud SQL-Instanz (cloudsql.instances.delete).

Sie können auch eine benutzerdefinierte IAM-Rolle für das Nutzer- oder Dienstkonto definieren, die die Berechtigung cloudsql.instances.delete enthält. Diese Berechtigung wird in benutzerdefinierten IAM-Rollen unterstützt.

Instanz löschen

Sie können eine Cloud SQL-Instanz über die Google Cloud console, gcloud CLI oder die API löschen. Wenn Sie vor dem Löschen Sicherungen für Ihre Instanz aufbewahren möchten, lesen Sie Aufbewahrte Sicherungen verwalten.

Console

  1. Öffnen Sie in der Google Cloud console die Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
  3. Klicken Sie auf Löschen.
  4. Führen Sie im Dialogfeld Instanz löschen die folgenden Schritte aus:
    1. Geben Sie im Textfeld die angezeigte Instanz-ID ein.

    2. Wenn Sie eine letzte Sicherung der Instanz erstellen möchten, lassen Sie das Kästchen Letzte Sicherung erstellen ausgewählt, maximieren Sie das Menü Aufbewahrungsoptionen und geben Sie dann im Feld Aufbewahren für die Anzahl der Tage ein, für die die letzte Sicherung aufbewahrt werden soll. Sie können einen Zeitraum von 1 bis 365 Tagen angeben.

      Wenn Sie die Instanz löschen möchten, ohne eine letzte Sicherung zu erstellen, entfernen Sie das Häkchen aus dem Kästchen.

    3. Im Textbereich Diese Sicherung beschreiben können Sie eine Beschreibung der Sicherung eingeben.
    4. Klicken Sie auf Löschen.

gcloud

Verwenden Sie den Befehl gcloud sql instances delete, um eine Instanz zu löschen:

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

Ersetzen Sie die folgenden Werte:

  • INSTANCE_NAME: der Name der Instanz
  • PROJECT_ID: die ID oder Projektnummer des Google Cloud Projekts, das die Instanz enthält, die Sie löschen möchten

REST Version 1

Ersetzen Sie vor der Verwendung von Anfragedaten, die folgenden Werte:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud Projekts, das die Instanz enthält, die Sie löschen möchten
  • INSTANCE_NAME: der Name der Instanz

HTTP-Methode und URL: 

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
Informationen zur Struktur der zugrunde liegenden REST API-Anfrage für diese Aufgabe finden Sie auf der Seite „Instances:delete“ im APIs Explorer.

REST v1beta4

Ersetzen Sie vor der Verwendung von Anfragedaten, die folgenden Werte:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud Projekts, das die Instanz enthält, die Sie löschen möchten
  • INSTANCE_NAME: der Name der Instanz

HTTP-Methode und URL: 

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen: