Questa pagina è stata tradotta dall'API Cloud Translation.

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 è 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:
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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

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:

Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1)
Per connetterti a una VM che può essere eseguita come account di servizio: Utente account di servizio (v1) (roles/iam.serviceAccountUser)

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare un disco da uno snapshot istantaneo. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

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 del nuovo disco
- compute.instantSnapshots.useReadOnly sullo 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 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 la API REST o la gcloud CLI per creare il disco. Se utilizzi la console Google Cloud, non devi specificare la chiave di crittografia.

Creare 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 da come viene criptato il disco di origine dello snapshot istantaneo.

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

Chiavi di proprietà di Google e gestite da Google. Questa è l'impostazione predefinita.
Chiavi di crittografia gestite dal cliente (CMEK)
Chiavi di crittografia fornite dal cliente (CSEK).

Per scoprire in che modo viene criptato un determinato disco, consulta Visualizzare informazioni sulla crittografia di un disco.

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

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

Console

Individua l'istantanea istantanea che vuoi ripristinare:
1. Nella console Google Cloud, vai alla pagina Snapshot.
  
  Vai a Snapshot
2. Fai clic sulla scheda Istantanee.
3. Nella colonna Nome, fai clic sul nome dello snapshot istantaneo che vuoi ripristinare.
Fai clic su Crea disco.
Nel campo Nome, inserisci un nuovo nome per il disco.
(Facoltativo) Nel campo Descrizione, inserisci ulteriori dettagli.
Verifica che il Tipo di disco di origine sia Snapshot istantaneo.
Nell'elenco Snapshot istantaneo di origine, scegli lo snapshot istantaneo.
(Facoltativo) Configura personalizzazioni aggiuntive per il disco.
- Inserisci una dimensione: nel campo Dimensione, specifica una dimensione per il disco in GB. Le dimensioni devono essere uguali o maggiori a quelle del disco di origine per lo snapshot.
- Pianifica i 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.
(Facoltativo) Per organizzare il progetto, aggiungi una o più etichette.
Per creare il disco, fai clic su Crea.

gcloud

Utilizza il comando gcloud compute disks create. Gli argomenti specificati dipendono dal fatto che tu stia creando un disco di un'area geografica o di una zona.

Crea un disco zonale

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 target 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 trovarsi 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 dove 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 zonale.

Crea un disco zonale

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 sottoporre a polling per ottenere lo stato della creazione del disco. Per ulteriori informazioni, consulta la sezione Gestire le risposte dell'API.

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

Console

Se lo snapshot istantaneo utilizza la crittografia predefinita di Google o CMEK, 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 sulla crittografia gestita da Google, specificando la chiave di crittografia seguendo queste istruzioni:

Nella sezione Decrittografia, inserisci la chiave di crittografia nel campo Chiave di crittografia.
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 zonale 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 del keyring 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 keyring 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 zonale da uno snapshot istantaneo criptato con CSEK, utilizza il seguente 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. Guarda un esempio del formato 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 zonale o regionale da uno snapshot istantaneo con crittografia 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 o meno criptato con CMEK o CSEK.

Gli esempi riportati di seguito mostrano come creare un nuovo disco zonale 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 del keyring 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 del keyring che include 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 immediato sia o meno criptata con RSA.

Per utilizzare una chiave non elaborata (non criptata con RSA), specificala 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 come segue:

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 tua chiave criptata.