O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Gerenciar a replicação de instâncias

Neste guia, mostramos como configurar a replicação de instâncias para parear uma instância de origem com uma réplica em espera. É possível usar a replicação de instâncias nos seguintes cenários:

Proteja instâncias contra interrupções: mantenha uma instância de failover entre regiões atualizada continuamente para recuperação de desastres.
Migrar dados: promova uma réplica em espera para migrar permanentemente uma instância para um novo local com tempo de inatividade mínimo.
Executar testes operacionais: pause a replicação para montar temporariamente a réplica e execute simulações isoladas de recuperação de desastres ou teste cargas de trabalho sem afetar a instância principal.

Antes de começar

Crie uma instância do Filestore para usar como instância de origem da réplica.

Ativar APIs

Ative a API Filestore.

Funções necessárias para ativar APIs

Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão com o papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão com o papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

Ativar a API

Funções exigidas

Para receber as permissões necessárias para configurar a replicação de instâncias e monitorar réplicas, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Criar e gerenciar instâncias do Filestore: Editor do Cloud Filestore (roles/file.editor)
Ver métricas de replicação da instância: Leitor do Monitoring (roles/monitoring.viewer)
Criar e gerenciar painéis de métricas: Editor do Monitoring (roles/monitoring.editor)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Se você estiver criando uma réplica entre projetos, precisará ter o papel de editor do Cloud Filestore (roles/file.editor) definido nos projetos de origem e de réplica. Esse papel inclui a permissão file.instances.create, que é necessária no projeto de origem para criar uma réplica entre projetos.

Criar uma réplica de instância

Não é possível usar o console do Google Cloud para criar uma réplica entre projetos. Em vez disso, use a CLI gcloud ou a API REST.

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"
Clique no ID da instância que você quer replicar.
Na página de detalhes da instância, clique na guia Replicações.
Clique em Criar réplica.
Verifique os detalhes da instância de origem, revise o objetivo do ponto de recuperação com suporte e clique em Próxima.
Crie a instância. Para mais informações, consulte Criar uma instância. Considere o seguinte:
- A capacidade especificada precisa ser maior ou igual à da instância de origem.
- O nível de serviço e o protocolo do Filestore precisam ser os mesmos para a instância de origem e a réplica.
- Para uma solução robusta de recuperação de desastres, recomendamos escolher uma região diferente para a réplica, em vez de apenas uma zona diferente.
Clique em Próxima.
Revise os detalhes e clique em Próxima.
Clique em Criar.
Aguarde a conclusão da operação. Quando o processo for concluído, a réplica será listada na instância de origem na página Réplicas. Clique no ID da instância da réplica para ver os detalhes.

gcloud

Para criar uma instância de réplica, execute o comando filestore instances create.

gcloud filestore instances create INSTANCE_ID \
  --source-instance=projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/instances/SOURCE_INSTANCE_ID \
  --project=REPLICA_PROJECT_ID \
  --location=LOCATION \
  --network=name="NETWORK" \
  --tier=TIER \
  --file-share=name="FILE_SHARE_NAME",capacity=FILE_SHARE_SIZE \

Substitua:

INSTANCE_ID pelo nome da instância de réplica que você quer criar. Por exemplo, sample-replica.
SOURCE_PROJECT_ID com o ID do projeto do Google Cloud projeto em que a instância de origem está localizada.
SOURCE_LOCATION com o local em que a instância de origem reside.
SOURCE_INSTANCE_ID pelo nome da instância de origem para a qual você quer criar uma réplica. Por exemplo, sample-instance.
REPLICA_PROJECT_ID com o ID do projeto Google Cloud em que você quer que a instância de réplica fique.
LOCATION pelo local onde você quer que a instância de réplica resida, como us-central1-a. Se a origem estiver em um nível de serviço zonal, especifique uma região e uma zona para a réplica.
NETWORK com o nome da rede que você quer usar, como default.
TIER com o nível de serviço que você precisa, por exemplo,ZONAL. O nível e o intervalo de capacidade precisam corresponder à instância de origem.
FILE_SHARE_NAME é o nome que você especifica para o compartilhamento de arquivos NFS que é exibido pela instância, como vol1.
FILE_SHARE_SIZE é o tamanho que você quer que o compartilhamento de arquivos tenha, como 1.25TiB.

