Ripristinare un disco da uno snapshot istantaneo

Per accedere ai dati acquisiti in uno snapshot istantaneo, devi ripristinare o creare un nuovo disco dallo snapshot istantaneo.

Questa pagina spiega come creare un disco da uno snapshot istantaneo. Dopo aver creato il disco, puoi utilizzarlo collegandolo a una macchina virtuale (VM).

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 ai Google Cloud servizi e alle 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. After installing the Google Cloud CLI, initialize it 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.

        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.

          After installing the Google Cloud CLI, initialize it 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 la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per creare un disco da uno snapshot istantaneo, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

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 creare un disco da uno snapshot istantaneo. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un disco da uno snapshot istantaneo sono necessarie le seguenti autorizzazioni:

  • Per creare un disco:
    • compute.disks.create nel progetto di destinazione per il nuovo disco
    • compute.instantSnapshots.useReadOnly nello snapshot istantaneo di origine

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Si applicano le seguenti limitazioni:

  • Quando crei un disco da uno snapshot istantaneo, il nuovo disco ha sempre lo stesso tipo, la stessa posizione di archiviazione e la stessa crittografia del disco di origine dello snapshot.

  • Non puoi creare una VM direttamente da uno snapshot istantaneo. Devi creare un disco dallo snapshot istantaneo e poi utilizzare il nuovo disco per creare una VM.

  • Se il disco di origine dello snapshot istantaneo utilizza chiavi di crittografia gestite dal cliente o fornite dal cliente, devi fornire la stessa chiave di crittografia quando crei un nuovo disco dallo snapshot istantaneo.

    Considera questo esempio. Immagina di avere un disco, DISK-1 criptato con una chiave di crittografia fornita dal cliente (CSEK), KEY-1. Hai anche uno snapshot istantaneo, IS-1, creato da DISK-1. Per creare un nuovo disco da IS-1, devi fornire la stessa chiave, KEY-1, quando crei il nuovo disco.

    Se il disco è criptato con chiavi di crittografia gestite dal cliente (CMEK), devi fornire la chiave solo se utilizzi REST o gcloud CLI per creare il disco. Se utilizzi la consoleGoogle Cloud , non devi specificare la chiave di crittografia.

Crea un disco da uno snapshot istantaneo

Uno snapshot istantaneo viene criptato con la stessa crittografia del disco di origine. I passaggi per creare un disco da uno snapshot istantaneo dipendono dalla modalità di crittografia del disco di origine dello snapshot istantaneo.

Ogni disco di origine è criptato con uno dei seguenti metodi:

  • Google-owned and Google-managed encryption keys. Questa è l'impostazione predefinita.
  • Chiavi di crittografia gestite dal cliente (CMEK)
  • Chiavi di crittografia fornite dal cliente (CSEK).

Per scoprire come viene criptato un determinato disco, vedi Visualizzare le informazioni sulla crittografia di un disco.

Crea un disco da uno snapshot istantaneo criptato con la crittografia predefinita

Puoi creare un disco da uno snapshot istantaneo con gcloud CLI, la console Google Cloud o REST.

Console

  1. Trova lo snapshot istantaneo che vuoi ripristinare:

    1. Nella console Google Cloud vai alla pagina Snapshot.

      Vai a Snapshot

    2. Fai clic sulla scheda Snapshot istantanei.

    3. Nella colonna Nome, fai clic sul nome dello snapshot istantaneo che vuoi ripristinare.

  2. Fai clic su Crea disco.

  3. Nel campo Nome, inserisci un nuovo nome per il disco.

  4. (Facoltativo) Nel campo Descrizione, inserisci ulteriori dettagli.

  5. Verifica che il Tipo di disco di origine sia Snapshot istantaneo.

  6. Nell'elenco Snapshot istantaneo di origine, scegli lo snapshot istantaneo.

  7. (Facoltativo) Configura personalizzazioni aggiuntive per il disco.

    • Inserisci una dimensione: nel campo Dimensione, specifica una dimensione per il disco in GB. che devono essere uguali o maggiori della dimensione del disco di origine dello snapshot.
    • Pianifica backup: se vuoi che Compute Engine crei snapshot standard di questo nuovo disco in base a una pianificazione, seleziona la casella di controllo Abilita pianificazione snapshot e scegli una pianificazione degli snapshot. In caso contrario, deseleziona la casella di controllo.

  8. (Facoltativo) Per organizzare il progetto, aggiungi una o più etichette.

  9. Per creare il disco, fai clic su Crea.

