Administra la replicación de instancias

En esta guía, se muestra cómo usar la replicación de instancias de Filestore.

Antes de comenzar

Completa los pasos de configuración necesarios para usar Filestore. La cuota para las instancias varía según el proyecto, la región y el nivel. Asegúrate de tener suficiente para completar estas tareas. Para obtener más información, consulta Cuotas o Solicita un aumento de la cuota.
Si aún no lo hiciste, crea una instancia de Filestore. En el contexto de esta guía, esta es la instancia de origen.

Nota: La replicación de instancias está disponible para los niveles de servicio regionales, zonales y empresariales.

Crea una réplica de instancia

Consola de Google Cloud

En la consola de Google Cloud , ve a la página Instancias de Filestore.

Ir a Instancias
Haz clic en el ID de la instancia que deseas replicar.
Haz clic en la pestaña Replicaciones.
Haz clic en Crear réplica.
Haz clic en el vínculo de la documentación para revisar el objetivo de punto de recuperación (RPO) admitido y, luego, haz clic en Siguiente.
Ingresa todos los campos obligatorios y opcionales según sea necesario.
- La capacidad especificada debe ser mayor o igual que la de la fuente.
- Las siguientes especificaciones deben coincidir con la instancia de origen:
  - Nivel de servicio, incluido el rango de capacidad
  - Protocolo de Filestore
- Para reducir el riesgo de pérdida de datos, te recomendamos que elijas una región y una zona exclusivas para la fuente.
Haz clic en Siguiente.
Revisa los detalles y haz clic en Siguiente.
Haz clic en Crear.
Espera a que se complete la operación. Cuando termine, la réplica aparecerá en la instancia de origen en la página Instancias.
Haz clic en el ID de instancia de la réplica para ver sus detalles.

gcloud

Para crear una instancia de réplica, ejecuta el comando filestore instances create.

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

Aquí:

INSTANCE_ID por el nombre de la instancia que deseas crear, como my-replica.
SOURCE_INSTANCE por el nombre y la ubicación de la instancia de origen para la que deseas crear una réplica. Por ejemplo, projects/my-genomics-project/locations/us-east1-b/instances/my-genomics-instance.
PROJECT_ID por el ID del proyecto Google Cloud en el que se encuentra la instancia de origen
LOCATION con la ubicación en la que deseas que resida la instancia de réplica, como us-central1-a. Si la fuente se encuentra en un nivel de servicio zonal, debes especificar una región y una zona para la réplica.
NETWORK por el nombre de la red que deseas usar, como default
TIER por el nivel de servicio que necesitas, como ZONAL. El nivel y el rango de capacidad deben coincidir con la fuente.
FILE_SHARE_NAME por el nombre que especificas para el recurso compartido de archivos NFS que se entrega desde la instancia, como vol1.
FILE_SHARE_SIZE con el tamaño que deseas para el recurso compartido de archivos, como 1.25TiB.

API de REST

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Usa cURL para llamar a la API de Filestore:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  -d '{"tier": "TIER",
      "networks": { "network": "NETWORK" },
      "file_shares": {"name": "SHARE_NAME","capacity_gb": "CAPACITY"},
      "replication": {"replicas":[{"peer_instance": "projects/PROJECT/locations/ACTIVE_LOCATION/instances/ACTIVE_NAME"}], "role":"standby"},
      "description": "DESCRIPTION" }' \
  "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/REPLICA_LOCATION/instances?instanceId=REPLICA_INSTANCE_NAME"