API REST

Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.
Para criar uma réplica de instância, use a seguinte solicitação:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  --request POST \
  -d '{"tier": "TIER",
      "networks": { "network": "NETWORK" },
      "file_shares": {"name": "SHARE_NAME","capacity_gb": "CAPACITY"},
      "replication": {"replicas":[{"peer_instance": "projects/SOURCE_PROJECT_ID/locations/ACTIVE_LOCATION/instances/ACTIVE_NAME"}], "role":"standby"},
      "description": "DESCRIPTION" }' \
  "https://file.googleapis.com/v1/projects/REPLICA_PROJECT_ID/locations/REPLICA_LOCATION/instances?instanceId=REPLICA_INSTANCE_NAME"
```
Substitua:
- TIER é o nome do nível de serviço que você quer usar para a réplica. Por exemplo, REGIONAL.
- NETWORK é o nome da rede que você quer usar para a réplica. Por exemplo, default. Use a mesma rede da origem.
- SHARE_NAME é o nome do compartilhamento de arquivos; Por exemplo, vol1.
- CAPACITY é o tamanho, em GiB, que você quer alocar para a réplica. Por exemplo, 1024. A capacidade precisa ser maior ou igual à da instância de origem.
- REPLICA_PROJECT_ID é o nome do projeto em que você quer que a réplica fique. Por exemplo, sample-project.
- SOURCE_PROJECT_ID é o nome do projeto em que a instância de origem reside.
- ACTIVE_LOCATION é o local em que a origem reside. Por exemplo, us-east1.
- ACTIVE_NAME é o nome da instância que você quer replicar. Por exemplo, sample-instance.
- DESCRIPTION é uma descrição da instância de réplica que você quer criar. Por exemplo, A sample replica.
- REPLICA_LOCATION é o local onde você quer que a réplica fique. Por exemplo, us-central1.
- REPLICA_INSTANCE_NAME é o nome da instância de réplica que você quer criar. Por exemplo, sample-replica.

Ver o status da réplica

Console do Google Cloud

No console do Google Cloud , acesse a página Replicações do Filestore.

Acessar "Replicações"

Clique no ID da instância da réplica para ver os detalhes.

gcloud

Para ver informações sobre uma instância específica, execute o comando instances describe:

gcloud filestore instances describe <var>INSTANCE_ID</var> \
   --project=<var>PROJECT_ID</var> \
  --location=<var>LOCATION</var> \

Substitua:

INSTANCE_ID com o ID da instância do Filestore que você quer visualizar, como genomics-instance.
PROJECT_ID com o ID do projeto do Google Cloud projeto que contém a instância do Filestore.

LOCATION pelo local em que a instância reside, como us-east1-b.

A resposta ao comando instances describe é semelhante a um dos exemplos a seguir.

Este exemplo de resposta mostra uma instância de origem com a replicação de instância ativada. Observe que a função especificada é ACTIVE:

createTime: '2024-06-17T22:17:26.475900265Z'
fileShares:
- capacityGb: '1024'
  name: vol1
name: projects/genomics-project/locations/us-east1-b/instances/genomics-instance-source
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 172.27.220.2
  modes:
  - MODE_IPV4
  network: default
  reservedIpRange: 172.27.220.0/26
replication:
  replicas:
  - peerInstance: projects/genomics-project/locations/us-central1-a/instances/genomics-instance-replica
    state: READY
  role: ACTIVE
state: READY
tier: ZONAL

Este exemplo de resposta mostra uma instância de réplica que foi promovida a uma instância regular. A replicação não está especificada porque ainda não está ativa:

createTime: '2024-06-20T17:11:56.048062134Z'
fileShares:
- capacityGb: '1024'
  name: vol1
name: projects/genomics-project/locations/us-west2-a/instances/genomics-instance-replica
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.155.90.194
  network: default
  reservedIpRange: 10.155.90.192/26
satisfiesPzi: true
state: READY
tier: ZONAL

Este exemplo de resposta mostra uma réplica que foi pareada com uma instância ativa. A função de replicação é STANDBY:

createTime: '2024-06-21T04:15:21.721579074Z'
fileShares:
- capacityGb: '1280'
  name: vol1
name: projects/genomics-project/locations/us-west1-a/instances/genomics-replica
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.153.44.194
  network: default
  reservedIpRange: 10.153.44.192/26
replication:
  replicas:
  - peerInstance: projects/genomics-project/locations/us-west2-a/instances/genomics-instance
    state: READY
  role: STANDBY
satisfiesPzi: true
state: READY
tier: ZONAL

API REST

Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.
Para conferir o status da réplica, use a seguinte solicitação:
```
    curl -s \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header "Content-Type: application/json" \
    --request GET \
    "https://file.googleapis.com/v1/projects/<var>PROJECT</var>/locations/<var>LOCATION</var>/instances/<var>INSTANCE_NAME</var>"
