Instanzen löschen

MySQL   |  PostgreSQL   |  SQL Server

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

Warnung: Durch das Löschen einer Instanz werden alle Daten dieser Instanz dauerhaft gelöscht, einschließlich ihrer Sicherungen. Wenn Sie die Daten behalten möchten, exportieren Sie diese in Cloud Storage, bevor Sie sie löschen. Die Rolle "Cloud SQL-Administrator" enthält die Berechtigung zum Löschen der Instanz. Gewähren Sie diese Rolle nur, wenn nötig, um ein versehentliches Löschen zu vermeiden. Ziehen Sie außerdem den Löschschutz in Betracht.

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

gcloud CLI oder der API löschen.

Hinweis: Prüfen Sie vor dem Löschen einer Instanz, ob dies sicher ist. Prüfen Sie dann, ob der Löschschutz für die Instanz deaktiviert ist.

Wenn Sie eine Instanz löschen, für die Private Service Connect aktiviert ist, werden die folgenden Aktionen ausgeführt:

• Der Dienstanhang wird automatisch entfernt. Der Private Service Connect-Endpunkt, der auf den Dienstanhang verweist, wird jedoch nicht automatisch gelöscht. Wenn Sie die dem Endpunkt zugeordnete Weiterleitungsregel auflisten, sehen Sie, dass die Regel den Status CLOSED hat. Nachdem dieser Status erhalten wurde, können Sie den Endpunkt löschen.
• Sie sehen, dass die Verbindung zum Endpunkt abgelaufen ist.

Damit keine zusätzlichen Kosten anfallen, empfehlen wir Ihnen dringend, auch die entsprechende DNS-Zone und den entsprechenden DNS-Eintrag zu löschen.

Console

1. Wechseln Sie in der Google Cloud Console zur 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. Klicken Sie im Dialogfeld Datenbankinstanz löschen auf OK.

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 ist der Name der Instanz.
• PROJECT_ID ist die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält, die Sie löschen möchten

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID ist die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält, die Sie löschen möchten
• INSTANCE_NAME ist 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:

curl (Linux, macOS oder Cloud Shell)

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

Führen Sie folgenden Befehl aus:

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

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden 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_NAME" | Select-Object -Expand Content

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": "[e-mail]",
  "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 "Instances: delete" im APIs Explorer.

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID ist die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält, die Sie löschen möchten
• INSTANCE_NAME ist 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:

curl (Linux, macOS oder Cloud Shell)

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

Führen Sie folgenden Befehl aus:

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

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden 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_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/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 "Instances: delete" im APIs Explorer.