gcloud

Utilizza il comando gcloud compute disks create. Gli argomenti che specifichi dipendono dal fatto che tu stia creando un disco a livello di zona o di regione.

Crea un disco di zona

Specifica la zona con il flag --zone:

gcloud compute disks create DISK_NAME --zone=ZONE \
  --source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT_NAME

Sostituisci quanto segue:

  • DISK_NAME: il nome del nuovo disco.
  • ZONE: la zona del nuovo disco, ad esempio europe-west1-a.
  • SOURCE_INSTANT_SNAPSHOT_NAME: il nome dello snapshot istantaneo di origine.

Crea un disco regionale

Specifica la regione con --region e le zone di replica di destinazione del nuovo disco con --replica-zones.

gcloud compute disks create DISK_NAME \
 --region=REGION \
 --source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT_NAME \
 --replica-zones=ZONE1,ZONE2

Sostituisci quanto segue:

  • DISK_NAME: il nome del nuovo disco.
  • REGION: la regione in cui deve risiedere il disco regionale, ad esempio europe-west1.
  • SOURCE_INSTANT_SNAPSHOT_NAME: il nome dello snapshot istantaneo di origine.
  • ZONE1,ZONE2: le zone all'interno della regione in cui si trovano le due repliche del disco, ad esempio: europe-west1-b,europe-west1-c.

REST

Per creare un disco a livello di zona o di regione da uno snapshot istantaneo, utilizza il metodo disks.insert. Il nuovo disco deve essere dello stesso tipo del disco di origine dello snapshot istantaneo. Ad esempio, non puoi creare un disco di una regione da uno snapshot di un disco di una zona.

Crea un disco di zona

Invia una richiesta POST specificando lo snapshot istantaneo di origine.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/SOURCE_ZONE/disks/insert
{
"name": "NEW_DISK_NAME",
"sourceInstantSnapshot": "projects/PROJECT/zones/SOURCE_ZONE/instantSnapshots/SOURCE_INSTANT_SNAPSHOT_NAME"
}

Sostituisci quanto segue:

  • PROJECT: il progetto in cui creare il nuovo disco.
  • SOURCE_ZONE: la zona in cui si trova lo snapshot istantaneo, ad esempio us-central1-a. Il disco viene creato in questa zona.
  • NEW_DISK_NAME: un nome univoco per il nuovo disco.
  • SOURCE_INSTANT_SNAPSHOT_NAME: il nome dello snapshot istantaneo di origine.

Crea un disco regionale

Invia una richiesta POST specificando lo snapshot istantaneo di origine e le zone in cui deve essere replicato il disco.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/region/SOURCE_REGION/disks/insert

{
"name": "NEW_DISK_NAME",
"sourceInstantSnapshot": "projects/PROJECT/regions/SOURCE_REGION/instantSnapshots/SOURCE_INSTANT_SNAPSHOT_NAME",
"replicaZones": [
  "projects/PROJECT/zones/ZONE1",
  "projects/PROJECT/zones/ZONE2"
]
}

Sostituisci quanto segue:

  • PROJECT: il progetto in cui creare il nuovo disco.
  • SOURCE_REGION: la regione in cui si trova lo snapshot istantaneo. Il disco viene creato in questa regione.
  • NEW_DISK_NAME: un nome univoco per il nuovo disco.
  • SOURCE_INSTANT_SNAPSHOT_NAME: il nome dello snapshot istantaneo di origine.
  • ZONE1,ZONE2: le zone all'interno della regione per le due repliche del disco, ad esempio europe-west1-b,europe-west1-c.

