Borra un clúster

En esta página, se explica cómo borrar un clúster 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.

Habilitar la API de servicios de juego

Elige una shell que tenga gcloud CLI instalada o usa un cliente de API:

Cloud Shell

Para iniciar Cloud Shell, sigue estos pasos:

Ve a la consola de Google Cloud.

Consola de Google Cloud
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

Instala la CLI de gcloud

Verifica que hayas configurado el proyecto predeterminado que deseas para Google Cloud CLI (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 de Google Cloud CLI. Game Servers requiere la versión 306.0.0 o una posterior de gcloud CLI.

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:

Crea una cuenta de servicio.
Descarga una clave privada como un archivo JSON.
Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene tus credenciales. Esta variable solo se aplica a la sesión actual de Cloud Shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.
Ejemplo: Linux o macOS
```
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

Por ejemplo:
```
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
```
Ejemplo: Windows

Para PowerShell:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

Por ejemplo:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
```
Para el símbolo del sistema:
```
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
```
Reemplaza KEY_PATH por la ruta del archivo JSON que contiene tus credenciales.

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 clúster

Si borras un clúster de Game Servers, no se borrarán los recursos del clúster.

Consola

En la consola de Google Cloud, ve a la página Dominios y clústeres.

Ir a Game Servers
Expande un dominio para ver los clústeres del servidor para videojuegos que le pertenecen.
En la última columna de la tabla del clúster, haz clic en la elipsis y selecciona Remove game server cluster.

gcloud

Puedes borrar un clúster global o regional de Game Servers con Google Cloud CLI.

Para borrar un clúster global, sigue estos pasos:

Ejecuta el siguiente comando y reemplaza los valores del marcador de posición, como clusterID y realmID, por los valores apropiados:
```
gcloud game servers clusters delete clusterID --realm=realmID --dry-run
```
El resultado muestra el targetState para que puedas obtener una vista previa de la operación antes de borrar el clúster.

Para borrar el clúster, ejecuta el siguiente comando:

gcloud game servers clusters delete clusterID --realm=realmID --no-dry-run

Para borrar un clúster regional, sigue estos pasos:

Ejecuta el siguiente comando y reemplaza los valores del marcador de posición, como clusterID, con los valores apropiados:
```
gcloud game servers clusters delete clusterID --realm=realmID --location=region --dry-run
```
El resultado muestra el targetState para que puedas obtener una vista previa de la operación antes de borrar el clúster.

Para borrar el clúster, ejecuta el siguiente comando:

gcloud game servers clusters delete clusterID --realm=realmID --location=region --no-dry-run

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

clusterID es el identificador único que especificaste para este clúster.
realmID es el identificador único que especificaste para el dominio superior de este clúster.
region es la región del clúster, si corresponde. Elige la misma ubicación que el dominio superior.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID de tu proyecto de Google Cloud que aparece en Configuración de IAM.
REALM_LOCATION: Es la región para el dominio o global.
REALM_ID: Es el identificador definido por el usuario para el dominio.
GS_CLUSTER_ID: Es el identificador definido por el usuario para el clúster.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login, o mediante el uso de Cloud Shell, que accede automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/REALM_LOCATION/realms/REALM_ID/gameServerClusters/GS_CLUSTER_ID"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/REALM_LOCATION/realms/REALM_ID/gameServerClusters/GS_CLUSTER_ID" | Select-Object -Expand Content

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

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

Verifica que se borró tu clúster

Para verificar que borraste el clúster de forma correcta, enumera tus clústeres globales o regionales mediante Google Cloud CLI.

Para enumerar todos los clústeres, ejecuta el siguiente comando:

gcloud game servers clusters list

Para enumerar los clústeres en una región, ejecuta el siguiente comando y reemplaza region por la región en la que deseas enumerar los clústeres:

gcloud game servers clusters list --location=region

Para enumerar todos los clústeres en un dominio, ejecuta el comando siguiente y reemplaza realmID por el dominio superior y region por la región del clúster, si corresponde:

gcloud game servers clusters list --realm=realmID --location=region

El clúster borrado 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.