Eliminazione di un'area di autenticazione

In questa pagina viene spiegato come eliminare un regno Game Servers.

Prima di iniziare

Prima di iniziare, ti consigliamo di acquisire familiarità con i concetti principali nella panoramica dei server di gioco. Assicurati di aver eseguito anche le seguenti attività:

Assicurati di aver attivato l'API Game Services.

Abilita l'API Game Services

Scegli una shell con gcloud CLI installata o utilizza un client API:

Cloud Shell

Per avviare Cloud Shell, esegui questi passaggi:

Vai alla console Google Cloud.

Console Google Cloud
Nell'angolo in alto a destra della console, fai clic sul pulsante Attiva Cloud Shell:

Una sessione di Cloud Shell si apre all'interno di un frame più in basso nella console. Utilizza questa shell per eseguire i comandi gcloud.

Shell locale

Installare l'interfaccia a riga di comando gcloud.

Verifica di aver impostato il progetto predefinito desiderato per Google Cloud CLI (in caso contrario dovrai specificare il flag --project in modo esplicito per ogni comando in un secondo momento):

gcloud config list project

In caso contrario, puoi eseguire il seguente comando per impostare un progetto predefinito, sostituendo PROJECT_ID con l'ID progetto desiderato :

gcloud config set project PROJECT_ID

Esegui il comando seguente per verificare la tua versione di Google Cloud CLI. Game Servers richiede la versione 306.0.0 o successiva dellgcloud CLI.

gcloud version

Per aggiornare l'installazione, esegui il comando seguente:

gcloud components update

curl / PowerShell

Per utilizzare l'API REST con curl o Windows PowerShell, segui questi passaggi:

Crea un account di servizio.
Scarica una chiave privata come file 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.

Libreria client

I server di gioco Google Cloud possono essere controllati in modo programmatico utilizzando una libreria client. Per istruzioni sull'utilizzo della libreria e l'autenticazione, consulta la panoramica sulle librerie client.

Eliminazione di un'area di autenticazione

Console

Nella console Google Cloud, vai alla pagina Realm e cluster.

Vai a Game Servers
Puoi utilizzare la casella di filtro per filtrare l'elenco di aree di autenticazione in base alle diverse proprietà.
Nell'ultima colonna della tabella, fai clic sui puntini di sospensione e seleziona Rimuovi realm.

gcloud

Puoi eliminare un regno globale o a livello di regione utilizzando Google Cloud CLI.

Per eliminare un'area di autenticazione globale, esegui questo comando e sostituisci realmID con l'identificatore di un'area di autenticazione creata in precedenza:

gcloud game servers realms delete realmID

Per eliminare un'area di autenticazione a livello di area geografica, esegui questo comando e sostituisci i valori segnaposto, ad esempio realmID, con i valori appropriati:

gcloud game servers realms delete realmID --location=region

I segnaposto delle variabili corrispondono alle seguenti descrizioni:

realmID è l'identificatore univoco di un'area di autenticazione.
region è l'area geografica del regno, se esistente.

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM
LOCATION: la regione del regno o global
REALM_ID: un identificatore definito dall'utente per l'area di autenticazione

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all' interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login, oppure utilizzando Cloud Shell, che esegue automaticamente l'accesso all'interfaccia a riga di comando di gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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/LOCATION/realms/REALM_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

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

Verifica dell'eliminazione del regno

Per verificare di aver eliminato correttamente l'area di autenticazione, elenca gli ambiti globali o a livello di area geografica utilizzando Google Cloud CLI.

Per elencare tutti i realm globali, esegui il comando seguente:

gcloud game servers realms list

Per elencare le aree di autenticazione in un'area geografica, esegui il comando seguente e sostituisci region con l'area geografica che vuoi elencare:

gcloud game servers realms list --location=region

Il tuo realm eliminato non compare più nell'output del comando.

Passaggi successivi

Scopri di più sull'audit logging.