Risposta alla richiesta API

Se la richiesta POST ha esito positivo, il corpo della risposta sarà un oggetto che puoi eseguire il polling per ottenere lo stato della creazione del disco. Per ulteriori informazioni, consulta la sezione Gestione delle risposte dell'API.

Crea un disco da uno snapshot istantaneo criptato con CMEK o CSEK

Console

Se lo snapshot istantaneo utilizza la crittografia CMEK o predefinita di Google,la console Google Cloud fornisce automaticamente la chiave di crittografia quando crei un disco dallo snapshot istantaneo. In caso contrario, se lo snapshot istantaneo è criptato con CSEK, devi fornire la chiave di crittografia per creare un disco.

Segui i passaggi nella sezione Crittografia gestita da Google, specificando la chiave di crittografia utilizzando queste istruzioni:

  1. Nella sezione Decrittografia, inserisci la chiave di crittografia nel campo Chiave di crittografia.
  2. Se la chiave è sottoposta a wrapping con la chiave RSA pubblica, seleziona Chiave con wrapping.

gcloud

Utilizza il comando gcloud compute disks create.

Se il disco di origine è criptato con CMEK, utilizza il parametro --kms-key per fornire il nome della chiave.

Se il disco di origine è criptato con CSEK, utilizza il parametro --csek-key-file per specificare la chiave di crittografia del disco di origine.

CMEK

Per creare un disco di zona da uno snapshot istantaneo criptato con CMEK, utilizza il seguente comando:

     gcloud compute disks create NEW_DISK_NAME \
       --zone=SOURCE_ZONE \
       --source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT_NAME \
       --kms-key=projects/KMS_PROJECT_NAME/locations/KEYRING_LOCATION/keyRings/KEY_RING_NAME/cryptoKeys/KEY_NAME

Sostituisci quanto segue:

  • NEW_DISK_NAME: il nome del nuovo disco.
  • SOURCE_ZONE: la zona in cui è archiviato lo snapshot istantaneo, ad esempio europe-west1-a.
  • SOURCE_INSTANT_SNAPSHOT_NAME: il nome dello snapshot istantaneo di origine.
  • KMS_PROJECT_NAME: il progetto contenente la chiave.
  • KEYRING_LOCATION: la posizione delle chiavi automatizzate a cui appartiene la chiave. Se il keyring è globale, specifica global. In caso contrario, specifica il nome della regione in cui si trova il keyring, ad esempio us-west1.
  • KEY_RING_NAME: il nome del portachiavi che include la chiave, ad esempio key-ring-1.
  • KEY_NAME: il nome della chiave utilizzata per criptare il disco.

CSEK

Per creare un disco di zona da uno snapshot istantaneo criptato con CSEK, utilizza questo comando:

     gcloud compute disks create NEW_DISK_NAME \
       --zone=SOURCE_ZONE \
       --source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT_NAME \
       --csek-key-file=PATH_TO_CSEK_JSON_FILE

Sostituisci quanto segue:

  • NEW_DISK_NAME: il nome del nuovo disco.
  • SOURCE_ZONE: la zona in cui è archiviato lo snapshot istantaneo, ad esempio europe-west1-a.
  • SOURCE_INSTANT_SNAPSHOT_NAME: il nome dello snapshot istantaneo di origine.
  • CSEK_JSON_FILE: percorso di un file JSON contenente la chiave. Vedi un esempio del formato del file CSEK.

Per creare un disco regionale, sostituisci il flag --zone nell'esempio precedente con i seguenti flag:

  • --region: la regione del nuovo disco
  • --replica-zones: le zone all'interno della regione per le due repliche del disco.

REST

Per creare un disco regionale o di zona da uno snapshot istantaneo criptato con CMEK o CSEK, invia una richiesta POST al metodo disks.insert utilizzando le proprietà elencate nella sezione Crittografia gestita da Google.