```
Aquí:
- TIER es el nombre del nivel de servicio que deseas usar para la réplica. Por ejemplo, REGIONAL
- NETWORK es el nombre de la red que deseas usar para la réplica. Por ejemplo, default Debes usar la misma red que la fuente.
- SHARE_NAME es el nombre del archivo compartido. Por ejemplo, vol1.
- CAPACITY es el tamaño, en GiB, que deseas asignar a la réplica. Por ejemplo, 1024 La capacidad debe ser mayor o igual que la de la instancia de origen.
- PROJECT es el nombre del proyecto en el que residirá tu réplica. Por ejemplo, my-genomics-project El origen y la réplica deben estar ubicados en el mismo proyecto.
- ACTIVE_LOCATION es la ubicación en la que reside la fuente. Por ejemplo, us-east1
- ACTIVE_NAME es el nombre de la instancia que deseas replicar. Por ejemplo, my-genomics-instance
- DESCRIPTION es una descripción de la instancia de réplica que deseas crear. Por ejemplo, My genomics replica.
- REPLICA_LOCATION es la ubicación en la que deseas que resida la réplica. Por ejemplo, us-central1
- REPLICA_INSTANCE_NAME es el nombre de la instancia de réplica que deseas crear. Por ejemplo, my-genomics-replica

Cómo ver el estado de la réplica

Consola de Google Cloud

En la consola de Google Cloud , ve a la página Instancias de Filestore.

Ir a Instancias
Haz clic en el ID de la instancia de la réplica que deseas ver.
En la sección Descripción, haz clic en la pestaña Replicaciones.
Aquí puedes ver el Estado de la réplica y el Último punto de sincronización, una marca de tiempo de la última vez que se copió una copia completa de tus datos en la réplica.

gcloud

Para ver información sobre una instancia específica, ejecuta el comando instances describe:

gcloud filestore instances describe INSTANCE_ID \
    --project=PROJECT_ID \
    --location=LOCATION \

Aquí:

INSTANCE_ID por el ID de la instancia de Filestore que deseas ver, como genomics-instance.
PROJECT_ID por el ID del proyecto de Google Cloud que contiene la instancia de Filestore.

LOCATION con la ubicación en la que reside la instancia, como us-east1-b.

La respuesta al comando instances describe es similar a cualquiera de los siguientes ejemplos.

En este ejemplo de respuesta, se muestra una instancia de origen con la replicación de instancias habilitada. Observa que el rol especificado es 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

En este ejemplo de respuesta, se muestra una instancia de réplica que se promovió a instancia normal. Observa que la replicación no se especifica, ya que aún no se habilitó:

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

En este ejemplo de respuesta, se muestra una réplica que se vinculó con una instancia activa. Observa que el rol aparece como 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 de REST

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Usa cURL para llamar a la API de Filestore:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  GET "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"
```
Aquí:
- PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, my-genomics-project
- LOCATION es la ubicación en la que reside tu instancia. Por ejemplo, us-west1-a
- INSTANCE_NAME es el nombre de la instancia que deseas ver. Por ejemplo, my-genomics-instance

Enumera todas las réplicas de un proyecto

Consola de Google Cloud

En la consola de Google Cloud , ve a la página Instancias de Filestore.

Ir a Instancias

Las réplicas se enumeran en sus instancias de origen asociadas.

gcloud

Para ver una lista de todas las instancias del proyecto, ejecuta el comando instances list:

gcloud filestore instances list
    --project=PROJECT-ID \

Aquí:

PROJECT-ID por el ID del proyecto que deseas ver.

