Borrar una configuración

En esta página, se explica cómo borrar una configuración 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 para juegos. Asegúrate de haber realizado las siguientes tareas:

  • Asegúrate de haber habilitado la API de los servicios de juego.
  • Habilita la API de servicios de juego
  • Elige una shell con el SDK de Cloud instalado o usa un cliente de la 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 esta 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, deberás especificar la marca --project de forma explícita para cada comando que se encuentra 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
    

    curl / PowerShell

    Para usar la API de REST con curl o Windows PowerShell, haz lo siguiente:

    1. Crea una cuenta de servicio.
    2. Descarga una clave privada como un archivo JSON.
    3. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene la clave de tu cuenta de servicio. Esta variable solo se aplica a la sesión actual de shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

    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.

Borrar una configuración

Console

  1. En Cloud Console, ve a la página Implementaciones de servidor para videojuegos.

    Ir a Game Servers

  2. Busca una implementación en la tabla. En la última columna de la tabla, haz clic en la elipsis y selecciona List configs. Puedes ver los archivos de configuración activos e inactivos para la implementación desde esta página.

    No puedes borrar una configuración activa. Para desactivar una configuración, haz clic en Manage Rollout y selecciona otra para el lanzamiento (consulta Actualiza la configuración predeterminada de un lanzamiento).

  3. En la tabla Inactive configs, busca la configuración que deseas borrar. En la última columna de la tabla, haz clic en los puntos suspensivos y selecciona Quitar configuración.

gcloud

Puedes borrar una configuración de Game Servers con la herramienta de línea de comandos de gcloud.

Para borrar una configuración, haz lo siguiente:

  1. Ejecuta el siguiente comando y reemplaza los valores del marcador de posición, como configID y deploymentID, por los valores apropiados:

    gcloud game servers configs delete configID --deployment=deploymentID
    

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

  • configID es el identificador único que especificaste para esta configuración.
  • deploymentID es el identificador único que especificaste para la implementación superior.

LÍNEA DE REST Y CMD

Antes de usar cualquiera de los datos de solicitud, realiza los siguientes reemplazos:

  • PROJECT_ID: El ID del proyecto de Google Cloud que aparece en la Configuración de IAM
  • DEPLOYMENT_ID: Es el identificador definido por el usuario para la implementación.
  • CONFIG_ID: Es el identificador definido por el usuario para la configuración.

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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
}

Comienza a usarlo

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Game Servers, consulta Bibliotecas cliente de Game Servers.


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

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Game Servers, consulta Bibliotecas cliente de Game Servers.

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

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Game Servers, consulta Bibliotecas cliente de Game Servers.

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)

Verifica que se borró tu configuración

Verifica si borraste correctamente la configuración mediante la enumeración de tus configuraciones con la herramienta de línea de comandos de gcloud.

Para enumerar todas las opciones de configuración, ejecuta el siguiente comando:

gcloud game servers configs list

Para enumerar todas las opciones de configuración de una implementación, ejecuta el siguiente comando y reemplaza deploymentID por la implementación superior.

gcloud game servers configs list --deployment=deploymentID

La configuración borrada ya no aparece en el resultado del comando.

¿Qué sigue?

Obtén información sobre los conceptos clave en la descripción general de Game Servers.