Modifica dell'area geografica o della zona predefinita

Questa pagina spiega come impostare una regione o una zona predefinita per il tuo progetto della console Google Cloud .

Quando effettui una richiesta a Compute Engine, potrebbe essere necessario fornire una regione o una zona a seconda dei requisiti specifici della richiesta. Qualsiasi richiesta che coinvolga risorse regionali richiede di fornire un nome di regione, mentre qualsiasi richiesta che coinvolga risorse di zona richiede di fornire un nome di zona. Ad esempio, devi specificare una regione quando crei un indirizzo IP esterno statico e una zona quando crei un'istanza Compute Engine. Per un elenco completo delle regioni e delle zone, consulta Regioni e zone.

Per ulteriori informazioni sulle risorse Compute Engine globali, di regione e di zona, consulta Risorse globali, di regione e di zona.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Seleziona la scheda relativa al modo in cui prevedi di utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud , non devi configurare l'autenticazione.

    gcloud

    1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  • Imposta una regione e una zona predefinite.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare o modificare le impostazioni predefinite della regione e della zona, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per visualizzare o modificare le impostazioni predefinite della regione e della zona. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare o modificare le impostazioni predefinite della regione e della zona sono necessarie le seguenti autorizzazioni:

  • Visualizza le impostazioni predefinite per regione e zona: compute.projects.get
  • Modifica le impostazioni predefinite della regione e della zona:
    • compute.projects.get
    • compute.projects.setCommonInstanceMetadata

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

In che modo la regione e la zona predefinite influiscono sul progetto

Le impostazioni predefinite della regione e della zona influiscono solo sugli strumenti client, come Google Cloud CLI e la console Google Cloud . Quando utilizzi questi strumenti per creare le tue richieste, ti aiutano a gestire le risorse selezionando automaticamente la regione e la zona predefinite.

Quando utilizzi la console Google Cloud per creare risorse di zona o di regione, come indirizzi e istanze, Compute Engine imposta i campi della regione e della zona per te. Puoi accettare i valori precompilati o modificare esplicitamente uno o entrambi i valori.

Quando utilizzi gcloud CLI, ometti l'impostazione dei flag --region e --zone per utilizzare le proprietà predefinite di regione e zona per il nuovo progetto.

Puoi sempre modificare le impostazioni predefinite della regione e della zona nel server dei metadati, eseguire l'override della regione e della zona predefinite localmente per gcloud CLI o eseguire l'override delle impostazioni manualmente per ogni richiesta utilizzando gcloud CLI o la console Google Cloud .

Ricerca della regione o della zona predefinita

Il server dei metadati contiene informazioni sui metadati di un progetto, tra cui l'ID e il nome del progetto. Puoi eseguire query sul server dei metadati per ottenere e utilizzare informazioni sul progetto.

Se specifichi una regione e una zona predefinite per il tuo progetto, Compute Engine imposta questi valori nel server dei metadati per il tuo progetto.

Le aree geografiche e le zone predefinite sono impostate utilizzando i seguenti valori:

  • google-compute-default-region
  • google-compute-default-zone

Per visualizzare le impostazioni predefinite della regione e della zona, esegui il seguente comando gcloud, sostituendo PROJECT_ID con l'ID progetto:

gcloud compute project-info describe --project PROJECT_ID

Cerca i valori dei metadati della regione e della zona predefinite nella risposta. Se nella risposta non sono presenti le chiavi e i valori google-compute-default-region e google-compute-default-zone, significa che non sono state impostate regioni o zone predefinite.

Modifica dell'area geografica o della zona predefinita

Non esistono limitazioni alle regioni o alle zone che puoi impostare per le proprietà predefinite. Ad esempio, è possibile impostare una zona predefinita che si trova al di fuori della regione predefinita. Controlla le impostazioni predefinite della regione e della zona durante la creazione e la gestione delle risorse.

Console

Per modificare la regione o la zona predefinita:

  1. Nella console Google Cloud , vai alla pagina Impostazioni.

    Vai alle impostazioni

  2. Dal menu a discesa Regione, seleziona una regione predefinita.

  3. Dal menu a discesa Zona, seleziona una zona predefinita.

  4. Fai clic su Salva.

gcloud

Puoi modificare la regione e la zona predefinite inviando una richiesta al server dei metadati. Ad esempio:

gcloud compute project-info add-metadata \
    --metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b

Dopo aver aggiornato i metadati predefiniti utilizzando un metodo qualsiasi, esegui il comando gcloud init per reinizializzare la configurazione di default. gcloud CLI aggiorna le impostazioni predefinite della regione e della zona solo dopo aver eseguito il comando gcloud init.

Per saperne di più sull'utilizzo delle opzioni di gcloud CLI per impostare regioni e zone predefinite, consulta Imposta le proprietà predefinite.

Passaggi successivi