La respuesta muestra una lista de instancias y réplicas, similar a la siguiente:

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 de REST

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Usa cURL para llamar a la API de Filestore:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  GET "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"
```
Aquí:
- PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, my-genomics-project
- LOCATION es la ubicación que deseas buscar. Para buscar todas las instancias en cualquier ubicación dentro de un proyecto, usa -.

Pausar replicación

Consola de Google Cloud

En la consola de Google Cloud , ve a la página Instancias de Filestore.

Ir a Instancias
Haz clic en el ID de la instancia de réplica que deseas usar.
En la sección Descripción, haz clic en la pestaña Replicaciones.
En la sección Detalles de la instancia activa, haz clic en Pausar replicación.
Lee la alerta antes de continuar y haz clic en Pausar la replicación para confirmar.

El estado de la replicación cambia a Pausando. Una vez finalizada la operación, el Estado de replicación cambia a Pausado y muestra la fecha en la que se pausó la réplica.

gcloud

Puedes pausar una instancia de réplica ejecutando el comando gcloud filestore instances pause-replica.

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

Aquí:

INSTANCE_ID por el ID de la instancia de Filestore que deseas pausar, como my-replica.
PROJECT_ID por el ID del proyecto de Google Cloud que contiene la instancia de Filestore
LOCATION por la ubicación en la que reside la réplica, como us-central1.

Cuando se completa correctamente, se muestra la siguiente respuesta o una similar:

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 de REST

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Usa cURL para llamar a la API de Filestore:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:pauseReplica"
```
Aquí:
- PROJECT es el nombre del proyecto en el que se encuentra tu réplica. Por ejemplo, my-genomics-project
- LOCATION es la ubicación en la que reside la réplica. Por ejemplo, us-west1-a
- REPLICA_NAME es el nombre de la instancia que deseas detener. Por ejemplo, my-genomics-replica

Reanudar la replicación

Consola de Google Cloud

En la consola de Google Cloud , ve a la página Instancias de Filestore.

Ir a Instancias
Haz clic en el ID de la instancia de réplica que deseas usar.
En la sección Descripción, haz clic en la pestaña Replicaciones.
En la sección Detalles de la instancia activa, haz clic en Reanudar la replicación.
Lee la alerta antes de continuar y confirma ingresando resume en el campo proporcionado.

El estado de la replicación cambia a Reanudando. Una vez finalizada la operación, el Estado de replicación cambia a Listo.

gcloud

Para reanudar una instancia de réplica, ejecuta el comando gcloud filestore instances resume-replica.

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

Aquí:

INSTANCE_ID por el ID de la instancia de réplica de Filestore que deseas reanudar, como my-replica.
PROJECT_ID por el ID del proyecto de Google Cloud que contiene la instancia de réplica de Filestore
LOCATION por la ubicación en la que reside la réplica, como us-central1.

Cuando se completa correctamente, se muestra la siguiente respuesta o una similar:

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 de REST

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Usa cURL para llamar a la API de Filestore:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:resumeReplica"
```
Aquí:
- PROJECT es el nombre del proyecto en el que se encuentra tu réplica. Por ejemplo, my-genomics-project
- LOCATION es la ubicación en la que reside la réplica. Por ejemplo, us-west1-a
- REPLICA_NAME es el nombre de la instancia que deseas reanudar. Por ejemplo, my-genomics-replica

Separa la replicación y promueve la réplica

En esta sección, interrumpirás la replicación entre las instancias activa y en espera. Esta acción promueve la réplica a una instancia normal.

Esta operación es irreversible y debe usarse con cuidado.
Una vez que se promueve a una instancia normal, el recurso se puede vincular con una réplica nueva.
La conmutación por recuperación no es automática. Una vez que se complete la operación para interrumpir la replicación, los administradores deberán volver a conectar sus aplicaciones a la nueva instancia de origen. Para obtener más información, consulta Asciende la réplica.

Consola de Google Cloud

En la consola de Google Cloud , ve a la página Instancias de Filestore.

Ir a Instancias
Haz clic en el ID de la instancia de réplica que deseas usar.
Haz clic en Interrumpir replicación.
Lee la alerta antes de continuar.

Separar la replicación detendrá la sincronización de datos permanentemente y convertirá las instancias activas y en espera en instancias normales. No se replicarán los cambios que se realicen después del último punto de sincronización registrado. Esta acción es irreversible.
Ingresa el ID de instancia de la réplica y, luego, haz clic en Interrumpir replicación.
Espera a que se complete la operación correctamente.

gcloud

Puedes promover una instancia de réplica ejecutando el comando gcloud filestore instances promote-replica.

  gcloud filestore instances promote-replica INSTANCE-ID \
      --project=PROJECT-ID \
      --location=LOCATION \

Aquí:

INSTANCE_ID por el ID de la instancia de Filestore que deseas promover, como my-replica.
PROJECT_ID por el ID del proyecto de Google Cloud que contiene la instancia de Filestore
LOCATION por la ubicación en la que reside la réplica, como us-central1.

Cuando se completa correctamente, se muestra la siguiente respuesta o una similar:

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 de REST

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Usa cURL para llamar a la API de Filestore:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:promoteReplica"
```
Aquí:
- PROJECT es el nombre del proyecto en el que se encuentra tu réplica. Por ejemplo, my-genomics-project
- LOCATION es la ubicación en la que reside la réplica. Por ejemplo, us-west1-a
- REPLICA_NAME es el nombre de la instancia que deseas promover. Por ejemplo, my-genomics-replica

