Instanzen löschen

MySQL | PostgreSQL | SQL Server

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.
Erstellen Sie ein Replikat, um die Wahrscheinlichkeit zu verringern, dass eine Instanz versehentlich gelöscht wird. Ein Replikat muss dann vor der primären Instanz 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 eine Woche 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.

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

Bestätigen Sie vor dem Löschen einer Instanz, ob dies sicher ist. Bestätigen Sie dann, dass der Löschschutz deaktiviert ist.

Console

Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
Klicken Sie auf Löschen.
Klicken Sie im Dialogfeld Datenbankinstanz löschen auf OK.

gcloud

Löschen Sie die Instanz.

gcloud sql instances delete INSTANCE_NAME

REST Version 1

Löschen Sie die Instanz.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
instance-id: die Instanz-ID

HTTP-Methode und URL:

DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie diesen Befehl aus:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

PowerShell (Windows)

Führen Sie diesen Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/var>instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Löschen Sie die Instanz.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
instance-id: die Instanz-ID

HTTP-Methode und URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

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

curl (Linux, macOS oder Cloud Shell)

Führen Sie diesen Befehl aus:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

Führen Sie diesen Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Sie müssten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/var>instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Weitere Informationen zur Struktur der zugrunde liegenden REST API-Anfrage für diese Aufgabe finden Sie auf der Seite „Instances:delete“ im APIs Explorer.