Bereich löschen

Auf dieser Seite wird gezeigt, wie Sie einen Game Servers-Bereich 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 zur Installation von gcloud das Cloud SDK. Darin ist das gcloud-Befehlszeilentool enthalten.

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

Bereich löschen

Console

  1. Rufen Sie in der Cloud Console die Seite Bereich & Cluster auf.

    Zu Game Servers

  2. Mit dem Filterfeld können Sie die Bereichsliste nach verschiedenen Attributen filtern.

  3. Klicken Sie in der letzten Tabellenspalte auf die drei Punkte und wählen Sie Bereich entfernen aus.

gcloud

Sie können globale oder regionale Bereiche mit dem gcloud-Befehlszeilentool löschen.

Führen Sie den folgenden Befehl aus, um einen globalen Bereich zu löschen, und ersetzen Sie realmID durch die ID für einen von Ihnen erstellten Bereich:

gcloud game servers realms delete realmID

Führen Sie den folgenden Befehl aus, um einen regionalen Bereich zu löschen und ersetzen Sie die Platzhalterwerte wie realmID durch die entsprechenden Werte:

gcloud game servers realms delete realmID --location=region

Die Variablenplatzhalter entsprechen den folgenden Beschreibungen:

  • realmID ist die eindeutige Kennung für einen Bereich.
  • region ist die Region des Bereichs, falls vorhanden.

REST UND BEFEHLSZEILE

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud-Projekt-ID, die unter IAM-Einstellungen aufgeführt ist.
  • LOCATION: Region für den Bereich oder global
  • REALM_ID: eine benutzerdefinierte Kennung für den Bereich

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

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",
    "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 DeleteRealmSample
{
    public void DeleteRealm(
        string projectId, string regionId, string realmId)
    {
        // Create the client.
        RealmsServiceClient client = RealmsServiceClient.Create();

        DeleteRealmRequest request = new DeleteRealmRequest
        {
            RealmName = RealmName.FromProjectLocationRealm(projectId, regionId, realmId)
        };

        // Make the request.
        Operation<Empty, OperationMetadata> response = client.DeleteRealm(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"
)

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

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

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

	fmt.Fprintf(w, "Realm 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.OperationMetadata;
import com.google.cloud.gaming.v1.RealmsServiceClient;
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 DeleteRealm {
  public static void deleteRealm(String projectId, String regionId, String realmId)
      throws InterruptedException, ExecutionException, TimeoutException, IOException {
    // String projectId = "your-project-id";
    // String regionId = "us-central1-f";
    // String realmId = "your-realm-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 (RealmsServiceClient client = RealmsServiceClient.create()) {
      String parent = String.format("projects/%s/locations/%s", projectId, regionId);
      String realmName = String.format("%s/realms/%s", parent, realmId);

      OperationFuture<Empty, OperationMetadata> call = client.deleteRealmAsync(realmName);

      call.get(1, TimeUnit.MINUTES);
      System.out.println("Realm deleted: " + realmName);
    }
  }
}

Node.js

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

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

const client = new RealmsServiceClient();

async function deleteRealm() {
  /**
   * 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 = 'Unique identifier of the realm';
  const request = {
    // Realm name is the full resource name including project ID,location,
    // and the realm ID.
    name: client.realmPath(projectId, location, realmId),
  };

  const [operation] = await client.deleteRealm(request);
  await operation.promise();
  console.log(`Realm with ID ${realmId} deleted.`);
}

deleteRealm();

Python

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

def delete_realm(project_id, location, realm_id):
    """Deletes a realm."""

    client = gaming.RealmsServiceClient()

    request = realms.DeleteRealmRequest(
        name=f"projects/{project_id}/locations/{location}/realms/{realm_id}",
    )

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

Prüfen, ob der Bereich gelöscht wurde

Um zu prüfen, ob Sie den Bereich gelöscht haben, listen Sie Ihre globalen oder regionalen Bereiche mit dem gcloud-Befehlszeilentool auf.

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

gcloud game servers realms list

Führen Sie den folgenden Befehl aus und ersetzen Sie region durch die Region, die Sie auflisten möchten, um Bereiche in einer Region aufzulisten:

gcloud game servers realms list --location=region

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

Nächste Schritte

Weitere Informationen zu Audit-Logging.