Questo documento descrive come gestire i gruppi di coerenza. I gruppi di coerenza sono policy di risorse che allineano la replica su più dischi nella stessa regione o zona.
Per saperne di più sui gruppi di coerenza, consulta Informazioni sulla replica asincrona.
Limitazioni
- I gruppi di coerenza non sono supportati per i dischi nei nodi single-tenant.
- I gruppi di coerenza possono avere un massimo di 128 dischi.
- Tutti i dischi di un gruppo di coerenza devono trovarsi nello stesso progetto della policy delle risorse del gruppo di coerenza.
- Tutti i dischi di un gruppo di coerenza devono trovarsi nella stessa zona, per i dischi a livello di zona, o nella stessa coppia di zone, per i dischi a livello di regione.
- Un gruppo di coerenza può contenere dischi primari o secondari, ma non entrambi.
- Non puoi aggiungere un disco primario a un gruppo di coerenza o rimuoverlo durante la replica del disco. Se vuoi aggiungere un disco primario a un gruppo di coerenza o rimuoverlo, innanzitutto devi interrompere la replica. Puoi aggiungere o rimuovere dischi secondari dai gruppi di coerenza in qualsiasi momento.
- Puoi collegare a una VM un massimo di 16 dischi che appartengono a gruppi di coerenza diversi o che non fanno parte di un gruppo di coerenza. I dischi nello stesso gruppo di coerenza vengono conteggiati come un solo disco rispetto al limite di 16 dischi.
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 a servizi e API di 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
-
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.
- Set a default region and zone.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
Nella console Google Cloud , vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Fai clic su Crea gruppo di coerenza.
Nel campo Nome, inserisci un nome per il gruppo di coerenza.
Nel campo Regione, seleziona la regione in cui si trovano i dischi. Se vuoi aggiungere dischi primari al gruppo di coerenza, seleziona la regione principale. Se vuoi aggiungere dischi secondari al gruppo di coerenza, seleziona la regione secondaria.
Fai clic su Crea.
CONSISTENCY_GROUP_NAME
: il nome del gruppo di coerenza.REGION
: la regione per il gruppo di coerenza. Se vuoi aggiungere dischi primari al gruppo di coerenza, usa la regione principale. Se vuoi aggiungere dischi secondari al gruppo di coerenza, usa la regione secondaria.PROJECT
: il progetto che contiene il gruppo di coerenza.REGION
: la regione per il gruppo di coerenza. Se vuoi aggiungere dischi primari al gruppo di coerenza, utilizza la stessa regione dei dischi primari. Se vuoi aggiungere dischi secondari al gruppo di coerenza, utilizza la stessa regione dei dischi secondari.CONSISTENCY_GROUP_NAME
: il nome del gruppo di coerenza.Nella console Google Cloud , vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Fai clic sul nome del gruppo di coerenza per cui vuoi visualizzare i dischi. Viene visualizzata la pagina Gestisci gruppo di coerenza.
Consulta la sezione Membri del gruppo di coerenza per vedere tutti i dischi inclusi nel gruppo di coerenza.
LOCATION_FLAG
: il flag di posizione per i dischi nel gruppo di coerenza. Se i dischi nel gruppo di coerenza sono a livello di regione, utilizza--region
. Se i dischi nel gruppo di coerenza sono a livello di zona, utilizza--zone
.LOCATION
: la regione o la zona dei dischi nel gruppo di coerenza. Per i dischi a livello di regione, utilizza la regione. Per i dischi a livello di zona, utilizza la zona.CONSISTENCY_GROUP_NAME
: il nome del gruppo di coerenza.Visualizza i dischi a livello di zona in un gruppo di coerenza utilizzando il metodo
disks.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME
Visualizza i dischi a livello di regione in un gruppo di coerenza utilizzando il metodo
regionDisks.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME
PROJECT
: il progetto che contiene il gruppo di coerenzaZONE
: la zona dei dischi nel gruppo di coerenzaREGION
: la regione dei dischi nel gruppo di coerenzaCONSISTENCY_GROUP_NAME
: il nome del gruppo di coerenzaNella console Google Cloud , vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere i dischi. Viene visualizzata la pagina Gestisci gruppo di coerenza.
Fai clic su Assegna dischi. Viene visualizzata la pagina Assegna dischi.
Seleziona i dischi che desideri aggiungere al gruppo di coerenza.
Fai clic su Assegna dischi. Quando richiesto, fai clic su Aggiungi.
DISK_NAME
: il nome del disco da aggiungere al gruppo di coerenza.LOCATION_FLAG
: il flag di posizione del disco. Per un disco a livello di regione, utilizza--region
. Per un disco a livello di zona, utilizza--zone
.LOCATION
: la regione o la zona del disco. Per i dischi a livello di regione, utilizza la regione. Per i dischi a livello di zona, utilizza la zona.CONSISTENCY_GROUP
: l'URL del gruppo di coerenza. Ad esempio,projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
.Aggiungi i dischi a livello di zona a un gruppo di coerenza utilizzando il metodo
disks.addResourcePolicies
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/addResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP" }
Aggiungi dischi a livello di regione a un gruppo di coerenza utilizzando il metodo
regionDisks.addResourcePolicies
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/addResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP" }
PROJECT
: il progetto che contiene il disco.LOCATION
: la zona o la regione del disco. Per i dischi a livello di zona, utilizza la zona. Per i dischi a livello di regione, utilizza la regione.DISK_NAME
: il nome del disco da aggiungere al gruppo di coerenza.CONSISTENCY_GROUP
: l'URL del gruppo di coerenza. Ad esempio,projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
.In caso di disco a livello di regione, specifica la regione al posto della zona.
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Nella console Google Cloud , vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere i dischi. Viene visualizzata la pagina Gestisci gruppo di coerenza.
Seleziona i dischi che vuoi rimuovere dal gruppo di coerenza.
Fai clic su Rimuovi dischi. Quando richiesto, fai clic su Rimuovi.
DISK_NAME
: il nome del disco da rimuovere dal gruppo di coerenza.LOCATION_FLAG
: il flag di posizione del disco. Per un disco a livello di regione, utilizza--region
. Per un disco a livello di zona, utilizza--zone
.LOCATION
: la regione o la zona del disco. Per i dischi a livello di regione, utilizza la regione. Per i dischi a livello di zona, utilizza la zona.CONSISTENCY_GROUP
: l'URL del gruppo di coerenza. Ad esempio,projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
.Rimuovi un disco a livello di zona da un gruppo di coerenza:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/removeResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP" }
Rimuovi un disco a livello di regione da un gruppo di coerenza
POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/removeResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP" }
PROJECT
: il progetto che contiene il disco.LOCATION
: la zona o la regione del disco. Per i dischi a livello di zona, utilizza la zona. Per i dischi a livello di regione, utilizza la regione.DISK_NAME
: il nome del disco da rimuovere dal gruppo di coerenza.CONSISTENCY_GROUP
: l'URL del gruppo di coerenza. Ad esempio,projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
.Nella console Google Cloud , vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Seleziona il gruppo di coerenza che vuoi eliminare.
Fai clic su Elimina. Si apre la finestra Elimina gruppo di coerenza.
Fai clic su Elimina.
CONSISTENCY_GROUP
: il nome del gruppo di coerenzaREGION
: la regione del gruppo di coerenzaPROJECT
: il progetto che contiene il gruppo di coerenzaREGION
: la regione del gruppo di coerenzaCONSISTENCY_GROUP
: il nome del gruppo di coerenza- Scopri come gestire i dischi che utilizzano la replica asincrona.
- Scopri come eseguire il failover e il failback.
- Scopri come monitorare il rendimento della replica asincrona.
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 con le tue credenziali utente.
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, 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 .
Crea un gruppo di coerenza
Se devi allineare la replica su più dischi, crea un gruppo di coerenza nella stessa regione dei dischi primari. Se devi allineare i cloni dei dischi, crea un gruppo di coerenza nella stessa regione dei dischi secondari.
Crea un gruppo di coerenza utilizzando la console Google Cloud , Google Cloud CLI, REST o Terraform.
Console
Crea un gruppo di coerenza seguendo questi passaggi:
gcloud
Crea un gruppo di coerenza utilizzando il comando
gcloud compute resource-policies create disk-consistency-group
:gcloud compute resource-policies create disk-consistency-group CONSISTENCY_GROUP_NAME \ --region=REGION
Sostituisci quanto segue:
Vai
Java
Node.js
Python
REST
Crea un gruppo di coerenza utilizzando il metodo
resourcePolicies.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies { "name": "CONSISTENCY_GROUP_NAME", "diskConsistencyGroupPolicy": { } }
Sostituisci quanto segue:
Terraform
Per creare un gruppo di coerenza, utilizza la risorsa
compute_resource_policy
.Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Visualizza i dischi in un gruppo di coerenza
Visualizza i dischi in un gruppo di coerenza utilizzando la console Google Cloud , Google Cloud CLI o REST.
Console
Visualizza i dischi inclusi in un gruppo di coerenza seguendo questi passaggi:
gcloud
Visualizza i dischi inclusi in un gruppo di coerenza utilizzando il comando
gcloud compute disks list
:gcloud compute disks list \ --LOCATION_FLAG=LOCATION \ --filter=resourcePolicies=CONSISTENCY_GROUP_NAME
Sostituisci quanto segue:
Vai
Java
Elenca i dischi a livello di zona in un gruppo di coerenza
Elenca i dischi a livello di regione in un gruppo di coerenza
Node.js
Python
REST
Visualizza i dischi in un gruppo di coerenza utilizzando un filtro di query con uno dei seguenti metodi:
Sostituisci quanto segue:
Aggiungi un disco a un gruppo di coerenza
Se vuoi aggiungere dischi primari a un gruppo di coerenza, devi aggiungerli prima di avviare la replica. Puoi aggiungere dischi secondari a un gruppo di coerenza in qualsiasi momento. Tutti i dischi di un gruppo di coerenza devono trovarsi nella stessa zona, per i dischi a livello di zona, o nella stessa coppia di zone, per i dischi a livello di regione.
Aggiungi un disco a un gruppo di coerenza utilizzando la console Google Cloud , Google Cloud CLI, REST o Terraform.
Console
Aggiungi i dischi a un gruppo di coerenza nel seguente modo:
gcloud
Aggiungi un disco a un gruppo di coerenza utilizzando il comando
gcloud compute disks add-resource-policies
:gcloud compute disks add-resource-policies DISK_NAME \ --LOCATION_FLAG=LOCATION \ --resource-policies=CONSISTENCY_GROUP
Sostituisci quanto segue:
Vai
Java
Node.js
Python
REST
Aggiungi dischi a un gruppo di coerenza utilizzando uno dei seguenti metodi:
Sostituisci quanto segue:
Terraform
Per aggiungere il disco al gruppo di coerenza, utilizza la risorsa
compute_disk_resource_policy_attachment
.Rimuovi un disco da un gruppo di coerenza
Prima di poter rimuovere un disco da un gruppo di coerenza, devi interrompere la replica per il disco.
Rimuovi un disco da un gruppo di coerenza utilizzando la console Google Cloud , Google Cloud CLI o REST.
Console
Rimuovi i dischi primari da un gruppo di coerenza nel seguente modo:
gcloud
Rimuovi un disco da un gruppo di coerenza utilizzando il comando
gcloud compute disks remove-resource-policies
:gcloud compute disks remove-resource-policies DISK_NAME \ --LOCATION_FLAG=LOCATION \ --resource-policies=CONSISTENCY_GROUP
Sostituisci quanto segue:
Vai
Java
Node.js
Python
REST
Rimuovi un disco da un gruppo di coerenza utilizzando il metodo
disks.removeResourcePolicies
per i dischi a livello di zona o il metodoregionDisks.removeResourcePolicies
per i dischi a livello di regione.Sostituisci quanto segue:
Elimina un gruppo di coerenza
Elimina un gruppo di coerenza utilizzando la console Google Cloud , Google Cloud CLI o REST.
Console
Per eliminare una coerenza:
gcloud
Elimina la policy delle risorse utilizzando il comando
gcloud compute resource-policies delete
:gcloud compute resource-policies delete CONSISTENCY_GROUP \ --region=REGION
Sostituisci quanto segue:
Vai
Java
Node.js
Python
REST
Elimina una coerenza utilizzando il metodo
resourcePolicies.delete
:DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
Sostituisci quanto segue:
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 2025-07-15 UTC.
-