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

Quando crei snapshot, Google Cloud utilizza valori predefiniti predefiniti per di configurazione, a meno che tu non fornisca esplicitamente valori diversi. Istantanea sono parametri di configurazione centralizzati a livello di progetto che ti consentono di personalizzare la località predefinita in cui Google Cloud archivia i tuoi snapshot. Se utilizzi le impostazioni degli snapshot per definire un valore predefinito personalizzato, non dovrai più 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 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 eseguire l'autenticazione Compute Engine come segue.

    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 ulteriori informazioni, vedi Esegui 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 solo per gli snapshot standard e Archive.
  • La modifica del criterio di località nelle impostazioni dello snapshot del progetto influisce solo gli 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, i criteri relativi alla località di archiviazione nello snapshot rimangono invariate.

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 conserva un valore predefinito per questo criterio relativo alla posizione di archiviazione fino a quando non aggiorni le impostazioni dello snapshot e ne configuri uno nuovo. 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 dello snapshot per modificare i criteri di località di archiviazione più volte. Tuttavia, la modifica delle impostazioni degli snapshot del progetto influisce solo sulle posizioni degli snapshot creati dopo la modifica. L'aggiornamento delle impostazioni dello snapshot del progetto non cambia la posizione dei snapshot esistenti.

Per assicurarti che Google Cloud utilizzi la posizione di archiviazione definita dalle impostazioni dello snapshot, non specificare manualmente una posizione durante la creazione dello snapshot. Se specifichi manualmente una posizione durante la creazione dello snapshot, Google Cloud sostituisce le impostazioni dello snapshot e crea lo snapshot nella nuova posizione specificata. Tuttavia, i criteri relativi alla località di archiviazione nello snapshot rimangono invariate.

Puoi utilizzare le impostazioni dello snapshot per personalizzare la posizione di archiviazione predefinita gli 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à multiregionale più vicina al disco di origine
  • La stessa regione locale del disco di origine
  • Regioni specifiche a tua scelta

Criteri relativi alla località di archiviazione predefinita di Google Cloud

Fino al primo aggiornamento delle impostazioni degli snapshot, Google Cloud mantiene un valore predefinito per i criteri relativi alla località di archiviazione. Questo valore 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 località con più aree geografiche, il criterio per la posizione di archiviazione delle impostazioni di snapshot è impostato su questa località con più aree geografiche. Ad esempio, se il disco si trova in una posizione come us-central1, la località di archiviazione predefinita è us (più regioni).
  • 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 per i prezzi

Non è necessario pagare importi extra per utilizzare le impostazioni delle istantanee per in modo programmatico a gestire 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 dello snapshot del progetto e impostare un nuovo spazio di archiviazione predefinito la posizione geografica utilizzando REST e 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: la posizione di archiviazione dello snapshot per il tuo 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 geolocalizzazione Regione di Cloud Storage in cui si trova il disco.
    • specific-locations: specifica il criterio di località come criterio personalizzato Regione di Cloud Storage una posizione di tua scelta. Se specifichi questa opzione, devi anche specifica la località che ti interessa utilizzando --storage-location-names flag.

  • REGION_NAME: (facoltativo) se includi i campi --storage-location-policy con il valore specific-locations, poi devi specificare una regione di Cloud Storage. Puoi specificare una sola regione e non può essere Cloud Storage in più regioni. Imposta questo valore sul nome della regione che vuoi come criterio per la località di archiviazione.

Esempi di configurazione dei criteri relativi alla 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 dello snapshot del progetto come l'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 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
  • Configura come criterio di località di archiviazione dello snapshot del progetto. impostazioni come località specifica di tua scelta (ad es. 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 relativo alla località di archiviazione degli snapshot per il tuo 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 geolocalizzazione Regione di 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 usando il parametro locations nella tua 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 Cloud Storage in più regioni. Imposta questo valore sul nome della regione che vuoi specificare come criterio per la posizione di archiviazione.

Esempi di configurazione dei criteri relativi alla località 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 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 i criteri di località di archiviazione delle impostazioni dello snapshot del progetto della stessa regione Cloud Storage del disco, effettua quanto segue Richiesta di PATCH:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }
  • Configura come criterio di località di archiviazione dello snapshot del progetto. impostazioni come località specifica (ad es. us-central1), apporta quanto segue: 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 CLI gcloud.

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