```
Substitua:
- PROJECT é o nome do projeto em que a instância está localizada. Por exemplo, sample-project.
- LOCATION é o local em que a instância está. Por exemplo, us-west1-a.
- INSTANCE_NAME é o nome da instância que você quer visualizar. Por exemplo, sample-instance.

Listar todas as réplicas em um projeto

Console do Google Cloud

No console do Google Cloud , acesse a página Replicações do Filestore.

Acessar "Replicações"

A tabela lista as instâncias de origem com as réplicas. Clique no ID da instância da réplica para ver os detalhes.

gcloud

Para ver uma lista de todas as instâncias no projeto, execute o comando instances list:

gcloud filestore instances list
  --project=PROJECT_ID \

Substitua PROJECT_ID pelo ID do projeto que você quer visualizar.

A resposta retorna uma lista de instâncias e réplicas, semelhante a esta:

INSTANCE_NAME                       LOCATION     TIER      CAPACITY_GB  FILE_SHARE_NAME  IP_ADDRESS     STATE  CREATE_TIME
genomics-source-1                   us-east1-b   ZONAL     1024         vol1             172.27.220.2   READY  2024-06-17T22:17:26
genomics-source-1-replica           us-west1-a   ZONAL     1024         vol1             10.142.57.194  READY  2024-06-17T23:47:19

API REST

Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.
Para listar réplicas em um projeto específico, use a seguinte solicitação:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  --request GET \
  "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"
```
Substitua:
- PROJECT é o nome do projeto em que a instância está localizada. Por exemplo, sample-project.
- LOCATION é o local que você quer pesquisar. Para pesquisar todas as instâncias em qualquer local de um projeto, use o endpoint list.

Pausar replicação

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"
Clique no ID da instância da réplica que você quer pausar.
Na seção Descrição, clique na guia Replicações.
Na seção Detalhes da instância ativa, clique em Pausar replicação.
Leia o alerta antes de continuar e confirme clicando em Pausar replicação.

O status da replicação muda para Pausando. Depois que a operação for concluída, o Status da replicação mudará para Pausado.

gcloud

Para pausar uma réplica, execute o comando gcloud filestore instances pause-replica.

  gcloud filestore instances pause-replica INSTANCE_ID \
      --project=PROJECT_ID \
      --location=LOCATION \

Substitua:

INSTANCE_ID com o ID da instância do Filestore que você quer pausar, como my-replica.
PROJECT_ID é o ID do projeto do Google Cloud que contém a instância do Filestore.
LOCATION com o local em que a réplica reside, como us-central1.

Quando concluída, a seguinte resposta ou semelhante é retornada:

createTime: '2025-12-22T14:03:33.727531128Z'
customPerformanceSupported: true
description: Replica of active, us-east1-b
fileShares:
- capacityGb: '1024'
  name: share
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.229.150.130
  modes:
  - MODE_IPV4
  network: default
  reservedIpRange: 10.229.150.128/26
