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.
  • Game Services API aktivieren
  • Wählen Sie entweder eine Shell mit installierter gcloud-Befehlszeile aus oder verwenden Sie einen API-Client:
  • Cloud Shell

    So starten Sie Cloud Shell:

    1. Rufen Sie die Google Cloud Console auf.

      Google Cloud Console

    2. 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 Default-Projekt für die Google Cloud CLI festgelegt haben. Andernfalls müssen Sie das Flag --project für jeden Befehl später 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-Befehlszeile zu bestätigen. Für Game Servers ist Version 306.0.0 oder höher der gcloud-Befehlszeile 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:

    1. Erstellen Sie ein Dienstkonto:
    2. Laden Sie einen privaten Schlüssel als JSON-Datei herunter.
    3. Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad der JSON-Datei fest, die Ihren Dienstkontoschlüssel enthält. Diese Variable gilt nur für Ihre aktuelle Shellsitzung. Wenn Sie eine neue Sitzung öffnen, müssen Sie die Variable noch einmal festlegen.

    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

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

    Zu Game Servers

  2. Erweitern Sie einen Bereich, um die Game Server-Cluster anzuzeigen, zu denen sie gehören.

  3. 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 Game Servers über die Befehlszeile von Google Cloud löschen.

So löschen Sie einen globalen Cluster:

  1. 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.

  2. 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:

  1. 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.

  2. 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 UND BEFEHLSZEILE

Bevor Sie eine der Anfragedaten verwenden, nehmen Sie folgende Ersetzungen vor:

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

Sie sollten in etwa folgende JSON-Antwort 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
}

C#

Informationen zum Installieren und Verwenden der Clientbibliothek für Game Servers finden Sie unter Game Servers-Clientbibliotheken.


using Google.Cloud.Gaming.V1;
using Google.LongRunning;
using Google.Protobuf.WellKnownTypes;

public class DeleteClusterSample
{
    public void DeleteCluster(
        string projectId, string regionId, string realmId, string clusterId)
    {
        // Create the client.
        GameServerClustersServiceClient client = GameServerClustersServiceClient.Create();

        DeleteGameServerClusterRequest request = new DeleteGameServerClusterRequest
        {
            GameServerClusterName = GameServerClusterName.FromProjectLocationRealmCluster(projectId, regionId, realmId, clusterId)
        };

        // Make the request.
        Operation<Empty, OperationMetadata> response = client.DeleteGameServerCluster(request);

        // Poll until the returned long-running operation is complete.
        response.PollUntilCompleted();
    }
}

Go

Informationen zum Installieren und Verwenden der Clientbibliothek für Game Servers finden Sie unter Game Servers-Clientbibliotheken.


import (
	"context"
	"fmt"
	"io"

	gaming "cloud.google.com/go/gaming/apiv1"
	gamingpb "google.golang.org/genproto/googleapis/cloud/gaming/v1"
)

// deleteCluster unregisters a game server cluster.
func deleteCluster(w io.Writer, projectID, location, realmID, clusterID string) error {
	// projectID := "my-project"
	// location := "global"
	// realmID := "myrealm"
	// clusterID := "mycluster"
	ctx := context.Background()
	client, err := gaming.NewGameServerClustersClient(ctx)
	if err != nil {
		return fmt.Errorf("NewGameServerClustersClient: %v", err)
	}
	defer client.Close()

	req := &gamingpb.DeleteGameServerClusterRequest{
		Name: fmt.Sprintf("projects/%s/locations/%s/realms/%s/gameServerClusters/%s", projectID, location, realmID, clusterID),
	}

	op, err := client.DeleteGameServerCluster(ctx, req)
	if err != nil {
		return fmt.Errorf("DeleteGameServerCluster: %v", err)
	}
	err = op.Wait(ctx)
	if err != nil {
		return fmt.Errorf("Wait: %v", err)
	}

	fmt.Fprintf(w, "Cluster deleted.")
	return nil
}

Java

Informationen zum Installieren und Verwenden der Clientbibliothek für Game Servers finden Sie unter Game Servers-Clientbibliotheken.


import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.gaming.v1.GameServerClustersServiceClient;
import com.google.cloud.gaming.v1.OperationMetadata;
import com.google.protobuf.Empty;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class DeleteCluster {

  public static void deleteGameServerCluster(
      String projectId, String regionId, String realmId, String clusterId)
      throws IOException, InterruptedException, ExecutionException, TimeoutException {
    // String projectId = "your-project-id";
    // String regionId = "us-central1-f";
    // String clusterId = "your-game-server-cluster-id";
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (GameServerClustersServiceClient client = GameServerClustersServiceClient.create()) {
      String parent =
          String.format("projects/%s/locations/%s/realms/%s", projectId, regionId, realmId);
      String clusterName = String.format("%s/gameServerClusters/%s", parent, clusterId);

      OperationFuture<Empty, OperationMetadata> call =
          client.deleteGameServerClusterAsync(clusterName);

      call.get(1, TimeUnit.MINUTES);
      System.out.println("Game Server Cluster deleted: " + clusterName);
    }
  }
}

Node.js

Informationen zum Installieren und Verwenden der Clientbibliothek für Game Servers finden Sie unter Game Servers-Clientbibliotheken.

const {
  GameServerClustersServiceClient,
} = require('@google-cloud/game-servers');

const client = new GameServerClustersServiceClient();

async function deleteGameServerCluster() {
  /**
   * TODO(developer): Uncomment these variables before running the sample.
   */
  // const projectId = 'Your Google Cloud Project ID';
  // const location = 'A Compute Engine region, e.g. "us-central1"';
  // const realmId = 'The ID of the realm to locate this cluster in';
  // const gameClusterId = 'The unique ID for this Game Server Cluster';
  const request = {
    // Provide full resource name of a Game Server Realm
    name: client.gameServerClusterPath(
      projectId,
      location,
      realmId,
      gameClusterId
    ),
  };

  const [operation] = await client.deleteGameServerCluster(request);
  await operation.promise();

  console.log('Game Server cluster deleted');
}

deleteGameServerCluster();

Python

Informationen zum Installieren und Verwenden der Clientbibliothek für Game Servers finden Sie unter Game Servers-Clientbibliotheken.

def delete_cluster(project_id, location, realm_id, cluster_id):
    """Deletes a game server cluster."""

    client = gaming.GameServerClustersServiceClient()

    request = game_server_clusters.DeleteGameServerClusterRequest(
        name=f"projects/{project_id}/locations/{location}/realms/{realm_id}/gameServerClusters/{cluster_id}",
    )

    operation = client.delete_game_server_cluster(request)
    print(f"Delete cluster operation: {operation.operation.name}")
    operation.result(timeout=120)

Prüfen, ob der Cluster gelöscht wurde

Prüfen Sie, ob Sie den Cluster erfolgreich gelöscht haben, indem Sie Ihre globalen oder regionalen Cluster über die Google Cloud-Befehlszeile auflisten.

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.

Weitere Informationen

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