Crea snapshot standard per eseguire periodicamente il backup dei dati dai volumi Persistent Disk e Google Cloud Hyperdisk a livello di zona e di regione.
Puoi creare snapshot dai dischi anche quando sono collegati a istanze in esecuzione. Per impostazione predefinita, gli snapshot sono risorse globali, quindi puoi utilizzarli per ripristinare i dati su un nuovo disco o una nuova VM all'interno dello stesso progetto. Per una maggiore protezione dei dati e gestione dei costi, puoi stabilire dove utilizzare gli snapshot per creare nuovi dischi. Per limitare le regioni in cui gli snapshot possono recuperare i dati, puoi creare uno snapshot con ambito a livello di regione e impostare le posizioni di accesso consentite (anteprima). Puoi anche condividere gli snapshot tra i progetti.
Prima di iniziare
- (Anteprima) Per creare snapshot con ambito a livello di regione, imposta le posizioni predefinite per la creazione e il ripristino degli snapshot prima di completare i passaggi in questa pagina.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione verifica la tua identità per l'accesso 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
-
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 a gcloud CLI con la tua identità federata.
- Set a default region and zone.
Terraform
Per utilizzare gli esempi di Terraform in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le credenziali predefinite dell'applicazione e con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
Vai
Per utilizzare gli esempi di Go questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
Java
Per utilizzare gli esempi di Java questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
Node.js
Per utilizzare gli esempi di Node.js questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
Python
Per utilizzare gli esempi di Python questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a 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 .
Ruoli e autorizzazioni richiesti
Per ottenere le autorizzazioni necessarie per creare uno snapshot standard, chiedi all'amministratore di concederti i seguenti ruoli IAM per il 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 ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare uno snapshot standard. Per visualizzare le autorizzazioni obbligatorie corrette, espandi la relativa sezione:
Autorizzazioni obbligatorie
Per creare uno snapshot standard sono necessarie queste autorizzazioni:
-
Per creare uno snapshot di un disco a livello di zona:
-
compute.snapshots.create
-
compute.disks.createSnapshot
-
-
Per creare uno snapshot di un disco a livello di regione utilizzando i dati presenti sul disco:
-
compute.snapshots.create
-
compute.instances.useReadOnly
-
compute.disks.createSnapshot
-
-
Per creare uno snapshot di un disco a livello di regione da un checkpoint di recupero delle repliche:
-
compute.snapshots.create
-
compute.disks.createSnapshot
-
- Per creare uno snapshot con ambito regionale (//cloud.google.com/products/#product-launch-stages">Preview)
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Preparati per la creazione degli snapshot
Per prepararti a creare snapshot dei volumi Persistent Disk o Hyperdisk, segui questi passaggi:
Consulta le best practice per gli snapshot dei dischi Compute Engine per preparare il disco per la procedura di creazione.
Se vuoi personalizzare la località di archiviazione predefinita per tutti i nuovi snapshot con ambito globale, aggiorna le impostazioni degli snapshot per il progetto. Per la località di archiviazioneGoogle Cloud mantiene un valore predefinito finché non aggiorni le impostazioni degli snapshot per la prima volta. La località predefinita è la località multiregionale più vicina al disco di origine.
Per scoprire come creare una pianificazione di snapshot e come collegarla ai dischi, leggi l'articolo Creare pianificazioni per gli snapshot dei dischi. Eseguire regolarmente il backup dei dischi con snapshot pianificati può ridurre il rischio di perdite impreviste dei dati.
Crea uno snapshot del volume Persistent Disk o Hyperdisk
I passaggi per creare uno snapshot di un disco dipendono dal fatto che tu stia creando uno snapshot di un disco a livello di zona o di un disco a livello di regione.
Crea uno snapshot di un disco a livello di zona
Console
Vai alla pagina Crea uno snapshot nella console Google Cloud .
Vai alla pagina Crea uno snapshot- Inserisci un nome per lo snapshot.
-
Seleziona un tipo di snapshot. Il valore predefinito è uno snapshot
STANDARD
, che è l'opzione migliore per il backup a lungo termine e il disaster recovery.Scegli Snapshot di archiviazione per una conservazione dei dati più economica.
- (Facoltativo) Inserisci una descrizione dello snapshot.
- In Disco di origine, seleziona il disco esistente di cui vuoi creare uno snapshot.
Nella sezione Località, scegli una località per l'archiviazione dello snapshot.
La località predefinita o personalizzata indicata nelle impostazioni degli snapshot viene selezionata automaticamente. Se vuoi, puoi ignorare le impostazioni e archiviare lo snapshot in una località di archiviazione personalizzata nel seguente modo:
Scegli il tipo di località di archiviazione che preferisci per lo snapshot.
- Scegli Più regioni per una maggiore affidabilità a un costo superiore.
- Scegli gli snapshot a livello regionale per un maggiore controllo sulla posizione fisica dei dati a un costo inferiore.
- Nel campo Seleziona località, seleziona la regione o la multi-regione specifica che vuoi utilizzare. Per utilizzare la regione o la multi-regione più vicina al tuo disco di origine, seleziona Basata sulla posizione del disco.
- Fai clic su Crea per creare lo snapshot.
gcloud
Puoi creare lo snapshot nella policy della località di archiviazione definita dalle tue impostazioni degli snapshot o utilizzando una località di archiviazione alternativa di tua scelta. Per saperne di più, consulta la sezione sulla scelta della località di archiviazione degli snapshot.
Per creare uno snapshot nella località predefinita o personalizzata configurata nelle impostazioni degli snapshot, utilizza il comando
gcloud compute snapshots create
.gcloud compute snapshots create SNAPSHOT_NAME \ --source-disk-zone=SOURCE_ZONE \ --source-disk=SOURCE_DISK_NAME \ --snapshot-type=SNAPSHOT_TYPE
-
In alternativa, per ignorare le impostazioni degli snapshot e crearne uno in una località di archiviazione personalizzata, includi il flag
--storage-location
per indicare dove archiviare lo snapshot.gcloud compute snapshots create SNAPSHOT_NAME \ --source-disk-zone=SOURCE_ZONE \ --source-disk=SOURCE_DISK_NAME \ --snapshot-type=SNAPSHOT_TYPE \ --storage-location=STORAGE_LOCATION
-
(Anteprima) Per creare uno snapshot con ambito a livello regionale in una regione consentita, includi il flag
--region
per indicare dove creare lo snapshot.gcloud beta compute snapshots create SNAPSHOT_NAME \ --region=SNAPSHOT_SCOPE_REGION --source-disk=SOURCE_DISK_NAME \ --source-disk-zone=SOURCE_ZONE \ --snapshot-type=SNAPSHOT_TYPE
Sostituisci quanto segue:
- SNAPSHOT_NAME: un nome per lo snapshot.
- SOURCE_ZONE: la zona del disco di origine.
- SOURCE_DISK_NAME: il nome del volume del Persistent Disk da cui vuoi creare uno snapshot.
- SNAPSHOT_TYPE: il tipo di snapshot, STANDARD o ARCHIVIO.
Se non viene specificato un tipo di snapshot, viene creato uno snapshot
STANDARD
. -
(Facoltativo) STORAGE_LOCATION: per gli snapshot con ambito globale, indica la multi-regione di Cloud Storage o la regione di Cloud Storage in cui vuoi archiviare lo snapshot. Puoi specificare una sola località di archiviazione.
Utilizza il parametro
--storage-location
solo se vuoi sostituire la località di archiviazione personalizzata o predefinita configurata nelle impostazioni degli snapshot. -
(Facoltativo) SNAPSHOT_SCOPE_REGION: per gli snapshot con ambito a livello regionale, indica la regione che lo snapshot ha come ambito. Se includi questo parametro, non puoi utilizzare il parametro
--storage-location
. STORAGE_LOCATION viene impostato automaticamente su SNAPSHOT_SCOPE_REGION.
Terraform
Per creare uno snapshot del volume del Persistent Disk a livello di zona, utilizza la risorsa
google_compute_snapshot
.Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Go
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Compute Engine per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Compute Engine per Go.
Per effettuare l'autenticazione in Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Compute Engine per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Compute Engine per Java.
Per effettuare l'autenticazione in Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Compute Engine per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Compute Engine per Node.js.
Per effettuare l'autenticazione in Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Compute Engine per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Compute Engine per Python.
Per effettuare l'autenticazione in Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Puoi creare lo snapshot nella policy della località di archiviazione definita dalle tue impostazioni degli snapshot o utilizzando una località di archiviazione alternativa di tua scelta. Per saperne di più, consulta la sezione sulla scelta della località di archiviazione degli snapshot.
-
Per creare uno snapshot nella località predefinita o personalizzata configurata nelle impostazioni degli snapshot, invia una richiesta
POST
al metodosnapshots.insert
:POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots { "name": "SNAPSHOT_NAME", "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/SOURCE_DISK_NAME", "snapshotType": "SNAPSHOT_TYPE" }
-
In alternativa, per ignorare le impostazioni degli snapshot e crearne uno in una località di archiviazione personalizzata, invia una richiesta
POST
al metodosnapshots.insert
e includi la proprietàstorageLocations
nella richiesta:POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots { "name": "SNAPSHOT_NAME", "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/SOURCE_DISK_NAME", "snapshotType": "SNAPSHOT_TYPE", "storageLocations": [ "STORAGE_LOCATION" ], }
-
(Anteprima) Per creare uno snapshot con ambito a livello regionale in una regione consentita, invia una richiesta
POST
al metodosnapshots.insert
e definisci la regione di creazione:POST https://compute.googleapis.com/compute/beta/projects/DESTINATION_PROJECT_ID/regions/SNAPSHOT_SCOPE_REGION/snapshots { "name": "SNAPSHOT_NAME", "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/SOURCE_DISK_NAME", "snapshotType": "SNAPSHOT_TYPE" }
Sostituisci quanto segue:
- DESTINATION_PROJECT_ID: l'ID del progetto in cui vuoi creare lo snapshot.
- SNAPSHOT_NAME: un nome per lo snapshot.
- SOURCE_PROJECT_ID: l'ID del progetto del disco di origine.
- SOURCE_ZONE: la zona del disco di origine.
- SOURCE_DISK_NAME: il nome del volume del Persistent Disk da cui vuoi creare uno snapshot.
- SNAPSHOT_TYPE: il tipo di snapshot, STANDARD o ARCHIVIO.
Se non viene specificato un tipo di snapshot, viene creato uno snapshot
STANDARD
. -
(Facoltativo) STORAGE_LOCATION: per gli snapshot con ambito globale, indica la multi-regione di Cloud Storage o la regione di Cloud Storage in cui vuoi archiviare lo snapshot. Puoi specificare una sola località di archiviazione.
Utilizza il parametro
storageLocations
solo se vuoi sostituire la località di archiviazione personalizzata o predefinita configurata nelle impostazioni degli snapshot. (Facoltativo) SNAPSHOT_SCOPE_REGION: per gli snapshot con ambito a livello regionale, indica la regione che lo snapshot ha come ambito. Se includi questo parametro, non puoi utilizzare il parametro
storageLocations
. STORAGE_LOCATION viene impostato automaticamente su SNAPSHOT_SCOPE_REGION.
Crea uno snapshot di un disco a livello di regione
Puoi creare snapshot del disco regionale in uno dei seguenti modi:
- Utilizzando i dati presenti sul disco di origine. Per utilizzare questo metodo di creazione degli snapshot, devi disporre di una replica a livello di zona sincronizzata.
- Utilizzando il checkpoint di recupero delle repliche di un disco con prestazioni ridotte. Puoi creare snapshot da un checkpoint solo utilizzando Google Cloud CLI o REST.
Dopo aver preparato il disco, puoi creare uno snapshot. Quando crei uno snapshot di un disco a livello di regione, devi indicare la regione in cui si trova il disco di origine.
Console
Vai alla pagina Crea uno snapshot nella console Google Cloud .
Vai alla pagina Crea uno snapshot- Inserisci un nome per lo snapshot.
-
Seleziona un tipo di snapshot. Il valore predefinito è uno snapshot
STANDARD
, che è l'opzione migliore per il backup a lungo termine e il disaster recovery.Scegli Snapshot di archiviazione per una conservazione dei dati più economica.
- (Facoltativo) Inserisci una descrizione dello snapshot.
- In Disco di origine, seleziona il disco esistente di cui vuoi creare uno snapshot.
Nella sezione Località, scegli una località per l'archiviazione dello snapshot.
La località predefinita o personalizzata indicata nelle impostazioni degli snapshot viene selezionata automaticamente. Se vuoi, puoi ignorare le impostazioni e archiviare lo snapshot in una località di archiviazione personalizzata nel seguente modo:
Scegli il tipo di località di archiviazione che preferisci per lo snapshot.
- Scegli Più regioni per una maggiore affidabilità a un costo superiore.
- Scegli gli snapshot a livello regionale per un maggiore controllo sulla posizione fisica dei dati a un costo inferiore.
- Nel campo Seleziona località, seleziona la regione o la multi-regione specifica che vuoi utilizzare. Per utilizzare la regione o la multi-regione più vicina al tuo disco di origine, seleziona Basata sulla posizione del disco.
- Fai clic su Crea per creare lo snapshot.
gcloud
Puoi creare uno snapshot utilizzando i dati del disco di origine o il relativo checkpoint di recupero delle repliche.
Dai dati del disco
Puoi creare uno snapshot dai dati del disco utilizzando la policy della località di archiviazione definita dalle tue impostazioni degli snapshot o utilizzando una località di archiviazione alternativa di tua scelta. Per saperne di più, consulta la sezione sulla scelta della località di archiviazione degli snapshot.
Per creare uno snapshot nella località predefinita o personalizzata configurata nelle impostazioni degli snapshot, utilizza il comando
gcloud compute snapshots create
.gcloud compute snapshots create SNAPSHOT_NAME \ --source-disk-region=SOURCE_REGION \ --source-disk=SOURCE_DISK_NAME \ --snapshot-type=SNAPSHOT_TYPE
-
In alternativa, per ignorare le impostazioni degli snapshot e crearne uno in una località di archiviazione personalizzata, includi il flag
--storage-location
per indicare dove archiviare lo snapshot.gcloud compute snapshots create SNAPSHOT_NAME \ --source-disk-region=SOURCE_REGION \ --source-disk=SOURCE_DISK_NAME \ --snapshot-type=SNAPSHOT_TYPE \ --storage-location=STORAGE_LOCATION
-
(Anteprima) Per creare uno snapshot con ambito a livello regionale in una regione consentita, includi il flag
--region
per indicare dove creare lo snapshot.gcloud beta compute snapshots create SNAPSHOT_NAME \ --region=SNAPSHOT_SCOPE_REGION \ --source-disk=SOURCE_DISK_NAME \ --source-disk-region=SOURCE_REGION \ --snapshot-type=SNAPSHOT_TYPE
Sostituisci quanto segue:
- SNAPSHOT_NAME: un nome per lo snapshot.
- SOURCE_REGION: la regione del disco di origine.
- SOURCE_DISK_NAME: il nome del volume del Persistent Disk regionale o del volume Hyperdisk bilanciato ad alta affidabilità da cui vuoi creare uno snapshot.
- SNAPSHOT_TYPE: il tipo di snapshot, STANDARD o ARCHIVIO.
Se non viene specificato un tipo di snapshot, viene creato uno snapshot
STANDARD
. -
(Facoltativo) STORAGE_LOCATION: per gli snapshot con ambito globale, indica la multi-regione di Cloud Storage o la regione di Cloud Storage in cui vuoi archiviare lo snapshot. Puoi specificare una sola località di archiviazione.
Utilizza il parametro
--storage-location
solo se vuoi sostituire la località di archiviazione personalizzata o predefinita configurata nelle impostazioni degli snapshot. -
(Facoltativo) SNAPSHOT_SCOPE_REGION: per gli snapshot con ambito a livello regionale, indica la regione che lo snapshot ha come ambito. Se includi questo parametro, non puoi utilizzare il parametro
--storage-location
. STORAGE_LOCATION viene impostato automaticamente su SNAPSHOT_SCOPE_REGION.
Dal checkpoint
Puoi creare lo snapshot utilizzando il checkpoint di recupero delle repliche di un disco con prestazioni ridotte. Lo snapshot viene creato purché la replica incompleta sia disponibile.
Per creare uno snapshot utilizzando il checkpoint di recupero delle repliche, utilizza il comando
gcloud compute snapshots create
. Includi il flag--source-disk-for-recovery-checkpoint
per specificare che vuoi creare lo snapshot utilizzando un checkpoint di recupero delle repliche. Escludi i parametri--source-disk
e--source-disk-region
.gcloud compute snapshots create SNAPSHOT_NAME \ --source-disk-for-recovery-checkpoint=SOURCE_DISK \ --source-disk-for-recovery-checkpoint-region=SOURCE_REGION \ --storage-location=STORAGE_LOCATION \ --snapshot-type=SNAPSHOT_TYPE
Sostituisci quanto segue:
DESTINATION_PROJECT_ID
: l'ID del progetto in cui vuoi creare lo snapshot.SNAPSHOT_NAME
: un nome per lo snapshot.SOURCE_PROJECT_ID
: l'ID progetto del disco di origine di cui vuoi utilizzare il checkpoint per creare lo snapshot.SOURCE_REGION
: la regione del disco di origine di cui vuoi utilizzare il checkpoint per creare lo snapshot.SOURCE_DISK_NAME
: il nome del disco di origine di cui vuoi utilizzare il checkpoint per creare lo snapshot.- (Facoltativo)
STORAGE_LOCATION
: la multi-regione di Cloud Storage o la regione di Cloud Storage in cui vuoi archiviare lo snapshot. Puoi specificare una sola località di archiviazione.
Utilizza questa opzione solo se vuoi sostituire la località di archiviazione predefinita o personalizzata configurata nelle impostazioni degli snapshot. SNAPSHOT_TYPE
: il tipo di snapshot, STANDARD o ARCHIVIO. Se non viene specificato un tipo di snapshot, viene creato uno snapshot STANDARD.
Puoi utilizzare il checkpoint di recupero delle repliche per creare uno snapshot solo sui dischi con prestazioni ridotte. Se provi a creare uno snapshot da un checkpoint di recupero delle repliche quando il dispositivo è completamente replicato, viene visualizzato il seguente messaggio di errore:
The device is fully replicated and should not create snapshots out of a recovery checkpoint. Please create regular snapshots instead.
Google Cloud CLI attende che l'operazione restituisca uno stato
READY
oFAILED
o raggiunga il timeout massimo e restituisce gli ultimi dettagli noti dello snapshot.Terraform
Il provider Terraform per Google Cloud non supporta la creazione di uno snapshot di un disco regionale. Per monitorare questa limitazione, vedi le informazioni relative al problema su GitHub.
Vai
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Compute Engine per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Compute Engine per Go.
Per effettuare l'autenticazione in Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Compute Engine per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Compute Engine per Java.
Per effettuare l'autenticazione in Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Compute Engine per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Compute Engine per Node.js.
Per effettuare l'autenticazione in Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Compute Engine per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Compute Engine per Python.
Per effettuare l'autenticazione in Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
REST
Puoi creare uno snapshot utilizzando i dati del disco di origine o il relativo checkpoint di recupero delle repliche.
Dai dati del disco
Puoi creare uno snapshot dai dati del disco utilizzando la policy della località di archiviazione definita dalle tue impostazioni degli snapshot o utilizzando una località di archiviazione alternativa di tua scelta. Per saperne di più, consulta la sezione sulla scelta della località di archiviazione degli snapshot.
-
Per creare uno snapshot nella località predefinita o personalizzata configurata nelle impostazioni degli snapshot, invia una richiesta
POST
al metodosnapshots.insert
:POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots { "name": "SNAPSHOT_NAME", "sourceDisk": "projects/SOURCE_PROJECT_ID/regions/SOURCE_REGION/disks/SOURCE_DISK_NAME", "snapshotType": "SNAPSHOT_TYPE" }
-
In alternativa, per ignorare le impostazioni degli snapshot e crearne uno in una località di archiviazione personalizzata, invia una richiesta
POST
al metodosnapshots.insert
e includi la proprietàstorageLocations
nella richiesta:POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots { "name": "SNAPSHOT_NAME", "sourceDisk": "projects/SOURCE_PROJECT_ID/regions/SOURCE_REGION/disks/SOURCE_DISK_NAME", "snapshotType": "SNAPSHOT_TYPE", "storageLocations": [ "STORAGE_LOCATION" ], }
-
(Anteprima) Per creare uno snapshot con ambito a livello regionale in una regione consentita, invia una richiesta
POST
al metodosnapshots.insert
e definisci la regione di creazione:POST https://compute.googleapis.com/compute/beta/projects/DESTINATION_PROJECT_ID/regions/SNAPSHOT_SCOPE_REGION/snapshots { "name": "SNAPSHOT_NAME", "sourceDisk": "projects/SOURCE_PROJECT_ID/regions/SOURCE_REGION/disks/SOURCE_DISK_NAME", "snapshotType": "SNAPSHOT_TYPE", }
Sostituisci quanto segue:
- DESTINATION_PROJECT_ID: l'ID del progetto in cui vuoi creare lo snapshot.
- SNAPSHOT_NAME: un nome per lo snapshot.
- SOURCE_PROJECT_ID: l'ID del progetto del disco di origine.
- SOURCE_REGION: la regione del disco di origine.
- SOURCE_DISK_NAME: il nome del Persistent Disk regionale o del volume Hyperdisk bilanciato ad alta affidabilità da cui vuoi creare uno snapshot.
- SNAPSHOT_TYPE: il tipo di snapshot, STANDARD o ARCHIVIO.
Se non viene specificato un tipo di snapshot, viene creato uno snapshot
STANDARD
. -
(Facoltativo) STORAGE_LOCATION: per gli snapshot con ambito globale, indica la multi-regione di Cloud Storage o la regione di Cloud Storage in cui vuoi archiviare lo snapshot. Puoi specificare una sola località di archiviazione.
Utilizza il parametro
storageLocations
solo se vuoi sostituire la località di archiviazione personalizzata o predefinita configurata nelle impostazioni degli snapshot. (Facoltativo) SNAPSHOT_SCOPE_REGION: per gli snapshot con ambito a livello regionale, indica la regione che lo snapshot ha come ambito. Se includi questo parametro, non puoi utilizzare il parametro
storageLocations
. STORAGE_LOCATION viene impostato automaticamente su SNAPSHOT_SCOPE_REGION.
Dal checkpoint
In alternativa, puoi creare lo snapshot utilizzando il checkpoint di recupero delle repliche di un disco con prestazioni ridotte. Lo snapshot viene creato purché la replica incompleta sia disponibile.
Per creare uno snapshot utilizzando il checkpoint di recupero delle repliche, invia una richiesta
POST
al metodosnapshots.insert
. Escludi il parametrosourceDisk
e includi il parametrosourceDiskForRecoveryCheckpoint
per specificare che vuoi creare lo snapshot utilizzando il checkpoint.POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots { "name": "SNAPSHOT_NAME", "sourceDiskForRecoveryCheckpoint": "projects/SOURCE_PROJECT_ID/regions/SOURCE_REGION/disks/SOURCE_DISK_NAME", "storageLocations": "STORAGE_LOCATION", "snapshotType": "SNAPSHOT_TYPE" }
Sostituisci quanto segue:
DESTINATION_PROJECT_ID
: l'ID del progetto in cui vuoi creare lo snapshot.SNAPSHOT_NAME
: un nome per lo snapshot.SOURCE_PROJECT_ID
: l'ID progetto del disco di origine di cui vuoi utilizzare il checkpoint per creare lo snapshot.SOURCE_REGION
: la regione del disco di origine di cui vuoi utilizzare il checkpoint per creare lo snapshot.SOURCE_DISK_NAME
: il nome del disco di origine di cui vuoi utilizzare il checkpoint per creare lo snapshot.- (Facoltativo)
STORAGE_LOCATION
: la multi-regione di Cloud Storage o la regione di Cloud Storage in cui vuoi archiviare lo snapshot. Puoi specificare una sola località di archiviazione.
Utilizza il parametrostorageLocations
solo se vuoi sostituire la località di archiviazione predefinita o personalizzata configurata nelle impostazioni degli snapshot. SNAPSHOT_TYPE
: il tipo di snapshot, STANDARD o ARCHIVIO. Se non viene specificato un tipo di snapshot, viene creato uno snapshot STANDARD.
Puoi utilizzare il checkpoint di recupero delle repliche per creare uno snapshot solo sui dischi con prestazioni ridotte. Se provi a creare uno snapshot da un checkpoint di recupero delle repliche quando il dispositivo è completamente replicato, viene visualizzato il seguente messaggio di errore:
The device is fully replicated and should not create snapshots out of a recovery checkpoint. Please create regular snapshots instead.
Passaggi successivi
- Scopri come creare snapshot pianificati per i dischi.
- Scopri come visualizzare, eliminare e condividere gli snapshot dei dischi.
- Scopri come creare un'immagine disco dallo snapshot.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-10-19 UTC.
-