Configura la località di archiviazione predefinita utilizzando le impostazioni dello snapshot

Quando crei snapshot, Google Cloud utilizza valori predefiniti predefiniti per le opzioni di configurazione, a meno che tu non fornisca esplicitamente valori diversi. Le impostazioni degli snapshot sono parametri di configurazione centralizzati a livello di progetto che consentono di personalizzare la località predefinita in cui Google Cloud archivia i tuoi snapshot. L'utilizzo delle impostazioni dello snapshot per definire un valore predefinito personalizzato elimina la necessità di specificare manualmente una località durante la creazione di ogni snapshot.

Questo documento fornisce informazioni sulle impostazioni degli snapshot e su come utilizzarle per personalizzare la località di archiviazione predefinita per gli snapshot del progetto.

Prima di iniziare

  • Se non l'hai già fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità dell'utente per ottenere l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione in Compute Engine come segue.

    Select the tab for how you plan to use the samples on this page:

    gcloud

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

      gcloud init
    2. Set a default region and zone.
    3. REST

      Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

        Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

        gcloud init

      Per maggiori informazioni, consulta Autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Limitazioni

  • Puoi visualizzare e aggiornare le impostazioni dello snapshot solo utilizzando gcloud CLI o REST.
  • Non puoi personalizzare la località di archiviazione predefinita degli snapshot istantanei. Puoi farlo solo per gli snapshot standard e Archive.
  • La modifica del criterio di località nelle impostazioni degli snapshot del progetto influisce solo sugli snapshot creati dopo la modifica. L'aggiornamento delle impostazioni degli snapshot del progetto non cambia la posizione degli snapshot esistenti.
  • Se specifichi manualmente una località durante la creazione dello snapshot, Google Cloud esegue l'override delle impostazioni dello snapshot e lo crea nella nuova località specificata. Tuttavia, i criteri relativi alla località di archiviazione nelle impostazioni dello snapshot rimangono invariati.

Come funzionano le impostazioni degli snapshot

Il criterio di località di archiviazione delle impostazioni degli snapshot di un progetto definisce dove Google Cloud archivia automaticamente gli snapshot di quel progetto. Google Cloud mantiene un valore predefinito per questo criterio di località di archiviazione finché non aggiorni le impostazioni dello snapshot e non configuri un nuovo valore predefinito. Dopo aver aggiornato le impostazioni dello snapshot e aver impostato una nuova posizione di archiviazione predefinita, Google Cloud utilizza questa località per archiviare ogni nuovo snapshot creato nel progetto.

Puoi aggiornare le impostazioni dello snapshot per modificare i criteri di località di archiviazione un numero qualsiasi di volte. Tuttavia, la modifica delle impostazioni degli snapshot del progetto interessa solo le località degli snapshot creati dopo la modifica. L'aggiornamento delle impostazioni degli snapshot del progetto non cambia la località degli snapshot esistenti.

Per assicurarti che Google Cloud utilizzi la località di archiviazione definita dalle impostazioni dello snapshot, non specificare manualmente una località durante la creazione dello snapshot. Se specifichi manualmente una località durante la creazione dello snapshot, Google Cloud esegue l'override delle impostazioni dello snapshot e lo crea nella nuova località specificata. Tuttavia, i criteri relativi alla località di archiviazione nelle impostazioni dello snapshot rimangono invariati.

Puoi utilizzare le impostazioni degli snapshot per personalizzare la posizione di archiviazione predefinita degli snapshot standard e di archiviazione. Non puoi personalizzare la località di archiviazione predefinita per gli snapshot istantanei.

Opzioni per la posizione di archiviazione

Quando configuri le impostazioni degli snapshot del progetto e specifichi una nuova posizione di archiviazione predefinita, puoi scegliere regioni specifiche o utilizzare impostazioni di geolocalizzazione basate sul disco. In particolare, per i criteri relativi alla località di archiviazione puoi scegliere una delle seguenti opzioni di posizione:

  • La località multiregionale più vicina al disco di origine
  • La stessa regione locale del disco di origine
  • Regioni specifiche di tua scelta

Criteri relativi alla località di archiviazione predefinita di Google Cloud

Fino al primo aggiornamento delle impostazioni dello snapshot, Google Cloud mantiene un valore predefinito per il criterio di località di archiviazione. Questo criterio predefinito fornisce la località di archiviazione predefinita per gli snapshot finché non configuri la tua località di archiviazione predefinita aggiornando le impostazioni degli snapshot del progetto. Il criterio per la località di archiviazione predefinito è impostato sulla più regioni geograficamente più vicina alla località del disco di origine.

  • Se il disco di origine si trova in una località che fa parte di una località multiregionale, il criterio di località di archiviazione delle impostazioni dello snapshot è impostato su quella località multiregionale. Ad esempio, se il disco si trova in una località come us-central1, la località di archiviazione predefinita è us multiregionale.
  • Per una località esterna a più regioni, la località di archiviazione predefinita è la località multiregionale più vicina all'esterno di quella regione. Per una località come australia-southeast1, la località predefinita diventa l'area multiregionale asia.

Implicazioni per i prezzi

Non devi pagare alcun importo aggiuntivo per utilizzare le impostazioni degli snapshot per i tuoi progetti. Tuttavia, i valori della località specificati utilizzando le impostazioni dello snapshot influiscono su altre operazioni, con potenziali conseguenze sui costi operativi.

