Impostare la posizione di archiviazione predefinita utilizzando le impostazioni degli snapshot

Quando crei gli snapshot, Google Cloud utilizza valori predefiniti per le opzioni di configurazione, a meno che non fornisci esplicitamente valori diversi. Le impostazioni degli snapshot sono parametri di configurazione centralizzati a livello di progetto che ti consentono di personalizzare la posizione predefinita in cui Google Cloud archivia gli snapshot. Se utilizzi le impostazioni di istantanea per definire un valore predefinito personalizzato, non dovrai più specificare manualmente una località durante la creazione di ogni istantanea.

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

Prima di iniziare

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

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

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Per saperne di più, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Limitazioni

  • Puoi visualizzare e aggiornare le impostazioni degli snapshot solo utilizzando gcloud CLI o REST.
  • Non puoi personalizzare la posizione di archiviazione predefinita degli snapshot istantanei. Puoi farlo solo per gli snapshot standard e di archiviazione.
  • La modifica del criterio di località nelle impostazioni degli snapshot del progetto influisce solo sugli snapshot creati dopo la modifica. L'aggiornamento delle impostazioni della Panoramica della giornata del progetto non modifica la posizione delle Panoramiche della giornata esistenti.
  • Se specifichi manualmente una posizione durante la creazione dello snapshot, Google Cloud supera le impostazioni dello snapshot e crea lo snapshot nella posizione appena specificata. Tuttavia, il criterio relativo alla posizione di archiviazione nelle impostazioni dello snapshot rimane invariato.

Come funzionano le impostazioni degli snapshot

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

Puoi aggiornare le impostazioni degli istantanei per modificare il criterio relativo alla posizione di archiviazione un numero illimitato di volte. Tuttavia, la modifica delle impostazioni degli snapshot del progetto influisce solo sulle posizioni degli snapshot creati dopo la modifica. L'aggiornamento delle impostazioni degli snapshot del progetto non modifica la posizione degli snapshot esistenti.

Per assicurarti che Google Cloud utilizzi la posizione di archiviazione definita dalle impostazioni dell'istantanea, non specificare manualmente una posizione durante la creazione dell'istantanea. Se specifichi manualmente una posizione durante la creazione dello snapshot, Google Cloud sovrascrive le impostazioni dello snapshot e crea lo snapshot nella nuova posizione specificata. Tuttavia, il criterio relativo alla posizione di archiviazione nelle impostazioni dello snapshot rimane invariato.

Puoi utilizzare le impostazioni degli snapshot per personalizzare la posizione di archiviazione predefinita degli snapshot standard e di archiviazione. Non puoi personalizzare la posizione di archiviazione predefinita degli 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 posizione basate su disco. Nello specifico, puoi scegliere una delle seguenti opzioni di località per il criterio di posizione di archiviazione:

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

Criterio relativo alla posizione di archiviazione predefinita di Google Cloud

Fino a quando non aggiorni le impostazioni degli snapshot per la prima volta, Google Cloud mantiene un valore predefinito per il criterio di località di archiviazione. Questo criterio predefinito fornisce la posizione di archiviazione predefinita per gli snapshot finché non configuri la tua posizione di archiviazione predefinita aggiornando le impostazioni degli snapshot del progetto. Il criterio di posizione di archiviazione predefinito è impostato sulla regione multipla più vicina geograficamente alla posizione del disco di origine.

  • Se il disco di origine si trova in una località che fa parte di una multi-regione, il criterio per la posizione di archiviazione delle impostazioni di snapshot è impostato su quella multi-regione. Ad esempio, se il disco si trova in una località come us-central1, la posizione di archiviazione predefinita è la multi-regione us.
  • Per una località al di fuori di una regione multipla, la località di archiviazione predefinita è la regione multipla geograficamente più vicina al di fuori di quella regione. Per una località come australia-southeast1, la località predefinita diventa la regione multipla asia.

Implicazioni sui prezzi

Non è necessario pagare alcun importo aggiuntivo per utilizzare le impostazioni degli snapshot per i progetti. Tuttavia, i valori di località specificati utilizzando le impostazioni degli istantanei influiscono su altre operazioni, che a loro volta possono influire su questi costi operativi.

Impostare la posizione di archiviazione predefinita per un progetto utilizzando le impostazioni degli snapshot

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

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

gcloud

Per aggiungere le impostazioni degli snapshot o aggiornare quelle esistenti per il 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 posizione di archiviazione degli snapshot per il progetto. Il valore può essere uno dei seguenti:

    • nearest-multi-region: specifica il criterio di località come il multiregione Cloud Storage più vicino alla posizione del disco.
    • local-region: specifica il criterio di località come la stessa regione Cloud Storage in cui si trova il disco.
    • specific-locations: specifica il criterio di località come una località personalizzata della regione Cloud Storage di tua scelta. Se specifichi questa opzione, devi anche specificare la posizione che ti interessa utilizzando il flag --storage-location-names.

  • REGION_NAME: facoltativo. Se includi il flag --storage-location-policy con un valore specific-locations, devi specificare una regione Cloud Storage. Puoi specificare una sola regione e non può essere una regione Cloud Storage con più regioni. Imposta questo valore sul nome della regione che vuoi specificare come criterio per la posizione di archiviazione.

Esempi per impostare il criterio relativo alla posizione di archiviazione utilizzando le impostazioni degli snapshot

Prendi in considerazione un progetto di esempio my-project nella regione us-central1.

  • Per configurare il criterio di posizione di archiviazione delle impostazioni di snapshot del progetto come la regione Cloud Storage più vicina al tuo disco, esegui il seguente comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=nearest-multi-region
  • Per configurare il criterio di posizione di archiviazione delle impostazioni di snapshot del progetto come la stessa regione Cloud Storage del disco, esegui il seguente comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=local-region
  • Per configurare come criterio di posizione di archiviazione delle impostazioni di snapshot del progetto una posizione specifica a tua scelta (ad esempio us-central1), usa il flag --storage-location-names ed esegui il seguente comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=specific-locations \
      --storage-location-names=us-central1

REST

Per aggiungere le impostazioni degli snapshot o aggiornare quelle esistenti per il tuo progetto, invia 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 di posizione di archiviazione degli snapshot per il progetto. Il valore può essere uno dei seguenti:

    • NEAREST_MULTI_REGION: specifica il criterio di località come il multiregione Cloud Storage più vicino alla posizione del disco.
    • LOCAL_REGION: specifica il criterio di località come la stessa regione Cloud Storage in cui si trova il disco.
    • SPECIFIC_LOCATIONS: specifica il criterio di località come una località personalizzata della regione Cloud Storage di tua scelta. Se specifichi questa opzione, devi anche specificare la località che ti interessa utilizzando il parametro locations nella richiesta.

  • REGION_NAME: facoltativo. Se includi il parametro policy con un valore SPECIFIC_LOCATIONS, devi specificare una regione Cloud Storage. Puoi specificare una sola regione e non può essere una regione Cloud Storage con più regioni. Imposta questo valore sul nome della regione che vuoi specificare come criterio per la posizione di archiviazione.

Esempi per impostare il criterio relativo alla posizione 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 degli snapshot del progetto come la regione 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 il criterio di posizione di archiviazione delle impostazioni degli snapshot del progetto come 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 posizione di archiviazione delle impostazioni degli snapshot del progetto una posizione 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"}
        }
      }
    }

Visualizzare la posizione di archiviazione predefinita definita dalle impostazioni degli snapshot di un progetto

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

gcloud

Per visualizzare le impostazioni degli snapshot per il tuo 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 degli istantanei per il tuo progetto, invia 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