Inoltre, fornisci la chiave di crittografia del disco di origine con il campo diskEncryptionKey. Le proprietà del campo diskEncryptionKey dipendono dal fatto che il disco sia criptato con CMEK o CSEK.

Gli esempi seguenti mostrano come creare un nuovo disco di zona per ogni tipo di crittografia.

CMEK

Nel corpo della richiesta, specifica il nome della chiave con la proprietà diskEncryptionKey.kmsKeyName:

{
"name": "NEW_DISK_NAME",
"sourceInstantSnapshot": "projects/PROJECT/zones/SOURCE_ZONE/instantSnapshots/SOURCE_INSTANT_SNAPSHOT_NAME",
"diskEncryptionKey": {
      "kmsKeyName": "projects/KMS_PROJECT/locations/LOCATION/keyRings/KEYRING_LOCATION/cryptoKeys/KEY_NAME"
  }
}

Sostituisci quanto segue:

  • NEW_DISK_NAME: un nome univoco per il nuovo disco.
  • PROJECT: il progetto in cui creare il nuovo disco.
  • SOURCE_ZONE: la zona in cui si trova lo snapshot istantaneo, ad esempio us-central1-a. Il disco viene creato in questa zona.
  • SOURCE_INSTANT_SNAPSHOT_NAME: il nome dello snapshot istantaneo di origine.
  • KMS_PROJECT: il progetto contenente la chiave.
  • LOCATION: la posizione delle chiavi automatizzate a cui appartiene la chiave. Se il keyring è globale, specifica global. In caso contrario, specifica il nome della regione in cui si trova il keyring, ad esempio us-west1.
  • KEY_RING: il nome delle chiavi automatizzate che includono la chiave, ad esempio key-ring-1.
  • KEY: il nome della chiave utilizzata per criptare il disco.

CSEK

Il corpo della richiesta dipende dal fatto che la CSEK utilizzata per criptare lo snapshot istantaneo sia criptata con RSA o meno.

Per utilizzare una chiave non criptata con RSA, specifica la chiave nella proprietà diskEncryptionKey.rawKey del corpo della richiesta:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/SOURCE_ZONE/disks/insert
{
  "name": "NEW_DISK_NAME",
  "sourceInstantSnapshot": "projects/PROJECT/zones/SOURCE_ZONE/instantSnapshots/INSTANT_SNAPSHOT_NAME,
  "diskEncryptionKey": {
      "rawKey": "RAW_ENCRYPTION_KEY"
  }
}

Sostituisci quanto segue con i valori corrispondenti:

  • PROJECT: il progetto in cui creare il nuovo disco.
  • SOURCE_ZONE: la zona in cui si trova lo snapshot istantaneo, ad esempio us-central1-a. Il disco viene creato in questa zona.
  • NEW_DISK_NAME: un nome univoco per il nuovo disco.
  • SOURCE_INSTANT_SNAPSHOT_NAME: il nome dello snapshot istantaneo di origine.
  • RAW_ENCRYPTION_KEY: la chiave utilizzata per criptare lo snapshot istantaneo e il relativo disco di origine, ad esempio SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=.

Per utilizzare una chiave criptata con RSA, modifica l'esempio precedente nel seguente modo:

  • Invia una richiesta POST al metodo disks.insert: 

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/insert

  • Specifica la chiave nella proprietà diskEncryptionKey.rsaEncryptedKey del corpo della richiesta: 

    "diskEncryptionKey": {
 "rsaEncryptedKey": "RSA_ENCRYPTED_KEY"
}

Sostituisci RSA_ENCRYPTED_KEY con la chiave criptata.

Risposta alla richiesta API

Se la richiesta POST ha esito positivo, il corpo della risposta sarà un oggetto che puoi eseguire il polling per ottenere lo stato della creazione del disco. Per ulteriori informazioni, consulta la sezione Gestione delle risposte dell'API.