Imposta le posizioni di creazione e ripristino per gli snapshot a livello regionale

---

Anteprima

Questo prodotto o questa funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per impostazione predefinita, gli snapshot vengono creati con un ambito globale. Gli snapshot con ambito globale vengono archiviati in una posizione di archiviazione specifica e possono essere ripristinati (utilizzati per creare un nuovo disco) in qualsiasi regione o zona. Per un controllo aggiuntivo dell'isolamento basato sulla posizione, puoi creare snapshot con ambito a livello regionale. Gli snapshot con ambito regionale memorizzano tutti i dati e i metadati degli snapshot insieme nella regione con ambito. Con gli snapshot con ambito a livello di regione, puoi anche limitare le regioni in cui puoi creare e ripristinare gli snapshot.

Questo documento spiega come impostare le località consentite per la creazione e il ripristino di snapshot regionali.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo di verifica dell'identità per poter accedere a Google Cloud servizi e API. 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:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

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

     gcloud init

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

     Nota:se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
  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.

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

  gcloud init

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

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

Limitazioni

• L'impostazione di un ambito regionale sostituisce tutte le impostazioni della posizione di archiviazione predefinita per il progetto.
• L'impostazione di un ambito regionale si applica solo ai nuovi snapshot regionali.
• Non puoi convertire uno snapshot con ambito globale in uno snapshot con ambito a livello di regione. Devi creare un nuovo snapshot con l'ambito appropriato.

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per impostare le posizioni di archiviazione e ripristino per gli snapshot con ambito regionale, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

• Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)
• Per connetterti a una VM che può essere eseguita come account di servizio: Service Account User (v1) (roles/iam.serviceAccountUser)

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 impostare le posizioni di creazione e ripristino degli snapshot. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

• Per impostare le posizioni di creazione degli snapshot consentite su regioni diverse da quella del disco di origine:
• compute.diskSettings.get sul disco
• compute.diskSettings.update sul disco
• compute.regionDiskSettings.get sul disco
• compute.regionDiskSettings.update sul disco
• Per impostare le posizioni di ripristino degli snapshot consentite su regioni diverse da quella del disco di origine:
• compute.regionSnapshotSettings.get sul progetto
• compute.regionSnapshotSettings.update sul progetto

Imposta le posizioni di creazione degli snapshot consentite

Per impostazione predefinita, puoi creare snapshot in tutte le regioni. Per limitare le posizioni in cui puoi creare snapshot con ambito a livello di regione, imposta le posizioni di accesso consentite a livello di progetto. Una volta impostate le posizioni di accesso, puoi creare snapshot con ambito regionale per il progetto solo in queste posizioni.

gcloud

Per consentire ai dischi a livello di zona nella zona A di creare snapshot in qualsiasi regione, utilizza il comando gcloud beta compute disk-settings update:

  gcloud beta compute disk-settings update \
      --zone=ZONE_A \
      --access-location-policy=all-regions \

Per consentire ai dischi a livello di regione nella regione A di creare snapshot in qualsiasi regione, utilizza il comando gcloud beta compute disk-settings update:

  gcloud beta compute disk-settings update \
      --region=REGION_A \
      --access-location-policy=all-regions

Per consentire ai dischi nella regione A di creare snapshot solo nella regione B, utilizza il comando gcloud beta compute disk-settings update:

  gcloud beta compute disk-settings update \
      --access-location-policy=specific-regions \
      --region=REGION_A \
      --add-access-locations=REGION_B

Sostituisci quanto segue:

• ZONE_A: la zona dei dischi che possono creare snapshot in qualsiasi regione.
• REGION_A: la regione di tutti i dischi (in un progetto) che richiedono limitazioni alla creazione di snapshot con ambito a livello di regione.
• REGION_B: Una regione consentita per la creazione di snapshot con ambito a livello di regione. Puoi impostare più regioni come posizioni di accesso consentite. Devi includere la regione in cui è archiviato il disco di origine tra le regioni consentite.

REST

Per consentire ai dischi a livello di zona nella zona A di creare snapshot in qualsiasi regione, invia una richiesta PATCH al metodo diskSettings.patch:

  PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE_A/diskSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"ALL_REGIONS"
    }
  }

