Como excluir uma configuração

Esta página explica como excluir uma configuração do Game Servers.

Antes de começar

Antes de começar, recomendamos que você se familiarize com os principais conceitos na Visão geral do Game Servers. Verifique se você também realizou as seguintes tarefas:

Verifique se você ativou a API Game Services.

Ativar a API Game Services

Escolha um shell com a CLI gcloud instalada ou use um cliente de API:

Cloud Shell

Para iniciar o Cloud Shell, execute os seguintes passos:

Acesse o Console do Google Cloud.

Console do Google Cloud
No canto superior direito do console, clique no botão Ativar Cloud Shell:

Uma sessão do Cloud Shell é aberta dentro de um quadro inferior no console. Use esse shell para executar comandos gcloud.

Shell local

Instale a CLI gcloud.

Verifique se você definiu o projeto padrão desejado para a Google Cloud CLI. Caso contrário, será necessário especificar a sinalização --project explicitamente para cada comando mais tarde:

gcloud config list project

Caso contrário, execute o seguinte comando para definir um projeto padrão, substituindo PROJECT_ID pelo ID do projeto que você quer:

gcloud config set project PROJECT_ID

Execute o seguinte comando para verificar a versão da Google Cloud CLI. O Game Servers requer a versão 306.0.0 ou mais recente da CLI gcloud.

gcloud version

Para atualizar a instalação, execute o seguinte comando:

gcloud components update

curl / PowerShell

Para usar a API REST com curl ou o Windows PowerShell, faça o seguinte:

Crie uma conta de serviço.
Faça o download de uma chave privada como um arquivo JSON.
Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.
Example: Linux or macOS
```
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:
```
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
```
Example: Windows

For PowerShell:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
```
For command prompt:
```
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
```
Replace KEY_PATH with the path of the JSON file that contains your credentials.

Biblioteca de cliente

O Game Servers do Google Cloud pode ser controlado de maneira programática usando uma biblioteca de cliente. Consulte Visão geral das bibliotecas de cliente para instruções sobre como usar a biblioteca e fazer a autenticação.

Como excluir uma configuração

Console

No console do Google Cloud, acesse a página Implantações do servidor de jogos.

Acessar o Game Servers
Encontre uma implantação na tabela. Na última coluna da tabela, clique nas reticências e selecione Configurações da lista. É possível ver as configurações ativas e inativas da implantação nessa página.

Não é possível excluir uma configuração ativa. Para desativar uma configuração, clique em Gerenciar lançamento e selecione outra configuração para o lançamento. Consulte Como atualizar a configuração padrão de um lançamento.
Na tabela Configurações inativas, encontre a configuração a ser excluída. Na última coluna da tabela, clique nas reticências e selecione Remover configuração.

gcloud

É possível excluir uma configuração do Game Servers usando a Google Cloud CLI.

Para excluir uma configuração:

Execute o seguinte comando e substitua os valores do marcador, como configID e deploymentID, pelos valores apropriados:
```
gcloud game servers configs delete configID --deployment=deploymentID
```

Os marcadores das variáveis correspondem às seguintes descrições:

configID é o identificador exclusivo que você especificou para essa configuração.
deploymentID é o identificador exclusivo que você especificou para a implantação pai.

REST

Antes de usar os dados da solicitação, faça as substituições a seguir:

PROJECT_ID: o ID do projeto do Google Cloud listado nas Configurações do IAM
DEPLOYMENT_ID: o identificador definido pelo usuário para a implantação
CONFIG_ID: o identificador definido pelo usuário para o realm

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/configs/CONFIG_ID"

PowerShell (Windows)

execute o seguinte 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/global/gameServerDeployments/DEPLOYMENT_ID/configs/CONFIG_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

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

Como verificar se a configuração foi excluída

Verifique se você excluiu a configuração listando-a com a Google Cloud CLI.

Para listar todas as configurações, execute o seguinte comando:

gcloud game servers configs list

Para listar todas as configurações em uma implantação, execute o seguinte comando e substitua deploymentID pela implantação pai.

gcloud game servers configs list --deployment=deploymentID

A configuração excluída não aparece mais na resposta do comando.

A seguir

Aprenda os conceitos principais na Visão geral do Game Servers.