Este documento descreve como gerenciar grupos de consistências. Grupos de consistência são políticas de recursos que alinham a replicação em vários discos na mesma região ou zona.
Para saber mais sobre grupos de consistências, consulte Sobre replicação assíncrona .
Limitações
- Os grupos de consistências não são suportados para discos em nós de locatário individual.
- Os grupos de consistências podem ter no máximo 128 discos.
- Todos os discos em um grupo de consistências devem estar no mesmo projeto que a política de recursos do grupo de consistências.
- Todos os discos em um grupo de consistências devem estar na mesma zona, para discos zonais, ou no mesmo par de zonas, para discos regionais.
- Um grupo de consistências pode conter discos primários ou discos secundários, mas não ambos.
- Não é possível incluir ou remover um disco primário em ou de um grupo de consistências enquanto o disco estiver replicando. Se desejar incluir ou remover um disco primário em ou de um grupo de consistências, você deverá primeiro parar a replicação . É possível incluir ou remover discos secundários em ou de grupos de consistências a qualquer momento.
- É possível anexar no máximo 16 discos que estão em grupos de consistências diferentes ou discos que não estão em um grupo de consistências a uma VM. Os discos que estão no mesmo grupo de consistências contam como um disco no limite de 16 discos.
Antes de começar
- Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
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, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
No console do Google Cloud, acesse a página Replicação assíncrona .
Clique na guia Grupos de consistências .
Clique em Criar grupo de consistências .
No campo Nome , insira um nome para o grupo de consistências.
No campo Região , selecione a região onde seus discos estão localizados. Se desejar incluir discos primários no grupo de consistências, selecione a região primária. Se desejar incluir discos secundários no grupo de consistências, selecione a região secundária.
Clique em Criar .
-
CONSISTENCY_GROUP_NAME
: o nome do grupo de consistências. -
REGION
: a região do grupo de consistências. Se desejar incluir discos primários no grupo de consistências, use a região primária. Se desejar incluir discos secundários no grupo de consistências, use a região secundária. -
PROJECT
: o projeto que contém o grupo de consistências. -
REGION
: a região do grupo de consistências. Se desejar incluir discos primários no grupo de consistências, use a mesma região dos discos primários. Se desejar incluir discos secundários no grupo de consistências, use a mesma região dos discos secundários. -
CONSISTENCY_GROUP_NAME
: o nome do grupo de consistências. No console do Google Cloud, acesse a página Replicação assíncrona .
Clique na guia Grupos de consistências .
Clique no nome do grupo de consistências cujos discos você deseja visualizar. A página Gerenciar grupo de consistências é aberta.
Visualize a seção Membros do grupo de consistências para ver todos os discos incluídos no grupo de consistências.
-
LOCATION_FLAG
: o sinalizador de localização para os discos no grupo de consistências. Se os discos no grupo de consistências forem regionais, use--region
. Se os discos no grupo de consistências forem zonais, use--zone
. -
LOCATION
: a região ou zona dos discos no grupo de consistências. Para discos regionais, use a região. Para discos zonais, use o arquivo zone. -
CONSISTENCY_GROUP_NAME
: o nome do grupo de consistências. Visualize discos zonais em um grupo de consistências usando o método
disks.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME
Visualize discos regionais em um grupo de consistências usando o método
regionDisks.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME
-
PROJECT
: o projeto que contém o grupo de consistências -
ZONE
: a zona dos discos no grupo de consistências -
REGION
: a região dos discos no grupo de consistências -
CONSISTENCY_GROUP_NAME
: o nome do grupo de consistências No console do Google Cloud, acesse a página Replicação assíncrona .
Clique na guia Grupos de consistências .
Clique no nome do grupo de consistências no qual deseja incluir discos. A página Gerenciar grupo de consistências é aberta.
Clique em Atribuir discos . A página Atribuir discos é aberta.
Selecione os discos que deseja incluir no grupo de consistências.
Clique em Atribuir discos . Quando solicitado, clique em Adicionar .
-
DISK_NAME
: o nome do disco a ser incluído no grupo de consistências. -
LOCATION_FLAG
: o sinalizador de localização do disco. Para um disco regional, use--region
. Para um disco zonal, use--zone
. -
LOCATION
: a região ou zona do disco. Para discos regionais, use a região. Para discos zonais, use o arquivo zone. -
CONSISTENCY_GROUP
: a URL do grupo de consistências. Por exemplo,projects/ PROJECT /regions/ REGION /resourcePolicies/ CONSISTENCY_GROUP_NAME
. Adicione discos zonais a um grupo de consistências usando o método
disks.addResourcePolicies
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/addResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP" }
Adicione discos regionais a um grupo de consistências usando o método
regionDisks.addResourcePolicies
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/addResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP" }
-
PROJECT
: o projeto que contém o disco. -
LOCATION
: a zona ou região do disco. Para discos zonais, use o arquivo zone. Para discos regionais, use a região. -
DISK_NAME
: o nome do disco a ser incluído no grupo de consistências. -
CONSISTENCY_GROUP
: a URL do grupo de consistências. Por exemplo,projects/ PROJECT /regions/ REGION /resourcePolicies/ CONSISTENCY_GROUP_NAME
. No caso de disco regional, especifique a região no lugar da zona.
Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform .
No console do Google Cloud, acesse a página Replicação assíncrona .
Clique na guia Grupos de consistências .
Clique no nome do grupo de consistências no qual deseja incluir discos. A página Gerenciar grupo de consistências é aberta.
Selecione os discos que deseja remover do grupo de consistências.
Clique em Remover discos . Quando solicitado, clique em Remover .
-
DISK_NAME
: o nome do disco a ser removido do grupo de consistências. -
LOCATION_FLAG
: o sinalizador de localização do disco. Para um disco regional, use--region
. Para um disco zonal, use--zone
. -
LOCATION
: a região ou zona do disco. Para discos regionais, use a região. Para discos zonais, use o arquivo zone. -
CONSISTENCY_GROUP
: a URL do grupo de consistências. Por exemplo,projects/ PROJECT /regions/ REGION /resourcePolicies/ CONSISTENCY_GROUP_NAME
. Remova um disco zonal de um grupo de consistências:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/removeResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP" }
Remova um disco regional de um grupo de consistências:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/removeResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP" }
-
PROJECT
: o projeto que contém o disco. -
LOCATION
: a zona ou região do disco. Para discos zonais, use o arquivo zone. Para discos regionais, use a região. -
DISK_NAME
: o nome do disco a ser removido do grupo de consistências. -
CONSISTENCY_GROUP
: a URL do grupo de consistências. Por exemplo,projects/ PROJECT /regions/ REGION /resourcePolicies/ CONSISTENCY_GROUP_NAME
. No console do Google Cloud, acesse a página Replicação assíncrona .
Clique na guia Grupos de consistências .
Selecione o grupo de consistências que deseja excluir.
Clique em Excluir . A janela Excluir grupo de consistências é aberta.
Clique em Excluir .
-
CONSISTENCY_GROUP
: o nome do grupo de consistências -
REGION
: a região do grupo de consistência -
PROJECT
: o projeto que contém o grupo de consistências -
REGION
: a região do grupo de consistência -
CONSISTENCY_GROUP
: o nome do grupo de consistências - Saiba como gerenciar discos que usam replicação assíncrona .
- Aprenda como fazer failover e failback .
- Saiba como monitorar o desempenho da replicação assíncrona .
Terraform
Para usar os exemplos do Terraform nesta página em um ambiente de desenvolvimento local, instale e inicialize a gcloud CLI e, em seguida, configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para 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.
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Crie um grupo de consistências
Se precisar alinhar a replicação em vários discos, crie um grupo de consistências na mesma região dos discos primários. Se precisar alinhar clones de disco, crie um grupo de consistências na mesma região que os discos secundários.
Crie um grupo de consistências usando o console do Google Cloud, a CLI do Google Cloud, REST ou Terraform.
Console
Crie um grupo de consistências fazendo o seguinte:
gcloud
Crie um grupo de consistências usando o comando
gcloud compute resource-policies create disk-consistency-group
:gcloud compute resource-policies create disk-consistency-group CONSISTENCY_GROUP_NAME \ --region=REGION
Substitua o seguinte:
Ir
Java
Node.js
Pitão
DESCANSAR
Crie um grupo de consistências usando o método
resourcePolicies.insert
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies { "name": "CONSISTENCY_GROUP_NAME", "diskConsistencyGroupPolicy": { } }
Substitua o seguinte:
Terraforma
Para criar um grupo de consistências, use o recurso
compute_resource_policy
.Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform .
Visualizar discos em um grupo de consistências
Visualize discos em um grupo de consistências usando o console do Google Cloud, a CLI do Google Cloud ou REST.
Console
Visualize os discos incluídos em um grupo de consistências fazendo o seguinte:
gcloud
Visualize os discos incluídos em um grupo de consistências usando o comando
gcloud compute disks list
:gcloud compute disks list \ --LOCATION_FLAG=LOCATION \ --filter=resourcePolicies=CONSISTENCY_GROUP_NAME
Substitua o seguinte:
Ir
Java
Listar discos zonais em um grupo de consistências
Listar discos regionais em um grupo de consistências
Node.js
Pitão
DESCANSAR
Visualize os discos em um grupo de consistências usando um filtro de consulta com um dos métodos a seguir:
Substitua o seguinte:
Incluir um disco em um grupo de consistências
Se desejar incluir discos primários em um grupo de consistências, deverá incluir discos no grupo de consistências antes de iniciar a replicação. É possível incluir discos secundários em um grupo de consistências a qualquer momento. Todos os discos em um grupo de consistências devem estar na mesma zona, para discos zonais, ou no mesmo par de zonas, para discos regionais.
Adicione um disco a um grupo de consistências usando o console do Google Cloud, a CLI do Google Cloud, REST ou Terraform.
Console
Adicione discos a um grupo de consistências fazendo o seguinte:
gcloud
Adicione um disco a um grupo de consistências usando o comando
gcloud compute disks add-resource-policies
:gcloud compute disks add-resource-policies DISK_NAME \ --LOCATION_FLAG=LOCATION \ --resource-policies=CONSISTENCY_GROUP
Substitua o seguinte:
Ir
Java
Node.js
Pitão
DESCANSAR
Inclua discos em um grupo de consistências usando um dos métodos a seguir:
Substitua o seguinte:
Terraforma
Para incluir o disco no grupo de consistências, use o recurso
compute_disk_resource_policy_attachment
.Remover um disco de um grupo de consistências
Antes de poder remover um disco de um grupo de consistências, deve-se parar a replicação do disco .
Remova um disco de um grupo de consistências usando o console do Google Cloud, a Google Cloud CLI ou REST.
Console
Remova discos primários de um grupo de consistências fazendo o seguinte:
gcloud
Remova um disco de um grupo de consistências usando o comando
gcloud compute disks remove-resource-policies
:gcloud compute disks remove-resource-policies DISK_NAME \ --LOCATION_FLAG=LOCATION \ --resource-policies=CONSISTENCY_GROUP
Substitua o seguinte:
Ir
Java
Node.js
Pitão
DESCANSAR
Remova um disco de um grupo de consistências usando o método
disks.removeResourcePolicies
para discos zonais ou o métodoregionDisks.removeResourcePolicies
para discos regionais.Substitua o seguinte:
Excluir um grupo de consistências
Exclua um grupo de consistências usando o console do Google Cloud, a Google Cloud CLI ou REST.
Console
Exclua uma consistência fazendo o seguinte:
gcloud
Exclua a política de recursos usando o comando
gcloud compute resource-policies delete
:gcloud compute resource-policies delete CONSISTENCY_GROUP \ --region=REGION
Substitua o seguinte:
Ir
Java
Node.js
Pitão
DESCANSAR
Exclua uma consistência usando o método
resourcePolicies.delete
:DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
Substitua o seguinte:
O que vem a seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-21 UTC.
-