Borra una instancia de réplica

Consola de Google Cloud

En la consola de Google Cloud , ve a la página de instancias de Filestore.

Ir a Instancias

Las réplicas se enumeran en sus instancias de origen asociadas. Si no ves una réplica, consulta los comandos gcloud para esta tarea.
Haz clic en el ID de la instancia que deseas borrar.
Haz clic en Borrar.

gcloud

Para ver una lista de todas las instancias, incluidas las réplicas, en el proyecto, ejecuta el comando instances list:
```
gcloud filestore instances list
    --project=PROJECT_ID \
```
Aquí:
- PROJECT_ID por el ID del proyecto que deseas ver.
Copia los detalles de la instancia que deseas borrar.

Para borrar una instancia, ejecuta el comando filestore instances delete.

gcloud filestore instances delete INSTANCE_ID \
    --location=LOCATION \

Aquí:

INSTANCE_ID con el ID de la instancia de Filestore que deseas borrar, como my-replica
LOCATION por la ubicación en la que reside la réplica, como us-central1-a.

API de REST

Tener la gcloud CLI instalada e inicializada , lo que te permite generar un token de acceso para el encabezado Authorization.

Usa cURL para llamar a la API de Filestore:
```
curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  --request DELETE "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"
```
Aquí:
- PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, my-genomics-project
- LOCATION es la ubicación en la que reside tu instancia. Por ejemplo, us-west1-a
- INSTANCE_NAME es el nombre de la instancia que deseas borrar. Por ejemplo, my-genomics-instance

Supervisa la replicación de instancias

Consola de Google Cloud

Para ver las métricas de replicación de instancias de Filestore en un panel de Cloud Monitoring, sigue estos pasos:

Antes de comenzar, asegúrate de tener acceso a los siguientes roles:
- Visualizador de Monitoring
- Editor de Monitoring
Para ver cómo otorgar acceso a estos roles, consulta Otorga acceso a Cloud Monitoring.
En la consola de Google Cloud , accede a la página Explorador de métricas:
Acceder al Explorador de métricas

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
Haz clic en la sección desplegable Selecciona una métrica.
En el campo Filtrar por nombre de recurso o métrica, escribe filestore y selecciona la sección desplegable Instancia de Filestore.
Selecciona la sección expandible Instancia y, luego, haz clic en RPO.
Se muestra la métrica del RPO times_since_last_replication. Esta métrica está disponible varios minutos después de que se completa la sincronización inicial de los datos replicados.

¿Qué sigue?

Obtén más información sobre la replicación de instancias.
Lee la documentación de referencia sobre la replicación de instancias.

Administra la replicación de instancias Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Crea una réplica de instancia

Consola de Google Cloud

gcloud

API de REST

Cómo ver el estado de la réplica

Consola de Google Cloud

gcloud

API de REST

Enumera todas las réplicas de un proyecto

Consola de Google Cloud

gcloud

API de REST

Pausar replicación

Consola de Google Cloud

gcloud

API de REST

Reanudar la replicación

Consola de Google Cloud

gcloud

API de REST

Separa la replicación y promueve la réplica

Consola de Google Cloud

gcloud

API de REST

Borra una instancia de réplica

Consola de Google Cloud

gcloud

API de REST

Supervisa la replicación de instancias

Consola de Google Cloud

¿Qué sigue?

Administra la replicación de instancias