Questo documento descrive come gestire le pianificazioni degli snapshot per i dischi permanenti a livello di zona e di regione e per Hyperdisk di Google Cloud.
Puoi gestire le pianificazioni degli snapshot nel seguente modo:
- Visualizzare le pianificazioni degli snapshot
- Modificare le pianificazioni degli snapshot
- Elimina pianificazioni snapshot
Puoi anche configurare avvisi per gli snapshot pianificati.
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
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 visualizzare le pianificazioni degli snapshot:
compute.resourcePolicies.list
nel progetto o nell'organizzazione -
Per aggiornare una pianificazione di snapshot:
-
compute.resourcePolicies.update
nel criterio delle risorse -
compute.resourcePolicies.get
nel criterio delle risorse
-
-
Per sostituire una pianificazione degli snapshot:
-
compute.resourcePolicies.use
nel criterio delle risorse -
compute.disks.addResourcePolicies
sul disco -
compute.disks.removeResourcePolicies
sul disco
-
-
Per eliminare una pianificazione snapshot:
-
compute.resourcePolicies.delete
nel criterio delle risorse -
compute.disks.removeResourcePolicies
sul disco
-
- Nella console Google Cloud, vai alla pagina Snapshot.
- Seleziona la scheda Pianificazioni degli snapshot.
- Utilizza il campo Filtra per restringere l'elenco delle pianificazioni degli snapshot.
- Fai clic sul nome di una pianificazione degli istantanei per visualizzarne i dettagli.
- Nella console Google Cloud, vai alla pagina Snapshot.
- Seleziona la scheda Pianificazioni degli snapshot.
- Utilizza il campo Filtra per elencare le pianificazioni delle istantanee per una regione specifica.
PROJECT_ID
: il nome del progettoREGION
: la regione, ad esempious-west1
PROJECT_ID
: il nome del progettoREGION
: la regione, ad esempious-west1
- Descrizione
- Pianificazione snapshot
- Etichette applicate agli snapshot generati
- Criterio di eliminazione del disco di origine per la gestione degli snapshot generati automaticamente se il disco di origine viene eliminato
- Criterio di conservazione per definire per quanto tempo conservare gli snapshot generati dalla pianificazione degli snapshot
- Nella console Google Cloud, vai alla pagina Snapshot.
- Seleziona Pianificazioni di snapshot per visualizzare un elenco delle pianificazioni.
- Fai clic sul nome della pianificazione degli snapshot da modificare.
- Nella pagina dei dettagli della pianificazione degli snapshot, fai clic sul pulsante Modifica pianificazione.
- SCHEDULE_NAME: il nome della pianificazione degli snapshot.
- REGION: la regione in cui risiede la programmazione degli snapshot.
- DESCRIPTION: una descrizione della pianificazione degli snapshot. Racchiudi la descrizione tra virgolette.
- KEY e VALUE: una coppia chiave-valore che può essere utilizzata per raggruppare le risorse correlate o associate.
- DAYS: numero massimo di giorni prima che lo snapshot venga eliminato.
- DELETE_OPTION: comportamento di conservazione degli snapshot automatici dopo l'eliminazione del disco originale. Il valore deve essere uno dei seguenti:
apply-retention-policy
: quando il disco di origine viene eliminato, continua ad applicare la finestra di conservazione per tutti gli snapshot creati dalla pianificazione degli snapshot.keep-auto-snapshots
: (valore predefinito) se il disco di origine viene eliminato, mantieni gli snapshot creati dalla pianificazione degli snapshot, indipendentemente dalla finestra di conservazione.
- START_TIME: l'ora di inizio UTC. L'ora deve iniziare sull'ora. Ad esempio:
- Le 14:00 PST corrispondono a
22:00
. - Se imposti un'ora di inizio pari a
22:13
, riceverai un errore.
- Le 14:00 PST corrispondono a
SCHEDULE_FLAG: uno dei seguenti flag:
--hourly-schedule=
HOURLY_INTERVAL
: il numero di ore tra ogni istantanea.HOURLY_INTERVAL
deve essere un numero intero compreso tra1
e23
. Ad esempio, se imposti--hourly-schedule
su 12, lo snapshot viene generato ogni 12 ore.--daily-schedule
: esegue uno snapshot ogni giorno alle oreSTART_TIME
--weekly-schedule=
WEEKLY_INTERVAL
: definisce il giorno in cui vuoi che venga eseguito lo snapshot. Devi scrivere per esteso il giorno della settimana. I valori non sono sensibili alle maiuscole.--weekly-schedule-from-file=
FILE_NAME
: specifica un file contenente la pianificazione degli snapshot settimanali. Puoi specificare pianificazioni settimanali in giorni diversi della settimana e in orari diversi utilizzando un file. Ad esempio, il file potrebbe specificare una pianificazione degli istantanei di lunedì e mercoledì:none [{"day": "MONDAY", "startTime": "04:00"}, {"day": "WEDNESDAY", "startTime": "02:00"}]
Se nel file includi un'ora di inizio, non è necessario impostare il flag--start-time
. La pianificazione utilizza il fuso orario UTC. L'ora di inizio deve essere un'ora piena. Ad esempio:- Le 14:00 PST corrispondono a
22:00
. - Se imposti un'ora di inizio pari a
22:13
, riceverai un errore.
- Le 14:00 PST corrispondono a
Gli indicatori della frequenza degli snapshot
hourly-schedule
,daily-schedule
,weekly-schedule
eweekly-schedule-from-file
sono esclusivi l'uno dell'altro. Puoi utilizzarne solo uno per la pianificazione degli snapshot.Modifica la descrizione e l'etichetta:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "description": "DESCRIPTION", "snapshotProperties": { "labels": {"KEY": "VALUE"} } }
Modifica la pianificazione degli snapshot su ogni ora:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "snapshotSchedulePolicy": { "schedule": { "hourlySchedule": { "hoursInCycle": HOURLY_INTERVAL, "startTime": START_TIME } } } }
Modifica la pianificazione degli snapshot in giornaliera:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "snapshotSchedulePolicy": { "schedule": { "dailySchedule": { "daysInCycle": DAILY_INTERVAL, "startTime": START_TIME } } } }
Modificare la pianificazione degli snapshot in settimanale:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "snapshotSchedulePolicy": { "schedule": { "weeklySchedule": { "dayOfWeeks": [ { "day": WEEKLY_INTERVAL, "startTime": START_TIME } ] } } } }
Modifica il criterio di conservazione degli snapshot:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME { "name": "SCHEDULE_NAME", "snapshotSchedulePolicy": { "retentionPolicy": { "maxRetentionDays": DAYS, "onSourceDiskDelete":"DELETE_OPTION" } } }
- PROJECT_ID: il nome del progetto.
- REGION: la regione in cui si trova la pianificazione degli snapshot.
- SCHEDULE_NAME: il nome della pianificazione degli snapshot.
- DESCRIPTION: una descrizione della pianificazione degli snapshot. Racchiudi la descrizione tra virgolette.
- KEY e VALUE: una coppia chiave- valore che può essere utilizzata per raggruppare risorse correlate o associate.
- HOURLY_INTERVAL: definisce l'intervallo in cui deve avvenire lo snapshot. Imposta la pianificazione oraria utilizzando un numero intero tra
1
e23
. Per creare gli snapshot alla stessa ora ogni giorno, scegli un numero che si divida esattamente per 24 (1, 2, 3, 4, 6, 8 o 12). Ad esempio, se imposti--hourly-schedule
su 12, lo snapshot viene generato ogni 12 ore. - DAILY_INTERVAL: definisce il numero di giorni tra ogni snapshot. Per creare uno snapshot ogni giorno, utilizza il valore
1
. - WEEKLY_INTERVAL: consente di definire una pianificazione da eseguire in giorni specifici della settimana. Specifica uno o più giorni. Sono disponibili le seguenti opzioni:
MONDAY
,TUESDAY
,WEDNESDAY
,THURSDAY
,FRIDAY
,SATURDAY
eSUNDAY
. Devi scrivere per esteso i giorni della settimana. Non viene fatta distinzione tra maiuscole e minuscole. Puoi definire fino a 7 intervalli perdayOfWeeks
, uno per ogni giorno della settimana. - START_TIME: l'ora di inizio UTC. L'ora deve essere obbligatoriamente un'ora piena. Ad esempio:
- Le 14:00 PST corrispondono a
22:00
UTC. - Se imposti un'ora di inizio pari a
22:13
, riceverai un errore.
- Le 14:00 PST corrispondono a
- DAYS: numero massimo di giorni prima che lo snapshot venga eliminato.
- DELETE_OPTION: comportamento di conservazione degli snapshot automatici dopo l'eliminazione del disco originale. Il valore deve essere uno dei seguenti:
APPLY_RETENTION_POLICY
: quando il disco di origine viene eliminato, continua ad applicare la finestra di conservazione per tutti gli snapshot creati dalla pianificazione degli snapshot.KEEP_AUTO_SNAPSHOTS
: (valore predefinito) se il disco di origine viene eliminato, mantieni gli snapshot creati dalla pianificazione degli snapshot, indipendentemente dalla finestra di conservazione.
- Nella console Google Cloud, vai alla pagina Dischi.
- Seleziona il disco contenente la pianificazione che vuoi scollegare.
- Nella pagina Gestisci disco, fai clic su Modifica. Potrebbe essere necessario fare prima clic sul menu Altre azioni.
- Apri il menu a discesa Pianificazione istantanee.
- Fai clic su Nessuna pianificazione per scollegare la pianificazione dal disco.
- Puoi creare una nuova pianificazione o scambiarla mentre modifichi le opzioni del disco.
- Fai clic su Salva per completare l'attività.
Utilizza il comando
gcloud disks remove-resource-policies
per scollegare la pianificazione degli snapshot dal disco con la programmazione che vuoi modificare.gcloud compute disks remove-resource-policies DISK_NAME \ --resource-policies SCHEDULE_NAME \ --region REGION \ --zone ZONE
Sostituisci quanto segue:
DISK_NAME
: il nome del disco a cui è associata la programmazione degli snapshotSCHEDULE_NAME
: il nome della pianificazione di snapshot che vuoi scollegare da questo discoREGION
: la regione in cui risiede la pianificazione delle istantaneeZONE
: la zona in cui si trova il disco zonale
Utilizza il comando
gcloud disks add-resource-policies
per aggiungere la nuova pianificazione degli snapshot al disco.gcloud compute disks add-resource-policies DISK_NAME \ --resource-policies SCHEDULE_NAME \ --zone ZONE
Sostituisci quanto segue:
DISK_NAME
: il nome del disco con la policy della risorsa di pianificazione degli snapshotSCHEDULE_NAME
: il nome della programmazione degli snapshot che vuoi aggiungere a questo discoZONE
: la zona in cui si trova il disco
Scollega la pianificazione degli snapshot corrente da un disco creando una richiesta
POST
adisks.removeResourcePolicies
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/removeResourcePolicies { "resourcePolicies": [ "regions/REGION/resourcePolicies/SCHEDULE_NAME" ] }
Sostituisci quanto segue:
PROJECT_ID
: il nome del progettoZONE
: la zona in cui si trova il discoDISK_NAME
: il nome del disco con la pianificazione degli snapshot associataREGION
: la posizione della pianificazione degli snapshotSCHEDULE_NAME
: il nome della pianificazione di snapshot che stai rimuovendo da questo disco
Collega la nuova pianificazione degli snapshot al disco creando una richiesta
POST
al metododisks.addResourcePolicies
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/addResourcePolicies { "resourcePolicies": [ "regions/REGION/resourcePolicies/SCHEDULE_NAME" ] }
Sostituisci quanto segue:
PROJECT_ID
: il nome del progettoZONE
: la posizione del discoDISK_NAME
: il nome del discoREGION
: la posizione della pianificazione degli snapshotSCHEDULE_NAME
: il nome della pianificazione di snapshot che stai applicando a questo disco
- Nella console Google Cloud, vai alla pagina Snapshot.
- Seleziona Pianificazioni di snapshot per visualizzare un elenco delle pianificazioni.
- Seleziona una pianificazione non associata a un disco.
Fai clic su
Elimina.SCHEDULE_NAME
: il nome della pianificazione degli snapshotREGION
: la posizione della pianificazione degli snapshotPROJECT_ID
: il nome del progettoREGION
: la posizione della pianificazione degli snapshotSCHEDULE_NAME
: il nome della pianificazione degli snapshotNella console Google Cloud, vai alla pagina Esplora log.
Nell'elenco a discesa Risorsa sottoposta a controllo, posiziona il puntatore del mouse su Disco e seleziona Tutti i disk_id.
Nell'elenco a discesa Tutti i log, seleziona cloudaudit.googleapis.com/system_event e fai clic su OK.
Nell'elenco a discesa Qualsiasi livello di log, seleziona il tipo di log.
- Scopri di più sulle frequenze di pianificazione degli snapshot, sui criteri di conservazione e sulle regole di denominazione in Informazioni sulle pianificazioni degli snapshot per i dischi.
- Visualizza ed elimina gli snapshot generati, come descritto in Gestire gli snapshot dei dischi.
- Scopri come visualizzare i log.
REST
Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Per ulteriori informazioni, consulta Eseguire 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 una pianificazione degli snapshot, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:
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 una pianificazione snapshot. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per creare una pianificazione snapshot sono necessarie le seguenti autorizzazioni:
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Visualizzare le pianificazioni degli snapshot
Per ottenere un elenco delle pianificazioni degli snapshot, utilizza la console, il comando
gcloud
o il metodo dell'API Compute Engine. Questa richiesta mostra il nome, la descrizione e la regione di tutte le pianificazioni degli snapshot all'interno di un progetto.Console
gcloud
Per visualizzare un elenco delle pianificazioni degli snapshot, utilizza il comando
resource-policies list
.gcloud compute resource-policies list
Per visualizzare la descrizione di una pianificazione degli snapshot specifica, utilizza il comando
resource-policies describe
.gcloud compute resource-policies describe SCHEDULE_NAME
Sostituisci
SCHEDULE_NAME
con il nome della pianificazione degli snapshot.REST
Invia una richiesta
GET
aresourcePolicies.aggregatedList
per restituire un elenco delle pianificazioni degli snapshot per un progetto.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/resourcePolicies
Sostituisci
PROJECT_ID
con il nome del progetto.Visualizzare le pianificazioni degli snapshot per regione
Per visualizzare le pianificazioni degli snapshot per un progetto all'interno di una determinata regione, utilizza la console Google Cloud, gcloud CLI o REST.
Console
gcloud
Per visualizzare le pianificazioni degli snapshot per un progetto all'interno di una regione specifica, utilizza il comando
resource-policies list
.gcloud compute resource-policies list PROJECT_ID --filter REGION
Sostituisci quanto segue:
REST
Invia una richiesta
GET
al metodoresourcePolicies.list
per recuperare le pianificazioni di snapshot create in una regione.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies
Sostituisci quanto segue:
Modificare una pianificazione degli snapshot
Dopo aver creato una pianificazione degli snapshot, puoi modificare i seguenti campi dinamicamente utilizzando la procedura Aggiornare una pianificazione degli snapshot:
Per aggiornare altri valori per una pianificazione di snapshot, devi eliminare la pianificazione e crearne una nuova, come descritto in Sostituisci una pianificazione di snapshot.
Gli aggiornamenti della pianificazione degli snapshot vengono applicati nel primo snapshot dopo gli aggiornamenti. Se è in corso uno snapshot mentre aggiorni la relativa pianificazione, le modifiche verranno applicate nello snapshot successivo.
Aggiorna una pianificazione snapshot
Puoi utilizzare Google Cloud CLI o l'API Compute Engine per modificare alcune delle proprietà della pianificazione degli snapshot, come descritto in Modificare una pianificazione degli snapshot.
Per modificare altre proprietà della pianificazione degli snapshot, utilizza il metodo descritto in Sostituire una pianificazione degli snapshot.
Console
gcloud
Utilizza il comando
compute resource-policies update
per aggiornare la descrizione, la pianificazione, il criterio di conservazione o le etichette di una pianificazione degli snapshot.gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \ --region=REGION \ --description="DESCRIPTION" \ --snapshot-labels="KEY=VALUE" \ --max-retention-days=DAYS \ --on-source-disk-delete=DELETE_OPTION \ --start-time=START_TIME \ SCHEDULE_FLAG
Sostituisci quanto segue:
Esempi:
Per modificare la pianificazione degli snapshot in una pianificazione giornaliera:
gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \ --region=REGION --daily-schedule --start-time=START_TIME
Per modificare uno snapshot in una pianificazione ogni ora e aggiornare anche la descrizione e l'etichetta dello snapshot:
gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \ --region=REGION --description="DESCRIPTION" \ --hourly-schedule=HOURLY_INTERVAL --start-time=START_TIME \ --snapshot-labels="KEY=VALUE"
Per modificare i criteri di conservazione degli snapshot e di eliminazione dei dischi di origine per una programmazione degli snapshot:
gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \ --region=REGION --max-retention-days=DAYS \ --on-source-disk-delete=DELETE_OPTION
REST
Crea una richiesta
PATCH
al metodoresourcePolicies
per aggiornare la descrizione, la pianificazione, il criterio di conservazione, il criterio di eliminazione del disco di origine o le etichette di una pianificazione di snapshot. Nel corpo della richiesta, devi solo specificarename
e i campi che vuoi aggiornare.Sostituisci quanto segue:
Sostituire una pianificazione snapshot
Per eliminare la pianificazione degli snapshot e crearne una nuova: Utilizza questo metodo per modificare le proprietà della pianificazione snapshot che non possono essere modificate utilizzando la procedura di aggiornamento di una pianificazione snapshot.
Se stai sostituendo una pianificazione di snapshot già collegata a un disco, devi prima scollegare la pianificazione dal disco ed eliminarla. Poi puoi creare un nuovo programma e collegarlo al disco.
Gli snapshot generati dalla pianificazione degli snapshot scollegata non verranno gestiti dal nuovo criterio. Questi snapshot verranno conservati a tempo indeterminato fino a quando non li elimini.
Utilizza la console Google Cloud, l'gcloud CLI o REST per rimuovere e sostituire la pianificazione degli snapshot.
Console
gcloud
REST
Elimina una pianificazione snapshot
Se elimini una pianificazione snapshot, tutti gli snapshot generati automaticamente associati alla pianificazione vengono conservati definitivamente. Tuttavia, dopo l'eliminazione della pianificazione, non è più possibile generare istantanee.
Le norme di conservazione fanno parte della pianificazione degli snapshot. Una volta eliminata la pianificazione, il criterio di conservazione non viene più applicato. Gli istantanei già generati vengono conservati definitivamente finché non li elimini manualmente.
Per eliminare una pianificazione degli snapshot esistente, utilizza la console Google Cloud, Google Cloud CLI o il metodo dell'API Compute Engine. Se la pianificazione è già collegata a un disco, scollegala dal disco e poi eliminala. Non puoi eliminare una pianificazione degli snapshot collegata a un disco.
Console
gcloud
Per eliminare una pianificazione degli snapshot, utilizza il comando
resource-policies delete
.gcloud compute resource-policies delete SCHEDULE_NAME \ --region REGION
Sostituisci quanto segue:
REST
Per eliminare una pianificazione degli snapshot, invia una richiesta
DELETE
al metodoresourcePolicies.delete
. Se la pianificazione degli snapshot è già collegata a un disco, riceverai un messaggio di errore.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
Sostituisci quanto segue:
Logging e monitoraggio
Ogni snapshot pianificato associato a un disco crea continuamente un evento di sistema, che viene monitorato e registrato in ogni momento. Gli audit log degli eventi di sistema sono sempre abilitati.
Questi log forniscono informazioni sul comportamento degli snapshot pianificati per ogni disco associato. Puoi visualizzare i log dal menu Logging nella console Google Cloud.
Per ulteriori informazioni sull'utilizzo di Esplora log, consulta Visualizza i log utilizzando Esplora log.
Console
Passaggi successivi
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 2024-12-22 UTC.
-