Konfiguration löschen

Auf dieser Seite wird gezeigt, wie Sie eine Game Servers-Konfiguration 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 installiertem Cloud SDK aus oder verwenden Sie einen API-Client:
  • Cloud Shell

    So starten Sie Cloud Shell:

    1. Öffnen Sie die Google Cloud Console.

      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 zum Installieren von gcloud das Cloud SDK, das das gcloud-Befehlszeilentool enthält.

    Prüfen Sie, ob Sie das gewünschte Standardprojekt für das gcloud-Befehlszeilentool 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 des Google Cloud SDK zu prüfen. Für Game Servers ist Version 306.0.0 oder höher des SDK 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.

Konfiguration löschen

Console

  1. Rufen Sie in der Cloud Console die Seite Game Server Deployment auf.

    Zu Game Servers

  2. Suchen Sie ein Deployment in der Tabelle. Klicken Sie in der letzten Tabellenspalte auf die drei Punkte und wählen Sie Konfigurationen auflisten aus. Auf dieser Seite können Sie die aktiven und inaktiven Konfigurationen für das Deployment aufrufen.

    Sie können keine aktive Konfiguration löschen. Klicken Sie zum Deaktivieren einer Konfiguration auf Einführung verwalten und wählen Sie eine andere Konfiguration für das Rollout aus (siehe Standardkonfiguration eines Rollouts aktualisieren).

  3. Suchen Sie in der Tabelle Inaktive Konfigurationen die zu löschende Konfiguration. Klicken Sie in der letzten Tabellenspalte auf die Ellipsen und wählen Sie Konfiguration entfernen aus.

gcloud

Sie können eine Game Servers-Konfiguration mit dem gcloud-Befehlszeilentool löschen.

So löschen Sie eine Konfiguration:

  1. Führen Sie den folgenden Befehl aus und ersetzen Sie die Platzhalterwerte wie configID und deploymentID durch die entsprechenden Werte:

    gcloud game servers configs delete configID --deployment=deploymentID
    

Die Variablenplatzhalter entsprechen den folgenden Beschreibungen:

  • configID ist die eindeutige Kennung, die Sie für diese Konfiguration angegeben haben.
  • deploymentID ist die eindeutige Kennung, die Sie für das übergeordnete Deployment angegeben haben.

REST UND BEFEHLSZEILE

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud-Projekt-ID, die in den IAM-Einstellungen aufgeführt ist
  • DEPLOYMENT_ID: die benutzerdefinierte Kennung für das Deployment
  • CONFIG_ID: die benutzerdefinierte Kennung für die Konfiguration

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/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/configs/CONFIG_ID",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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"
)

// deleteGameServerConfig deletes a game server config.
func deleteGameServerConfig(w io.Writer, projectID, deploymentID, configID string) error {
	// projectID := "my-project"
	// deploymentID := "mydeployment"
	// configID := "myconfig"
	ctx := context.Background()
	client, err := gaming.NewGameServerConfigsClient(ctx)
	if err != nil {
		return fmt.Errorf("NewGameServerConfigsClient: %v", err)
	}
	defer client.Close()

	req := &gamingpb.DeleteGameServerConfigRequest{
		Name: fmt.Sprintf("projects/%s/locations/global/gameServerDeployments/%s/configs/%s", projectID, deploymentID, configID),
	}

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

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

Node.js

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

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

const client = new GameServerConfigsServiceClient();

async function deleteGameServerConfig() {
  /**
   * TODO(developer): Uncomment these variables before running the sample.
   */
  // const projectId = 'Your Google Cloud Project ID';
  // const deploymentId = 'A unique ID for the Game Server Deployment';
  // const configId = 'A unique ID for the Game Server Config';
  const request = {
    // The full resource name
    name: client.gameServerConfigPath(
      projectId,
      'global',
      deploymentId,
      configId
    ),
  };

  const [operation] = await client.deleteGameServerConfig(request);
  await operation.promise();
  console.log(`Config with name ${request.name} deleted.`);
}

deleteGameServerConfig();

Python

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

def delete_config(project_id, deployment_id, config_id):
    """Deletes a game server config."""

    client = gaming.GameServerConfigsServiceClient()

    # Location is hard coded as global, as game server configs can
    # only be created in global.  This is done for all operations on
    # game server configs.
    request = game_server_configs.DeleteGameServerConfigRequest(
        name=f"projects/{project_id}/locations/global/gameServerDeployments/{deployment_id}/configs/{config_id}",
    )

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

Prüfen, ob die Konfiguration gelöscht wurde

Prüfen Sie, ob die Konfiguration erfolgreich gelöscht wurde. Listen Sie dazu Ihre Konfigurationen mit dem gcloud-Befehlszeilentool auf.

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

gcloud game servers configs list

Führen Sie den folgenden Befehl aus, um alle Konfigurationen in einer Bereitstellung aufzulisten. Ersetzen Sie dabei deploymentID durch die übergeordnete Bereitstellung.

gcloud game servers configs list --deployment=deploymentID

Die gelöschte Konfiguration 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.