Borra un dominio

En esta página, se explica cómo borrar un dominio de Game Servers.

Antes de comenzar

Antes de comenzar, te recomendamos que te familiarices con los conceptos clave en la Descripción general de servidores de juegos. Asegúrate de haber realizado las siguientes tareas:

  • Asegúrate de haber habilitado la API de servicios de juego.
    • Habilitar la API de servicios de juego
  • Elige una shell con el SDK de Cloud instalado o usa un cliente de API:

    • Cloud Shell

    Para iniciar Cloud Shell, sigue estos pasos:

    1. Ve a Google Cloud Console

      Google Cloud Console

    2. Desde la esquina superior derecha de la consola, haz clic en el botón Activar Cloud Shell: .

    Se abrirá una sesión de Cloud Shell dentro de un marco en la parte inferior en la consola. Usa este shell para ejecutar los comandos de gcloud.

    Shell local

    Para instalar gcloud, instala el SDK de Cloud, que incluye la herramienta de línea de comandos de gcloud.

    Verifica que hayas configurado el proyecto predeterminado deseado para la herramienta de línea de comandos de gcloud (de lo contrario, debes especificar la marca --project de forma explícita para cada comando más adelante):

    gcloud config list project

    Si no puedes ejecutar el siguiente comando para configurar un proyecto predeterminado, reemplaza project-id por el ID del proyecto deseado:

    gcloud config set project project-id

    Ejecuta el siguiente comando para verificar tu versión del SDK de Google Cloud. Game Servers requiere la versión 306.0.0 o posterior del SDK. 

    gcloud version

    Para actualizar la instalación, ejecuta el siguiente comando:

    gcloud components update

    Biblioteca cliente

    Google Cloud Game Servers se puede controlar de manera programática mediante una biblioteca cliente. Consulta Descripción general de bibliotecas cliente a fin de obtener instrucciones para usar la biblioteca y la autenticación.

Borra un dominio

Comando de gcloud

Puedes borrar un dominio global o regional con la herramienta de línea de comandos de gcloud.

Para borrar un dominio global, ejecuta el siguiente comando y reemplaza realmID por el identificador para un dominio que creaste antes:

gcloud game servers realms delete realmID

Para borrar un dominio regional, ejecuta el siguiente comando y reemplaza los valores del marcador de posición, como realmID, con los valores apropiados:

gcloud game servers realms delete realmID --location=region

Los marcadores de posición de variables corresponden a las siguientes descripciones:

  • realmID es el identificador único de un dominio.
  • region es la región del dominio, si existe.

Go


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
}

Node.js

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

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)

Verifica que se haya borrado tu dominio

Para verificar que se borró correctamente el dominio, enumera tus dominios globales o regionales con la herramienta de línea de comandos de gcloud.

Para mostrar una lista de todos los dominios globales, ejecuta el siguiente comando:

gcloud game servers realms list

Para enumerar los dominios de una región, ejecuta el siguiente comando y reemplaza region por la región que deseas enumerar:

gcloud game servers realms list --location=region

El dominio borrado ya no aparece en el resultado del comando.

¿Qué sigue?

Obtén más información sobre el registro de auditoría.