Imposta le località di archiviazione predefinite per gli snapshot con ambito globale

Quando crei gli snapshot, per impostazione predefinita vengono creati come snapshot con scope globale. Per un determinato progetto, puoi personalizzare la località predefinita in cuiGoogle Cloud archivia gli snapshot con scope globale configurando le impostazioni degli snapshot. Se usi le impostazioni degli snapshot per definire il tuo valore personalizzato, non dovrai più specificare manualmente una località ogni volta che crei uno snapshot.

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

Per gestire le impostazioni di localizzazione per gli snapshot con scope regionale, consulta Imposta le località di creazione e ripristino degli snapshot con scope regionale (anteprima).

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API di 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. After installation, initialize the Google Cloud CLI by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

    REST

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

      Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    Per saperne di più, consulta Autenticarsi 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 località di archiviazione predefinita degli snapshot istantanei. Puoi farlo solo per gli snapshot standard e di archiviazione.
  • La modifica della policy della località nelle impostazioni degli snapshot del progetto influisce solo sugli snapshot creati dopo la modifica. L'aggiornamento delle impostazioni degli snapshot del progetto non modifica la località degli snapshot esistenti.
  • Se specifichi manualmente una località durante la creazione di uno snapshot, Google Cloudignora l'impostazione degli snapshot e crea lo snapshot nella nuova località specificata. Tuttavia, la policy della località di archiviazione nelle impostazioni degli snapshot rimane invariata.
  • Le località di archiviazione predefinite si applicano solo agli snapshot con scope globale. Per controllare le località di archiviazione per gli snapshot con scope regionale, devi impostare le località di creazione degli snapshot consentite.
  • L'impostazione di una località di archiviazione predefinita controlla solo la località in cui viene archiviato lo snapshot. Per gli snapshot con scope globale, non puoi impostare la località in cui possono essere ripristinati i dati degli snapshot. Per impostare le località consentite per il ripristino degli snapshot, devi creare uno snapshot regionale e impostare le località di ripristino consentite.

Funzionamento delle impostazioni degli snapshot

La policy della località di archiviazione nelle impostazioni degli snapshot di un progetto definisce dove Google Cloud archivia automaticamente gli snapshot del progetto. Google Cloud mantiene un valore predefinito per questa policy della località di archiviazione fino a quando non aggiorni le impostazioni degli snapshot e configuri un nuovo valore predefinito. Dopo che hai aggiornato le impostazioni degli snapshot e impostato una nuova località di archiviazione predefinita, Google Cloud utilizza questa località per archiviare ogni nuovo snapshot creato nel progetto.

Puoi aggiornare le impostazioni degli snapshot per modificare la policy della località di archiviazione un numero illimitato di volte. Tuttavia, la modifica delle impostazioni degli snapshot del progetto influisce solo sulle località degli snapshot creati successivamente. L'aggiornamento delle impostazioni degli snapshot del progetto non modifica la località degli snapshot esistenti.

Per assicurarti che Google Cloud utilizzi la località di archiviazione definita nelle impostazioni degli snapshot, non specificare manualmente una località durante la creazione dello snapshot. Se specifichi manualmente una località durante la creazione di uno snapshot, Google Cloud ignora l'impostazione degli snapshot e crea lo snapshot nella nuova località specificata. Tuttavia, la policy della località di archiviazione nelle impostazioni degli snapshot rimane invariata.

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

Opzioni per la località di archiviazione

Quando configuri le impostazioni degli snapshot del progetto e specifichi una nuova località di archiviazione predefinita, puoi scegliere regioni specifiche o utilizzare impostazioni di localizzazione basate su disco. Nello specifico, puoi scegliere una delle seguenti opzioni di località per la policy della località di archiviazione:

  • La multi-regione più vicina al disco di origine
  • La stessa regione locale del disco di origine
  • Regioni specifiche a tua scelta

Policy della località di archiviazione predefinita diGoogle Cloud

Finché non aggiorni le impostazioni degli snapshot per la prima volta, Google Cloud mantiene un valore predefinito per la policy della località di archiviazione. Questa policy predefinita 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. La policy della località di archiviazione predefinita è impostata sulla multi-regione più vicina alla località del disco di origine.

  • Se il disco di origine si trova in una località che fa parte di una multi-regione, la policy della località di archiviazione nelle impostazioni degli snapshot è impostata su questa multi-regione. Ad esempio, se il disco si trova in una località come us-central1, la località di archiviazione predefinita è la multi-regione us.
  • Per una località al di fuori di una multi-regione, la località di archiviazione predefinita è la multi-regione geograficamente più vicina al di fuori di quella regione. Per una località come australia-southeast1, la località predefinita diventa la multi-regione asia.

Implicazioni sui prezzi

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

Imposta la località di archiviazione predefinita per un progetto utilizzando le impostazioni degli snapshot

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

Se non imposti una policy della località di archiviazione nelle impostazioni degli snapshot, gli snapshot vengono creati utilizzando la policy della località di archiviazione predefinita diGoogle 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 policy della località di archiviazione degli snapshot per il progetto. Il valore può essere uno dei seguenti:

    • nearest-multi-region: specifica la policy della località come la multi-regione Cloud Storage più vicina alla località del disco.
    • local-region: specifica la policy della località come la stessa regione Cloud Storage in cui si trova il disco.
    • specific-locations: specifica la policy della località come località personalizzata della regione Cloud Storage di tua scelta. Se specifichi questa opzione, devi anche specificare la località 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 multi-regione Cloud Storage. Imposta questo valore sul nome della regione che vuoi specificare come policy della località di archiviazione.

Esempi per impostare la policy della località di archiviazione utilizzando le impostazioni degli snapshot

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

  • Per configurare la policy della località di archiviazione nelle impostazioni degli snapshot del progetto come la multi-regione 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 la policy della località di archiviazione nelle impostazioni degli snapshot del progetto come la stessa regione Cloud Storage del disco, esegui questo comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=local-region
  • Per configurare come policy della località di archiviazione nelle impostazioni degli snapshot del progetto una località specifica a tua scelta (ad esempio us-central1), usa 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 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: la policy della località di archiviazione degli snapshot per il progetto. Il valore può essere uno dei seguenti:

    • NEAREST_MULTI_REGION: specifica la policy della località come la multi-regione Cloud Storage più vicina alla località del disco.
    • LOCAL_REGION: specifica la policy della località come la stessa regione Cloud Storage in cui si trova il disco.
    • SPECIFIC_LOCATIONS: specifica la policy della località come 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 multi-regione Cloud Storage. Imposta questo valore sul nome della regione che vuoi specificare come policy della località di archiviazione.

Esempi per impostare la policy della località di archiviazione utilizzando le impostazioni degli snapshot

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

  • Per configurare la policy della località di archiviazione nelle impostazioni degli snapshot del progetto come la multi-regione Cloud Storage più vicina al tuo disco, invia la seguente richiesta PATCH:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

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

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }
  • Per configurare come policy della località di archiviazione nelle impostazioni degli snapshot del progetto una località specifica (ad esempio us-central1), invia 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 specificata dalle impostazioni degli snapshot di un progetto

Puoi visualizzare le impostazioni degli snapshot del tuo progetto utilizzando l'API Compute Engine e 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 snapshot del 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