Diese Seite wurde von der Cloud Translation API übersetzt.

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.
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.
Erstellen Sie für den Fall der Fälle eine abschließende 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 mit der Google Cloud Console, der 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. Wir empfehlen Ihnen außerdem dringend, vor dem Löschen eine letzte Sicherung der Instanz zu erstellen.

Wenn Sie Ihre Instanz mit dem Cloud Key Management Service verschlüsselt haben, aber nicht auf die KMS-Schlüssel zugreifen können, hat die endgültige Sicherung nach dem Löschen der Instanz den Status FAILED. Wenden Sie sich in diesem Fall innerhalb von vier Tagen nach dem Löschen der Instanz an den Cloud Customer Care, um die Wiederherstellung zu beantragen.

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.
Die Verbindung zum Endpunkt hat eine Zeitüberschreitung.

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

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.
Führen Sie im Dialogfeld Instanz löschen die folgenden Schritte aus:

Geben Sie im Textfeld die angezeigte Instanz-ID ein.
Wenn Sie eine abschließende Sicherung der Instanz erstellen möchten, lassen Sie das Kästchen Abschließende Sicherung erstellen angeklickt, maximieren Sie das Menü Aufbewahrungsoptionen und geben Sie im Feld Aufbewahren für die Anzahl der Tage ein, für die die abschließende 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 abschließende Sicherung zu erstellen, entfernen Sie das Häkchen.
Geben Sie im Textfeld Sicherung beschreiben eine Beschreibung der Sicherung ein.
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 ist die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält, die Sie löschen möchten

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

--enable-final-backup: Legen Sie den Wert dieses Flags auf true fest, um eine abschließende Sicherung durchzuführen. Wenn Sie die Instanz löschen möchten, ohne ein letztes Back-up zu erstellen, legen Sie den Wert auf false fest.
--final-backup-description: Details zur endgültigen Sicherung angeben. In der Standardeinstellung ist dieser Wert leer.
--final-backup-ttl-days: Geben Sie die Anzahl der Tage an, für die die endgültige Sicherung aufbewahrt werden soll. Dieser Wert wird als Gültigkeitsdauer (TTL) bezeichnet. Der Standardwert ist 30 Tage. Die zulässige Aufbewahrungsdauer variiert zwischen 1 und 365 Tagen. Verwenden Sie entweder dieses Flag oder --final-backup-expiry-time, um die Aufbewahrungsdauer anzugeben.
--final-backup-expiry-time: Dies ist ein Zeitstempel (in UTC), der angibt, wann die Sicherung ablaufen soll. Dieser Zeitraum darf ein Jahr nicht überschreiten. Verwenden Sie entweder dieses Flag oder --final-backup-ttl-days, um die Aufbewahrungsdauer anzugeben.

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.

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

enable_final_backup: Legen Sie den Wert dieses Parameters auf true fest, um eine letzte Sicherung durchzuführen. Wenn Sie die Instanz löschen möchten, ohne ein letztes Back-up zu erstellen, legen Sie den Wert auf false fest.
final_backup_description: Details zur endgültigen Sicherung angeben. In der Standardeinstellung ist dieser Wert leer.
final_backup_ttl_days: Geben Sie die Anzahl der Tage an, für die die endgültige Sicherung aufbewahrt werden soll. Dieser Wert wird als Gültigkeitsdauer (TTL) bezeichnet. Der Standardwert ist 30 Tage. Die zulässige Aufbewahrungsdauer variiert zwischen 1 und 365 Tagen. Verwenden Sie entweder diesen Parameter oder final_backup_expiry_time, um die Aufbewahrungsdauer anzugeben.
final_backup_expiry_time: Dies ist ein Zeitstempel (in UTC), der angibt, wann die Sicherung ablaufen soll. Dieser Zeitraum darf ein Jahr nicht überschreiten. Verwenden Sie entweder diesen Parameter oder final_backup_ttl_days, um die Aufbewahrungsdauer 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 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": "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 "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.

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

enable_final_backup: Legen Sie den Wert dieses Parameters auf true fest, um eine letzte Sicherung durchzuführen. Wenn Sie die Instanz löschen möchten, ohne ein letztes Back-up zu erstellen, legen Sie den Wert auf false fest.
final_backup_description: Details zur endgültigen Sicherung angeben. In der Standardeinstellung ist dieser Wert leer.
final_backup_ttl_days: Geben Sie die Anzahl der Tage an, für die die endgültige Sicherung aufbewahrt werden soll. Dieser Wert wird als Gültigkeitsdauer (TTL) bezeichnet. Der Standardwert ist 30 Tage. Die zulässige Aufbewahrungsdauer variiert zwischen 1 und 365 Tagen. Verwenden Sie entweder diesen Parameter oder final_backup_expiry_time, um die Aufbewahrungsdauer anzugeben.
final_backup_expiry_time: Dies ist ein Zeitstempel (in UTC), der angibt, wann die Sicherung ablaufen soll. Dieser Zeitraum darf ein Jahr nicht überschreiten. Verwenden Sie entweder diesen Parameter oder final_backup_ttl_days, um die Aufbewahrungsdauer 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)

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)

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": "user@example.com",
  "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, werden in Cloud SQL alle Ressourcen für die Instanz gelöscht, einschließlich On-Demand-Sicherungen und automatischer Sicherungen.

Wenn Sie beim Löschen einer Instanz eine abschließende Sicherung erstellen, können Sie diese Sicherung verwenden, um die Instanz wiederherzustellen. Dazu können Sie entweder eine Instanz aus der abschließenden Sicherung erstellen oder die abschließende Sicherung in einer vorhandenen Instanz wiederherstellen.

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

Wenn Sie eine Instanz versehentlich löschen, ohne ein finales Back-up zu erstellen, können Sie die Wiederherstellung der Instanz beantragen. Wenden Sie sich dazu innerhalb von vier Tagen nach dem Löschen der Instanz an den Cloud-Kundensupport. Wenn die Instanz wiederhergestellt werden kann, werden die Instanzkonfiguration und die vor dem Löschen verwendeten IP-Adressen wiederhergestellt. Außerdem werden alle Sicherungen wiederhergestellt, die zum Zeitpunkt des Löschens verfügbar waren.