Per consentire ai dischi regionali nella regione A di creare snapshot solo nella regione B, invia una richiesta PATCH al metodo regionDiskSettings.patch:

  PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION_A/diskSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"SPECIFIC_REGIONS",
      "locations":
      {
        "REGION_B":{"region":"REGION_B"}
      }
    }
  }

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto.
• ZONE_A: la zona del disco.
• REGION_A: la regione del disco.
• REGION_B: una regione consentita per la creazione di snapshot. Puoi impostare più regioni come posizioni di accesso consentito. Devi includere la regione in cui è archiviato il disco di origine come una delle regioni consentite.

Imposta le posizioni di ripristino degli snapshot consentite

Per impostazione predefinita, puoi ripristinare gli snapshot a livello regionale e globale in qualsiasi regione. Per configurare le posizioni di ripristino per gli snapshot con ambito a livello di regione, imposta le posizioni di accesso consentite a livello di progetto. Devi impostare le posizioni di accesso consentite per ogni progetto singolarmente. Una volta impostate le posizioni di accesso, puoi ripristinare gli snapshot con ambito regionale per il progetto solo in queste posizioni.

gcloud

Per consentire il ripristino degli snapshot per un progetto nella regione A in tutte le regioni, utilizza il comando gcloud beta compute snapshot-settings update:

  gcloud beta compute snapshot-settings update \
      --project=PROJECT_ID \
      --region=REGION_A \
      --access-location-policy=all-regions

Per consentire il ripristino degli snapshot per un progetto nella regione A solo nella regione B, utilizza il comando gcloud beta compute snapshot-settings update:

  gcloud beta compute snapshot-settings update \
      --project=PROJECT_ID \
      --access-location-policy=specific-regions \
      --region=REGION_A \
      --add-access-locations=REGION_B

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto.
• REGION_A: la regione in cui sono archiviati gli snapshot con ambito a livello di regione.
• REGION_B: Una regione consentita in cui è possibile ripristinare gli snapshot con ambito a livello di regione. Puoi impostare più regioni come posizioni di ripristino consentite.

REST

Per consentire il ripristino degli snapshot per un progetto nella regione A in tutte le regioni, invia una richiesta PATCH al metodo regionSnapshotSettings.patch:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/snapshotSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"ALL_REGIONS"
    }
  }

Per consentire il ripristino degli snapshot per un progetto nella regione A solo nella regione B, invia una richiesta PATCH al metodo regionSnapshotSettings.patch:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/snapshotSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"SPECIFIC_REGIONS",
      "locations":
        {"REGION_B":
          {"region":"REGION_B"}
        }
    }
  }

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto.
• REGION_A: la regione in cui sono archiviati gli snapshot con ambito a livello di regione.
• REGION_B: Una regione consentita in cui è possibile ripristinare gli snapshot con ambito a livello di regione. Puoi impostare più regioni come posizioni di ripristino consentite.

Modifica le posizioni di ripristino degli snapshot consentite

gcloud

Per visualizzare le posizioni di ripristino consentite per gli snapshot di un progetto archiviato nella regione A, utilizza il comando gcloud beta compute snapshot-settings describe:

  gcloud beta compute snapshot-settings describe \
      --project=PROJECT_ID \
      --region=REGION_A

Per rimuovere la regione B dall'elenco delle posizioni di ripristino consentite per gli snapshot di un progetto archiviato nella regione A, utilizza il comando gcloud beta compute snapshot-settings update:

  gcloud beta compute snapshot-settings update \
      --project=PROJECT_ID \
      --access-location-policy=specific-regions \
      --remove-access-locations=REGION_B \
      --region=REGION_A

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto.
• REGION_A: la regione in cui sono archiviati gli snapshot con ambito a livello di regione.
• REGION_B: la regione in cui vuoi rimuovere l'accesso al ripristino per gli snapshot con ambito a livello di regione.

REST

Per visualizzare le posizioni di ripristino consentite per gli snapshot di un progetto archiviato nella regione A, invia una richiesta GET al metodo regionSnapshotSettings.get:

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

Per rimuovere la regione B dall'elenco delle località di ripristino consentite per gli snapshot di un progetto archiviato nella regione A, invia una richiesta PATCH al metodo regionSnapshotSettings.patch:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/snapshotSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"SPECIFIC_REGIONS",
      "locations":
        {"REGION_B":{}}
    }
  }

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto.
• REGION_A: la regione in cui sono archiviati gli snapshot con ambito a livello di regione.
• REGION_B: la regione in cui vuoi rimuovere l'accesso al ripristino per gli snapshot con ambito a livello di regione.