Configura la località di archiviazione predefinita per un progetto utilizzando le impostazioni dello snapshot

Puoi aggiornare le impostazioni degli snapshot del progetto e impostare una nuova posizione di archiviazione predefinita utilizzando REST e gcloud CLI.

Se non imposti un criterio per la località di archiviazione nelle impostazioni degli snapshot, questi vengono creati utilizzando il criterio per la località di archiviazione predefinito di Google Cloud.

gcloud

Per aggiungere le impostazioni dello snapshot o aggiornare le impostazioni dello snapshot esistenti per il tuo progetto, utilizza il comando gcloud compute snapshot-settings update:

  gcloud compute snapshot-settings update \
      --project=PROJECT_ID \
      --storage-location-policy=STORAGE_LOCATION \
      --storage-location-names=REGION_NAME

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto.
  • STORAGE_LOCATION: il criterio per la località di archiviazione dello snapshot per il progetto. Il valore può essere uno dei seguenti:

    • nearest-multi-region: specifica il criterio di località come più regioni di Cloud Storage più vicina alla località del disco.
    • local-region: specifica il criterio di località per la stessa regione di Cloud Storage in cui si trova il disco.
    • specific-locations: specifica il criterio di località come località della regione Cloud Storage personalizzata di tua scelta. Se specifichi questa opzione, devi specificare anche la località che vuoi utilizzando il flag --storage-location-names.
  • REGION_NAME: (facoltativo) se includi il flag --storage-location-policy con il valore specific-locations, devi specificare una regione di Cloud Storage. Puoi specificare una sola regione e non può essere una località multiregionale di Cloud Storage. Imposta questo valore sul nome della regione che vuoi specificare come criterio di località di archiviazione.

Esempi di configurazione dei criteri di località di archiviazione utilizzando le impostazioni degli snapshot

Considera un progetto di esempio my-project nella regione us-central1.

  • Per configurare i criteri di località di archiviazione delle impostazioni dello snapshot del progetto come area multiregionale di Cloud Storage più vicina al tuo disco, esegui questo comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=nearest-multi-region
  • Per configurare i criteri di località di archiviazione delle impostazioni degli snapshot del progetto a livello della stessa regione Cloud Storage del disco, esegui questo comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=local-region
  • Per configurarlo come criterio per la località di archiviazione delle impostazioni dello snapshot del progetto come località specifica di tua scelta (ad esempio us-central1), utilizza il flag --storage-location-names ed esegui questo comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=specific-locations \
      --storage-location-names=us-central1

REST

Per aggiungere le impostazioni dello snapshot o aggiornare quelle esistenti per il tuo progetto, effettua una richiesta PATCH al metodo snapshotSettings.update:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

  {
    "storageLocation": {
      "policy": "STORAGE_LOCATION",
      "locations": {
            "REGION_NAME": { "name": "REGION_NAME" }
      }
    }
  }

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto.
  • STORAGE_LOCATION: il criterio per la località di archiviazione dello snapshot per il progetto. Il valore può essere uno dei seguenti:

    • NEAREST_MULTI_REGION: specifica il criterio di località come più regioni di Cloud Storage più vicina alla località del disco.
    • LOCAL_REGION: specifica il criterio di località per la stessa regione di Cloud Storage in cui si trova il disco.
    • SPECIFIC_LOCATIONS: specifica il criterio di località come località della regione Cloud Storage personalizzata di tua scelta. Se specifichi questa opzione, devi anche specificare la località che vuoi usando il parametro locations nella tua richiesta.
  • REGION_NAME: (facoltativo) se includi il parametro policy con il valore SPECIFIC_LOCATIONS, devi specificare una regione di Cloud Storage. Puoi specificare una sola regione e non può essere una località multiregionale di Cloud Storage. Imposta questo valore sul nome della regione che vuoi specificare come criterio di località di archiviazione.

Esempi di configurazione dei criteri di località di archiviazione utilizzando le impostazioni degli snapshot

Considera un progetto di esempio my-project nella regione us-central1.

  • Per configurare il criterio di località di archiviazione delle impostazioni dello snapshot del progetto come area multiregionale di Cloud Storage più vicina al tuo disco, effettua la seguente richiesta PATCH:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "NEAREST_MULTI_REGION"
      }
    }
  • Per configurare i criteri di località di archiviazione delle impostazioni degli snapshot del progetto per la stessa regione Cloud Storage del disco, effettua la seguente richiesta PATCH:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }
  • Per configurare come criterio di località di archiviazione le impostazioni dello snapshot del progetto come località specifica (ad esempio us-central1), effettua la seguente richiesta PATCH:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "SPECIFIC_LOCATIONS",
        "locations": {
          "us-central1": { "name": "us-central1"}
        }
      }
    }

Visualizza la località di archiviazione predefinita definita dalle impostazioni dello snapshot di un progetto

Puoi visualizzare le impostazioni dello snapshot del progetto utilizzando l'API Compute Engine e gcloud CLI.

gcloud

Per visualizzare le impostazioni dello snapshot per il progetto, utilizza il comando gcloud compute snapshot-settings describe:

  gcloud compute snapshot-settings describe \
      --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID del progetto.

REST

Per visualizzare le impostazioni dello snapshot per il progetto, effettua una richiesta GET al metodo snapshotSettings.get:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

Sostituisci PROJECT_ID con l'ID del progetto.

Passaggi successivi