Cluster löschen

Auf dieser Seite erfahren Sie, wie Sie einen Game Servers-Cluster löschen.

Hinweis

Bevor Sie beginnen, sollten Sie sich mit den wichtigsten Konzepten in der Übersicht über Game Servers vertraut machen. Führen Sie außerdem die folgenden Aufgaben aus:

Prüfen Sie, ob die Game Services API aktiviert ist.

Spieledienst-API aktivieren

Wählen Sie eine Shell mit installierter gcloud CLI aus oder verwenden Sie einen API-Client:

Cloud Shell

So starten Sie Cloud Shell:

Rufen Sie die Google Cloud Console auf.

Google Cloud Console
Klicken Sie in der oberen rechten Ecke der Console auf die Schaltfläche Cloud Shell aktivieren:

In einem Frame im unteren Teil der Console wird eine Cloud Shell-Sitzung geöffnet. Mit dieser Shell führen Sie gcloud-Befehle aus.

Lokale Shell

Installieren Sie die gcloud CLI.

Prüfen Sie, ob Sie das gewünschte Standardprojekt für die Google Cloud CLI festgelegt haben. Andernfalls müssen Sie das Flag --project später für jeden Befehl explizit angeben:

gcloud config list project

Wenn Sie den folgenden Befehl nicht ausführen können, um ein Standardprojekt festzulegen, ersetzen Sie PROJECT_ID durch Ihre gewünschte Projekt-ID:

gcloud config set project PROJECT_ID

Führen Sie den folgenden Befehl aus, um Ihre Version der Google Cloud CLI zu verifizieren. Für Game Servers ist Version 306.0.0 oder höher der gcloud CLI erforderlich.

gcloud version

Aktualisieren Sie Ihre Installation mit dem folgenden Befehl:

gcloud components update

curl / PowerShell

So verwenden Sie die REST API mit curl oder Windows PowerShell:

Erstellen Sie ein Dienstkonto:
Laden Sie einen privaten Schlüssel als JSON-Datei herunter.
Legen Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS auf den Pfad der JSON-Datei fest, die Ihre Anmeldedaten enthält. Diese Variable gilt nur für Ihre aktuelle Shell-Sitzung. Wenn Sie eine neue Sitzung öffnen, müssen Sie die Variable neu festlegen.
Beispiel: Linux oder macOS
```
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Geben Sie für KEY_PATH den Dateipfad der JSON-Datei an, die Ihre Anmeldedaten enthält.

Beispiel:
```
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
```
Beispiel: Windows

Für PowerShell:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Geben Sie für KEY_PATH den Dateipfad der JSON-Datei an, die Ihre Anmeldedaten enthält.

Beispiel:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
```
Für Eingabeaufforderung:
```
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
```
Geben Sie für KEY_PATH den Dateipfad der JSON-Datei an, die Ihre Anmeldedaten enthält.

Clientbibliothek

Google Cloud Game Servers können mithilfe einer Clientbibliothek programmatisch gesteuert werden. Wie Sie die Bibliothek und die Authentifizierung verwenden, erfahren Sie in der Übersicht zu Clientbibliotheken.

Cluster löschen

Durch das Löschen eines Game Servers-Clusters werden keine Ressourcen im Cluster gelöscht.

Console

Rufen Sie in der Google Cloud Console die Seite Bereiche und Cluster auf.

Zu Game Servers
Erweitern Sie einen Bereich, um die Game Server-Cluster anzuzeigen, zu denen sie gehören.
Klicken Sie in der letzten Tabellenspalte für den Cluster auf die drei Punkte und wählen Sie Spielserver-Cluster entfernen aus.

gcloud

Sie können einen globalen oder regionalen Cluster von Game Servers mit der Google Cloud CLI löschen.

So löschen Sie einen globalen Cluster:

Führen Sie den folgenden Befehl aus und ersetzen Sie die Platzhalterwerte wie clusterID und realmID durch die entsprechenden Werte:
```
gcloud game servers clusters delete clusterID --realm=realmID --dry-run
```
Die Ausgabe gibt den targetState zurück, sodass Sie sich vor dem Löschen des Clusters eine Vorschau des Vorgangs anzeigen lassen können.

Führen Sie den folgenden Befehl aus, um den Cluster zu löschen:

gcloud game servers clusters delete clusterID --realm=realmID --no-dry-run

So löschen Sie einen regionalen Cluster:

Führen Sie den folgenden Befehl aus und ersetzen Sie die Platzhalterwerte wie clusterID durch die entsprechenden Werte:
```
gcloud game servers clusters delete clusterID --realm=realmID --location=region --dry-run
```
Die Ausgabe gibt den targetState zurück, sodass Sie sich vor dem Löschen des Clusters eine Vorschau des Vorgangs anzeigen lassen können.

Führen Sie den folgenden Befehl aus, um den Cluster zu löschen:

gcloud game servers clusters delete clusterID --realm=realmID --location=region --no-dry-run

Die Variablenplatzhalter entsprechen den folgenden Beschreibungen:

clusterID ist die eindeutige Kennung, die Sie für diesen Cluster angegeben haben.
realmID ist die eindeutige Kennung, die Sie für den übergeordneten Bereich dieses Clusters angegeben haben.
region ist die Region für den Cluster, sofern vorhanden. Wählen Sie denselben Standort aus wie der des übergeordneten Bereichs.

REST

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist
REALM_LOCATION: Region für den Bereich oder global
REALM_ID: die benutzerdefinierte Kennung für den Bereich
GS_CLUSTER_ID: die benutzerdefinierte Kennung für den Cluster

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 CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI 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://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/REALM_LOCATION/realms/REALM_ID/gameServerClusters/GS_CLUSTER_ID"

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://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/REALM_LOCATION/realms/REALM_ID/gameServerClusters/GS_CLUSTER_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID/gameServerClusters/GS_CLUSTER_ID",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Prüfen, ob der Cluster gelöscht wurde

Prüfen Sie, ob der Cluster erfolgreich gelöscht wurde. Listen Sie dazu Ihre globalen oder regionalen Cluster mit der Google Cloud CLI auf.

Führen Sie den folgenden Befehl aus, um alle Cluster aufzulisten:

gcloud game servers clusters list

Um die Cluster in einer Region aufzulisten, führen Sie den folgenden Befehl aus und ersetzen Sie region durch die Region, für die Sie die Cluster auflisten möchten.

gcloud game servers clusters list --location=region

Führen Sie den folgenden Befehl aus, um alle Cluster in einem Bereich aufzulisten, und ersetzen Sie realmID durch den übergeordneten Bereich und region durch die Region des Clusters, falls vorhanden:

gcloud game servers clusters list --realm=realmID --location=region

Der gelöschte Cluster wird nicht mehr in der Ausgabe des Befehls angezeigt.

Nächste Schritte

Weitere Informationen zu Schlüsselkonzepten finden Sie in der Übersicht über Game Servers.