performanceLimits:
  maxIops: '12000'
  maxReadIops: '12000'
  maxReadThroughputBps: '125829120'
  maxWriteIops: '4000'
  maxWriteThroughputBps: '104857600'
protocol: NFS_V3
replication:
  replicas:
  - peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
    state: PAUSED
    stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
  role: STANDBY
state: READY
tier: REGIONAL

API REST

Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.
Para pausar uma réplica, use a seguinte solicitação:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  --request POST \
  -d '{}' \
  "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:pauseReplica"
```
Substitua:
- PROJECT é o nome do projeto em que sua réplica reside. Por exemplo, sample-project.
- LOCATION é o local onde a réplica reside. Por exemplo, us-west1-a.
- REPLICA_NAME é o nome da instância que você quer pausar. Por exemplo, sample-replica.

Retomar replicação

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"
Clique no ID da instância da réplica que você quer usar.
Na seção Descrição, clique na guia Replicações.
Na seção Detalhes da instância ativa, clique em Retomar replicação.
Leia o alerta antes de continuar e confirme inserindo resume no campo fornecido.

O status da replicação muda para Retomando. Depois que a operação for concluída, o Status da replicação vai mudar para Pronto.

gcloud

Para retomar uma instância de réplica, execute o comando gcloud filestore instances resume-replica.

  gcloud filestore instances resume-replica INSTANCE_ID \
      --project=PROJECT_ID \
      --location=LOCATION \

Substitua:

INSTANCE_ID pelo ID da instância de réplica do Filestore que você quer retomar, como my-replica.
PROJECT_ID com o ID do projeto Google Cloud que contém a instância de réplica do Filestore.
LOCATION com o local em que a réplica reside, como us-central1.

Quando concluída, a seguinte resposta ou semelhante é retornada:

  createTime: '2025-12-22T14:03:33.727531128Z'
  customPerformanceSupported: true
  description: Replica of active, us-central1
  fileShares:
  - capacityGb: '1024'
    name: share
  name: projects/genomics-project/locations/us-central1/instances/my-replica
  networks:
  - connectMode: DIRECT_PEERING
    ipAddresses:
    - 10.229.150.130
    modes:
    - MODE_IPV4
    network: default
    reservedIpRange: 10.229.150.128/26
  performanceLimits:
    maxIops: '12000'
    maxReadIops: '12000'
    maxReadThroughputBps: '125829120'
    maxWriteIops: '4000'
    maxWriteThroughputBps: '104857600'
  protocol: NFS_V3
  replication:
    replicas:
    - peerInstance: projects/genomics-project/locations/us-central1/instances/my-source
      state: READY
      stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
    role: STANDBY
  state: READY
  tier: REGIONAL

API REST

Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.
Para retomar a replicação, use a seguinte solicitação:

curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      --request POST \
      -d '{}' \
      "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:resumeReplica"

Substitua:

PROJECT é o nome do projeto em que a réplica está localizada. Por exemplo, sample-project.
LOCATION é o local onde a réplica reside. Por exemplo, us-west1-a.
REPLICA_NAME é o nome da instância que você quer retomar. Por exemplo, sample-replica.

Interromper a replicação e promover a réplica

Interromper a replicação entre as instâncias ativa e em espera promove a réplica a uma instância comum. Essa operação é irreversível.

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"
Clique no ID da instância da réplica que você quer usar.
Clique em Interromper replicação.
Insira o ID da instância da réplica e clique em Interromper replicação.
Aguarde a conclusão da operação.

gcloud

Para promover uma instância de réplica, execute o comando gcloud filestore instances promote-replica.

  gcloud filestore instances promote-replica INSTANCE_ID 

      --project=PROJECT_ID 

      --location=LOCATION

Substitua:

INSTANCE_ID com o ID da instância do Filestore que você quer promover, como my-replica.
PROJECT_ID é o ID do projeto do Google Cloud que contém a instância do Filestore.
LOCATION com o local em que a réplica reside, como us-central1.

Quando concluída, a seguinte resposta ou semelhante é retornada:

capacityGb: '1024'
capacityStepSizeGb: '256'
createTime: '2024-06-20T17:11:56.048062134Z'
fileShares:
- capacityGb: '1024'
  name: vol1
maxCapacityGb: '9984'
maxShareCount: '1'
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.155.90.194
  network: default
  reservedIpRange: 10.155.90.192/26
protocol: NFS_V3
replication:
  replicas:
  - lastActiveSyncTime: '2024-06-21T00:13:23Z'
    peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
  role: STANDBY
satisfiesPzi: true
state: PROMOTING
tier: ZONAL

API REST

Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.
Para promover a réplica, use a seguinte solicitação:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  --request POST \
  -d '{}' \
  "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:promoteReplica"
```
Substitua:
- PROJECT é o nome do projeto em que sua réplica está localizada. Por exemplo, sample-project.
- LOCATION é o local onde a réplica reside. Por exemplo, us-west1-a.
- REPLICA_NAME é o nome da instância que você quer promover. Por exemplo, sample-replica.

