Questo documento spiega come creare e gestire snapshot istantanei. Gli snapshot istantanei acquisiscono i contenuti di un disco e possono essere utilizzati per creare un nuovo disco in pochi minuti.
Gli snapshot istantanei vengono archiviati nello stesso o regione come dischi di origine non sostituiscono gli snapshot standard, che offrono backup esterni al sito per il ripristino di emergenza. Scopri di più sull'altro opzioni di protezione dei dati disponibili in Compute Engine.
Per accedere ai dati di uno snapshot istantaneo, utilizza lo snapshot istantaneo per creare un nuovo disco.
Se vuoi copiare uno snapshot istantaneo in un'altra posizione o conservarlo dopo l'eliminazione del disco di origine, e puoi creare uno snapshot standard dallo snapshot istantaneo.
Prima di iniziare
- Esamina il limitazioni per gli snapshot istantanei per assicurarti che gli snapshot istantanei siano adatti al tuo caso d'uso.
-
Se non l'hai già fatto, configura l'autenticazione.
Autenticazione è
Il processo di verifica dell'identità per l'accesso ai servizi e alle API di 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:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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.
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.
-
Ruoli e autorizzazioni richiesti
Per ottenere le autorizzazioni necessarie per creare snapshot istantanei, chiedi all'amministratore di concederti seguenti ruoli IAM sul progetto:
-
Amministratore istanze Compute (v1) (
roles/compute.instanceAdmin.v1
) -
Per connetterti a una VM che possa 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 le autorizzazioni necessarie per creare snapshot istantanei. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare snapshot istantanei sono necessarie le seguenti autorizzazioni:
-
Per creare uno snapshot istantaneo:
compute.instantSnapshots.create
-
Per visualizzare gli snapshot istantanei:
compute.instantSnapshots.list
-
Per visualizzare i dettagli degli snapshot istantanei:
compute.instantSnapshots.get
-
Per eliminare uno snapshot istantaneo:
compute.instantSnapshots.delete
Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.
Crea uno snapshot istantaneo di un volume di un Persistent Disk
Gli snapshot istantanei dei dischi a livello di zona vengono archiviati come disco di origine. Allo stesso modo, gli snapshot istantanei dei dischi a livello di regione delle stesse regioni del disco.
Puoi creare uno snapshot istantaneo di un volume di Persistent Disk a livello di zona o di regione utilizzando gcloud CLI, la console Google Cloud o REST.
Console
Nella console Google Cloud, vai alla pagina Istanze VM.
Seleziona il progetto con cui vuoi lavorare.
Nella colonna Nome, fai clic sul nome della VM collegata al disco di cui vuoi eseguire il backup.
Nella sezione Archiviazione, seleziona un disco in uno dei seguenti modi:
- Per eseguire il backup del disco di avvio della VM, nella sezione Disco di avvio, Fai clic sul nome del disco di avvio.
- Per eseguire il backup di un volume del disco permanente collegato, fai clic sul nome del volume del disco permanente collegato nella sezione Dischi aggiuntivi.
Per completare la creazione di uno snapshot istantaneo, nella pagina Crea uno snapshot: procedi nel seguente modo:
- Nel campo Nome, inserisci un nome univoco per identificare lo snapshot istantaneo.
- (Facoltativo) Aggiungi ulteriori dettagli sullo snapshot nel campo Descrizione.
- Nel campo Tipo, seleziona Istantanea istantanea. Il campo Località viene impostato automaticamente sulla stessa zona o regione del disco.
- Nel campo Tipo di origine snapshot, verifica che sia selezionato Disco.
- (Facoltativo) Per organizzare il progetto, aggiungi una o più etichette.
- Fai clic su Crea.
gcloud
Per creare uno snapshot istantaneo, utilizza
gcloud compute instant-snapshots create
:
Disco di zona
Per creare uno snapshot istantaneo di un disco di zona:
gcloud compute instant-snapshots create INSTANT_SNAPSHOT_NAME \ --source-disk=SOURCE_DISK_NAME \ --zone=SOURCE_DISK_ZONE
Sostituisci quanto segue:
INSTANT_SNAPSHOT_NAME
: un nome univoco per lo snapshot istantaneo.SOURCE_DISK_NAME
: il nome del disco di origine.SOURCE_DISK_ZONE
: la zona del disco di origine. Lo snapshot istantaneo verrà creato nella stessa zona.
Disco regionale
Per creare uno snapshot istantaneo di un disco di una regione:
gcloud compute instant-snapshots create INSTANT_SNAPSHOT_NAME \ --source-disk=SOURCE_DISK_NAME \ --region=SOURCE_DISK_REGION
Sostituisci quanto segue:
INSTANT_SNAPSHOT_NAME
: un nome univoco per lo snapshot istantaneo.SOURCE_DISK_NAME
: il nome del disco di origine.SOURCE_DISK_REGION
: la regione dell'origine disco. Lo snapshot istantaneo verrà creato nella stessa regione.
REST
Per creare uno snapshot istantaneo, effettua una richiesta POST
alla
instantSnapshots.insert
.
Crea uno snapshot istantaneo di un disco di zona:
Specifica la zona nell'URL della richiesta
POST
. Nel corpo della richiesta, specifica un nome per il nuovo snapshot e l'URL del disco di origine.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/DISK_ZONE/instantSnapshots { "name": "INSTANT_SNAPSHOT_NAME", "sourceDisk": "projects/PROJECT_ID/zones/DISK_ZONE/disks/SOURCE_DISK_NAME" }
Sostituisci quanto segue con i valori corrispondenti:
PROJECT_ID
: il nome del progetto contenente il disco.DISK_ZONE
: la zona in cui si trova il disco. lo snapshot istantaneo verrà creato in questa zona.INSTANT_SNAPSHOT_NAME
: un nome univoco per lo snapshot istantaneo.SOURCE_DISK_NAME
: il nome del disco di origine.
Crea uno snapshot istantaneo di un disco di una regione:
Specifica la regione nell'URL della richiesta
POST
. Includi il nome e il disco di origine del nuovo snapshot nel corpo della richiesta.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/DISK_REGION/instantSnapshots { "name": "INSTANT_SNAPSHOT_NAME", "sourceDisk": "projects/PROJECT_ID/regions/DISK_REGION/disks/SOURCE_DISK_NAME" }
Sostituisci quanto segue nel corpo della richiesta con i valori corrispondenti:
PROJECT_ID
: il nome del progetto contenente il disco.DISK_REGION
: la regione in cui si trova il disco di origine. Lo snapshot verrà creato nella stessa regione.INSTANT_SNAPSHOT_NAME
: un nome univoco per lo snapshot.SOURCE_DISK_NAME
: il nome del disco di origine.
Richiedi risposta
Se la richiesta POST
ha esito positivo, il corpo della risposta sarà un oggetto
che puoi sottoporre a polling per ottenere lo stato di creazione dello snapshot istantaneo. Consulta
Gestione delle risposte dell'API
per ulteriori informazioni.
Ripristina uno snapshot istantaneo in un nuovo volume del Persistent Disk
Per ripristinare i dati di cui è stato eseguito il backup con uno snapshot istantaneo, crea un nuovo disco dallo snapshot istantaneo.
Visualizza gli snapshot istantanei in un progetto o in una località
Puoi visualizzare l'elenco di tutti gli snapshot istantanei in un progetto o in una località utilizzando gcloud CLI, la console Google Cloud o REST.
Console
Nella console Google Cloud, vai alla pagina Snapshot.
Fai clic sulla scheda Snapshot istantanei. Viene visualizzato l'elenco di snapshot istantanei.
(Facoltativo) Restringi i risultati utilizzando il campo Filtro filter_list. Inserisci una proprietà nome o valore nel campo filter_list Filtro oppure scegli una delle proprietà disponibili.
gcloud
Puoi elencare gli snapshot istantanei in un progetto o una posizione specifici con il comando
gcloud compute instant-snapshots list
.
Elenca tutti gli snapshot in un progetto o quelli in una zona o regione:
Elenca tutti gli snapshot istantanei in un determinato progetto:
gcloud compute instant-snapshots list --project=PROJECT_ID
Sostituisci
PROJECT_ID
con l'ID del progetto.Elenca gli snapshot istantanei in una zona con l'argomento
--zones
:gcloud compute instant-snapshots list --zones=ZONE
Sostituisci
ZONE
con il nome della zona target.Elenca gli snapshot istantanei a livello di regione in una regione utilizzando
--regions
argomento:gcloud compute instant-snapshots list --regions=REGION
Sostituisci
REGION
: con il nome del target regione.
REST
Puoi recuperare un elenco degli snapshot istantanei in un progetto specifico o in ogni località.
Elenca gli snapshot di un progetto:
Invia una richiesta
GET
al metodo instantSnapshots.aggregatedList:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/instantSnapshots
Sostituisci
PROJECT_ID
con l'ID del progetto.Elenca gli snapshot istantanei in una zona o in una regione:
Invia una richiesta
GET
a instantSnapshots.list.Elenca gli snapshot istantanei in una zona:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/SOURCE_ZONE//instantSnapshots
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto.SOURCE_ZONE
: la zona target, per ad esempious-west1-a
.
Elenca gli snapshot istantanei a livello di regione in una regione:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SOURCE_REGION/instantSnapshots
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto.SOURCE_REGION
: la regione target, per ad esempious-west1
.
Visualizza gli snapshot istantanei per un disco
Puoi visualizzare l'elenco di snapshot istantanei per un disco utilizzando il comando gcloud CLI, console Google Cloud o REST.
Console
Nella console Google Cloud, vai alla pagina Snapshot.
Fai clic sulla scheda Snapshot istantanei. L'elenco di tutte le vengono visualizzati snapshot istantanei nel progetto.
Restringi i risultati in base al disco di origine:
Inserisci
Source disk:
nel filter_list Filtro.Viene visualizzato un elenco di dischi con snapshot istantanei.
Seleziona il nome del disco dall'elenco Valori. L'elenco di istanze mostra tutti gli snapshot istantanei relativi al disco.
Se non vedi il nome di un disco nella filter_list Filtro, digita le prime lettere del nome del disco modificare l'elenco delle opzioni filtrate che vedi.
gcloud
Elenca gli snapshot istantanei per un disco con
gcloud compute instant-snapshots list
e il comando--filter
argomento:Elenca gli snapshot istantanei per un disco a livello di zona:
gcloud compute instant-snapshots list \ --filter="sourceDisk:projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto.ZONE
: il nome della zona per il disco, ad esempious-west1-a
.DISK_NAME
: il nome del disco di origine, ad esempiodisk-1
.
Elenca gli snapshot istantanei per un disco di una regione:
gcloud compute instant-snapshots list \ --filter=sourceDisk:projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto.SOURCE_REGION
: il nome della regione per il disco, ad esempious-west1
.DISK_NAME
: il nome del disco, ad esempiodisk-1
.
REST
Elenca gli snapshot istantanei per un disco a livello di zona o di regione con una richiesta GET
alle
instantSnapshots.list
.
Utilizza il parametro di query filter=sourceDisk
per specificare il nome del disco.
Elenca gli snapshot istantanei per un volume di Persistent Disk a livello di zona:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/SOURCE_ZONE/instantSnapshots?filter=sourceDisk:'https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME'
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto.SOURCE_ZONE
: la zona target, ad esempious-west1-a
.DISK_NAME
: il nome del disco di origine, ad esempiodisk-1
.
Elenca gli snapshot istantanei per un volume di Persistent Disk regionale:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SOURCE_REGION/instantSnapshots?filter=sourceDisk:'https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME'
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto.SOURCE_REGION
: la regione target, ad esempious-west1
.DISK_NAME
: il nome del disco di origine, ad esempiodisk-1
.
Visualizza le informazioni su uno snapshot istantaneo
Recupera informazioni dettagliate su uno snapshot istantaneo, come la sua posizione, disco di origine e le dimensioni utilizzando gcloud CLI, la console Google Cloud o REST.
Console
Nella console Google Cloud, vai alla pagina Snapshot.
Fai clic sulla scheda Snapshot istantanei. Viene visualizzato l'elenco di snapshot istantanei.
Nella colonna Nome, fai clic sul nome dello snapshot istantaneo. La Viene visualizzata la pagina Dettagli snapshot istantaneo per lo snapshot selezionato. ne mostra le proprietà.
gcloud
Per visualizzare le informazioni su uno snapshot istantaneo, utilizza la
gcloud compute instant-snapshots describe
.Se lo snapshot proviene da un disco a livello di zona, specifica la zona con il flag
--zone
:gcloud compute instant-snapshots describe INSTANT_SNAPSHOT_NAME \ --zone=ZONE
Sostituisci quanto segue con i valori corrispondenti:
INSTANT_SNAPSHOT_NAME
: il nome dello snapshot istantaneo.ZONE
: la zona in cui è stato creato lo snapshot istantaneo creato, ad esempious-west1-a
.
Se lo snapshot è relativo a un disco di una regione, specifica la regione con il flag
--region
:gcloud compute instant-snapshots describe INSTANT_SNAPSHOT_NAME \ --region=REGION
Sostituisci quanto segue con i valori corrispondenti:
INSTANT_SNAPSHOT_NAME
: il nome dell'istantaneo senza dover creare uno snapshot.REGION
: la regione in cui è stato creato lo snapshot creato, ad esempious-central1
.
REST
La richiesta del metodo API che utilizzi dipende dal fatto che tu con uno snapshot istantaneo a livello di regione o zona.
Snapshot istantaneo zonale
Invia una richiesta GET
al metodo
instantSnapshots.get
specificando la zona nella richiesta:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instantSnapshots/INSTANT_SNAPSHOT_NAME
Sostituisci quanto segue con i valori corrispondenti:
PROJECT_ID
: il nome del progetto che contiene lo snapshot istantaneo.ZONE
: la zona in cui è stato creato lo snapshot istantaneo.INSTANT_SNAPSHOT_NAME
: il nome dello snapshot istantaneo.
Snapshot istantaneo a livello di regione
Invia una richiesta GET
al metodo
instantSnapshots.get
specificando la regione nella richiesta:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instantSnapshots/INSTANT_SNAPSHOT_NAME
Sostituisci quanto segue con i valori corrispondenti:
PROJECT_ID
: il nome del progetto contenente lo snapshot istantaneo.REGION
: la regione in cui è stato creato lo snapshot istantaneo.INSTANT_SNAPSHOT_NAME
: il nome dello snapshot istantaneo.
Elimina uno snapshot istantaneo
Puoi eliminare uno snapshot istantaneo utilizzando gcloud CLI, nella console Google Cloud o REST.
Console
Nella console Google Cloud, vai alla pagina Snapshot.
Fai clic sulla scheda Istantanee.
Seleziona un altro snapshot da eliminare.
Nella parte superiore della pagina Snapshot, fai clic su Elimina.
gcloud
Elimina uno snapshot istantaneo con
gcloud compute instant-snapshots delete
specificando la zona di origine o la regione di origine.
Elimina uno snapshot istantaneo di un disco di zona:
gcloud compute instant-snapshots delete INSTANT_SNAPSHOT_NAME \ --zone=ZONE
Sostituisci quanto segue con i valori corrispondenti:
ZONE
: il nome della zona.INSTANT_SNAPSHOT_NAME
: il nome dello snapshot istantaneo.
Elimina uno snapshot istantaneo di un disco di una regione:
gcloud compute instant-snapshots delete INSTANT_SNAPSHOT_NAME \ --region=REGION
Sostituisci quanto segue:
REGION
: il nome della regione.INSTANT_SNAPSHOT_NAME
: il nome dello snapshot istantaneo.
REST
Elimina uno snapshot istantaneo con una richiesta DELETE
alla
instantSnapshots.delete
:
Elimina uno snapshot istantaneo del disco di zona:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instantSnapshots/INSTANT_SNAPSHOT_NAME
Sostituisci quanto segue con i valori corrispondenti:
PROJECT_ID
: l'ID del progetto.ZONE
: il nome della zona.INSTANT_SNAPSHOT_NAME
: il nome dello snapshot istantaneo.
Elimina uno snapshot istantaneo di un disco regionale:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instantSnapshots/INSTANT_SNAPSHOT_NAME
Sostituisci quanto segue con i valori corrispondenti:
PROJECT_ID
: l'ID del progetto.REGION
: il nome della regione.INSTANT_SNAPSHOT_NAME
: il nome dello snapshot istantaneo.
Modifica la località di archiviazione di uno snapshot istantaneo
Uno snapshot istantaneo viene sempre archiviato nella stessa posizione del disco di origine. Non puoi rendere accessibile uno snapshot istantaneo da una zona o una regione diversa. Puoi invece creare uno snapshot standard dallo snapshot istantaneo e utilizzare lo snapshot standard.
Scopri come crea uno snapshot standard da uno snapshot istantaneo.
Risoluzione dei problemi
Consulta Risoluzione dei problemi relativi agli snapshot istantanei per risolvere i problemi riscontrati nell'uso degli snapshot istantanei.