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:

• 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.
• Nehmen Sie für den Fall der Fälle eine letzte Sicherung vor, 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 behalten möchten, lesen Sie Aufbewahrte Sicherungen verwalten.

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. Außerdem empfehlen wir dringend, vor dem Löschen eine letzte Sicherung der Instanz zu erstellen.

Wenn Sie Cloud Key Management Service zum Verschlüsseln Ihrer Instanz verwendet haben, aber die KMS-Schlüssel nicht zugänglich sind, hat die letzte Sicherung nach dem Löschen der Instanz den Status FAILED. In diesem Fall können Sie die Wiederherstellung Ihrer Instanz anfordern, indem Sie sich innerhalb von vier Tagen nach dem Löschen der Instanz an den Cloud Customer Care wenden.

Wenn Sie eine Instanz löschen, für die Private Service Connect aktiviert ist, geschieht Folgendes:

• Die Dienstanhänge werden 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.
• Die Verbindung zum Endpunkt wird nach einer Zeitüberschreitung beendet.

Um zusätzliche Kosten zu vermeiden, empfehlen wir dringend, auch die entsprechende DNS-Zone und den DNS-Eintrag zu löschen.

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, deaktivieren Sie das 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 ist 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.

Hinweis : Wenn Sie eine letzte Sicherung der Instanz erstellen möchten, verwenden Sie die folgenden Flags:

• --enable-final-backup: Setzen Sie den Wert dieses Flags auf true, um eine letzte Sicherung zu erstellen. Wenn Sie die Instanz löschen möchten, ohne eine letzte Sicherung zu erstellen, setzen Sie den Wert auf false.
• --final-backup-description: Geben Sie Details zur letzten Sicherung an. In der Standardeinstellung ist dieser Wert leer.
• --final-backup-ttl-days: Geben Sie die Anzahl der Tage an, für die die letzte Sicherung aufbewahrt werden soll. Dies wird als Gültigkeitsdauer (Time to Live, TTL) bezeichnet. Der Standardwert ist 30 Tage. Der zulässige Aufbewahrungszeitraum variiert zwischen 1 und 365 Tagen. Verwenden Sie entweder dieses Flag oder --final-backup-expiry-time, um den Aufbewahrungszeitraum anzugeben.
• --final-backup-expiry-time: Dies ist ein Zeitstempel (in UTC), an dem die Sicherung abläuft. Dieser Zeitraum darf ein Jahr nicht überschreiten. Verwenden Sie entweder dieses Flag oder --final-backup-ttl-days, um den Aufbewahrungszeitraum anzugeben.

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: 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.

Hinweis: Wenn Sie eine letzte Sicherung der Instanz erstellen möchten, verwenden Sie die folgenden Abfrageparameter:

• enable_final_backup: Setzen Sie den Wert dieses Parameters auf true, um eine letzte Sicherung zu erstellen. Wenn Sie die Instanz löschen möchten, ohne eine letzte Sicherung zu erstellen, setzen Sie den Wert auf false.
• final_backup_description: Geben Sie Details zur letzten Sicherung an. In der Standardeinstellung ist dieser Wert leer.
• final_backup_ttl_days: Geben Sie die Anzahl der Tage an, für die die letzte Sicherung aufbewahrt werden soll. Dies wird als Gültigkeitsdauer (Time to Live, TTL) bezeichnet. Der Standardwert ist 30 Tage. Der zulässige Aufbewahrungszeitraum variiert zwischen 1 und 365 Tagen. Verwenden Sie entweder diesen Parameter oder final_backup_expiry_time, um den Aufbewahrungszeitraum anzugeben.
• final_backup_expiry_time: Dies ist ein Zeitstempel (in UTC), an dem die Sicherung abläuft. Dieser Zeitraum darf ein Jahr nicht überschreiten. Verwenden Sie entweder diesen Parameter oder final_backup_ttl_days, um den Aufbewahrungszeitraum anzugeben.

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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, 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 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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. 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: 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.

Hinweis: Wenn Sie eine letzte Sicherung der Instanz erstellen möchten, verwenden Sie die folgenden Abfrageparameter:

• enable_final_backup: Setzen Sie den Wert dieses Parameters auf true, um eine letzte Sicherung zu erstellen. Wenn Sie die Instanz löschen möchten, ohne eine letzte Sicherung zu erstellen, setzen Sie den Wert auf false.
• final_backup_description: Geben Sie Details zur letzten Sicherung an. In der Standardeinstellung ist dieser Wert leer.
• final_backup_ttl_days: Geben Sie die Anzahl der Tage an, für die die letzte Sicherung aufbewahrt werden soll. Dies wird als Gültigkeitsdauer (Time to Live, TTL) bezeichnet. Der Standardwert ist 30 Tage. Der zulässige Aufbewahrungszeitraum variiert zwischen 1 und 365 Tagen. Verwenden Sie entweder diesen Parameter oder final_backup_expiry_time, um den Aufbewahrungszeitraum anzugeben.
• final_backup_expiry_time: Dies ist ein Zeitstempel (in UTC), an dem die Sicherung abläuft. Dieser Zeitraum darf ein Jahr nicht überschreiten. Verwenden Sie entweder diesen Parameter oder final_backup_ttl_days, um den Aufbewahrungszeitraum anzugeben.

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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, 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 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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. 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.

Gelöschte Instanz wiederherstellen

Wenn Sie eine Instanz löschen, löscht Cloud SQL alle Ressourcen für die Instanz, einschließlich On-Demand-Sicherungen und automatischer Sicherungen.

Wenn Sie im Rahmen des Löschens einer Instanz eine letzte Sicherung erstellen, können Sie diese Sicherung verwenden, um die Instanz wiederherzustellen. Dazu erstellen Sie entweder eine Instanz aus der letzten Sicherung oder stellen die letzte Sicherung in einer vorhandenen Instanz wieder her.

Wenn Sie eine letzte Sicherung verwenden, um Ihre Instanz wiederherzustellen, hat die Instanz möglicherweise eine andere IP-Adresse als die ursprüngliche, gelöschte Instanz.

Wenn Sie eine Instanz versehentlich löschen, ohne eine letzte Sicherung zu erstellen, können Sie die Wiederherstellung der Instanz anfordern, indem Sie sich innerhalb von vier Tagen nach dem Löschen der Instanz an den Cloud Customer Care wenden. Wenn die Instanz wiederhergestellt werden kann, wird die Instanzkonfiguration einschließlich der vor dem Löschen verwendeten IP-Adressen wiederhergestellt. Alle zum Zeitpunkt des Löschens verfügbaren Sicherungen werden ebenfalls wiederhergestellt.