Excluir uma instância de réplica

Console do Google Cloud

No console do Google Cloud , acesse a página de instâncias do Filestore.

Acesse "Instâncias"

As réplicas são listadas nas instâncias de origem associadas. Se você não encontrar uma réplica, consulte os comandos gcloud para essa tarefa.
Clique no código da instância que você quer excluir.
Clique em Excluir.

gcloud

Para conferir uma lista de todas as instâncias, incluindo réplicas, execute o comando instances list:
```
gcloud filestore instances list
  --project=PROJECT_ID \
```
Substitua PROJECT_ID pelo ID do projeto que você quer visualizar.
Copie os detalhes da instância que você quer excluir.
Para excluir uma instância de réplica, execute o comando filestore instances delete.
```
gcloud filestore instances delete INSTANCE_ID \
  --location=LOCATION \
```

Substitua:

INSTANCE_ID com o ID da instância do Filestore que você quer excluir, como my-replica.
LOCATION com o local em que a réplica reside, como us-central1-a.

API REST

Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.
Para excluir uma instância de réplica, use a seguinte solicitação:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  --request DELETE \
  "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"
```
Substitua:
- PROJECT é o nome do projeto em que a instância está localizada. Por exemplo, sample-project.
- LOCATION é o local em que a instância está. Por exemplo, us-west1-a.
- INSTANCE_NAME é o nome da instância que você quer excluir. Por exemplo, sample-instance.

Monitorar a replicação de instâncias

Console do Google Cloud

Para ver as métricas de replicação de instâncias do Filestore em um painel do Cloud Monitoring, siga estas etapas:

No console Google Cloud , acesse a página do Metrics explorer:
Acesse o Metrics Explorer

Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
Clique na seção expansível Selecionar uma métrica.
No campo Filtrar por nome do recurso ou da métrica, digite filestore e selecione a seção expansível Instância do Filestore.
Selecione a seção expansível Instância e clique em RPO.
A métrica de RPO times_since_last_replication é exibida. Essa métrica fica disponível alguns minutos após a conclusão da sincronização inicial dos dados replicados.

A seguir

Saiba mais sobre a replicação de instâncias.
Leia a documentação de referência sobre replicação de instâncias.

Gerenciar a replicação de instâncias Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Ativar APIs

Funções exigidas

Criar uma réplica de instância

Console do Google Cloud

gcloud

API REST

Ver o status da réplica

Console do Google Cloud

gcloud

API REST

Listar todas as réplicas em um projeto

Console do Google Cloud

gcloud

API REST

Pausar replicação

Console do Google Cloud

gcloud

API REST

Retomar replicação

Console do Google Cloud

gcloud

API REST

Interromper a replicação e promover a réplica

Console do Google Cloud

gcloud

API REST

Excluir uma instância de réplica

Console do Google Cloud

gcloud

API REST

Monitorar a replicação de instâncias

Console do Google Cloud

A seguir

Gerenciar a replicação de instâncias