En esta página, se describe cómo usar la replicación entre buckets, que usa el Servicio de transferencia de almacenamiento para copiar objetos nuevos y actualizados de forma asíncrona de un bucket de origen a uno de destino. Cuando usas la replicación entre buckets, creas y administras trabajos de replicación, que son un tipo de trabajo en Storage Transfer Service.
Antes de comenzar
Para usar la replicación entre bucket, debes completar los pasos previos. Para obtener instrucciones, consulta Antes de comenzar en la documentación del Servicio de transferencia de almacenamiento.
Crea un trabajo de replicación
Console
Cuando creas un trabajo de replicación entre buckets con la consola de Google Cloud, al agente de servicio del Servicio de transferencia de almacenamiento se le otorga automáticamente el rol storage.legacyBucketOwner en el bucket de origen y el rol storage.legacyBucketWriter en el bucket de destino.
Cuando usas la consola de Google Cloud, puedes crear un trabajo de replicación para buckets existentes o para buckets nuevos durante el proceso de creación de buckets.
Para crear un trabajo de replicación para un bucket nuevo, sigue las instrucciones para crear un bucket nuevo.
Para crear un trabajo de replicación para un bucket existente, completa los siguientes pasos:
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket de origen cuyos objetos deseas replicar.
En la página de detalles del bucket haz clic en la pestaña Configuración.
Busca la opción Replicación entre buckets y haz clic en Editar.
En el panel Editar replicación entre buckets que se abre, haz clic en Agregar un destino.
En la sección Elige un destino, selecciona un bucket de destino y, luego, haz clic en Siguiente.
En la sección Elige la configuración de replicación, haz lo siguiente:
Opcional: Para filtrar los objetos que se replicarán por prefijo de nombre de objeto, selecciona la casilla de verificación Replicar objetos en función del prefijo en la sección Elegir qué objetos replicar.
Para incluir objetos por prefijo, ingresa un prefijo en la sección Incluir objetos con prefijo y, luego, haz clic en Agregar un prefijo.
Para excluir objetos por prefijo, ingresa un prefijo en la sección Excluir los objetos con prefijo y, luego, haz clic en Agregar un prefijo.
Opcional: Para establecer una clase de almacenamiento para los objetos replicados, selecciona una clase de almacenamiento del menú en la sección Establecer la clase de almacenamiento para los objetos replicados.
Si omites este paso, los objetos replicados usarán la clase de almacenamiento del bucket de destino de forma predeterminada.
- Haz clic en Guardar.
Línea de comandos
Si deseas obtener instrucciones sobre cómo crear un trabajo de replicación con Google Cloud CLI, consulta Cómo crear un trabajo de replicación con Google Cloud CLI.
API de REST
API de JSON
Si necesitas instrucciones de la API de JSON para crear un trabajo de replicación, consulta Cómo crear un trabajo de replicación con la API de JSON.
Para verificar el estado de la tarea de replicación, consulta Cloud Logging para ver los registros del Servicio de transferencia de almacenamiento.
Enumera los trabajos de replicación
Console
No puedes enumerar trabajos de replicación con la consola de Google Cloud. Consulta Cómo ver un trabajo de replicación para obtener instrucciones sobre cómo ver un solo trabajo de replicación a la vez.
Línea de comandos
Para obtener instrucciones sobre cómo usar Google Cloud CLI para enumerar trabajos de replicación, consulta Cómo enumerar trabajos de replicación con Google Cloud CLI.
API de REST
API de JSON
Si necesitas instrucciones de la API de JSON para enumerar trabajos de replicación, consulta Cómo enumerar trabajos de replicación con la API de JSON.
Ve un trabajo de replicación
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket de origen cuyo trabajo de replicación entre buckets deseas ver.
En la página de detalles del bucket haz clic en la pestaña Configuración.
Busca la opción Replicación entre buckets y haz clic en Editar.
Aparecerá el panel Editar replicación entre buckets, que muestra la tarea de replicación de cada bucket de destino.
En la página Buckets, puedes ver la columna Replication, que muestra si un bucket tiene un trabajo de replicación turbo o un trabajo de replicación entre buckets en ejecución. Para obtener instrucciones sobre cómo mostrar la columna Replicación, consulta Cómo mostrar columnas.
Línea de comandos
Si deseas obtener instrucciones de Google Cloud CLI para ver un trabajo de replicación, consulta Cómo ver un trabajo de replicación con Google Cloud CLI.
API de REST
API de JSON
Si deseas obtener instrucciones de la API de JSON para ver un trabajo de replicación, consulta Cómo ver un trabajo de replicación con la API de JSON.
Actualiza un trabajo de replicación
Puedes actualizar los siguientes campos de un trabajo de replicación:
La descripción del trabajo de replicación
La configuración para ejecutar un trabajo de replicación
La configuración de las notificaciones publicadas en Pub/Sub
El comportamiento de registro para las operaciones de trabajos de replicación
El estado del trabajo de replicación (si está habilitado, inhabilitado o eliminado)
Console
Cuando usas la consola de Google Cloud, solo puedes actualizar un trabajo de replicación si lo pausas o lo reanudas.
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket de origen cuya replicación deseas pausar o reanudar.
En la página de detalles del bucket haz clic en la pestaña Configuración.
Busca la opción Replicación entre buckets y haz clic en Editar.
En el panel Editar replicación entre buckets que aparece, haz clic en Pausar o Despausar junto al trabajo de replicación que deseas actualizar.
Línea de comandos
Si deseas obtener instrucciones de Google Cloud CLI para actualizar un trabajo de replicación, consulta Cómo actualizar un trabajo de replicación con Google Cloud CLI.
API de REST
API de JSON
Si necesitas instrucciones de la API de JSON para actualizar un trabajo de replicación, consulta Cómo actualizar un trabajo de replicación con la API de JSON.
Borra un trabajo de replicación
Console
- En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket de origen que deseas dejar de replicar.
En la página de detalles del bucket haz clic en la pestaña Configuración.
Busca la opción Replicación entre buckets y haz clic en Editar.
En el panel Editar replicación entre buckets que aparece, haz clic en Borrar junto al trabajo de replicación que deseas borrar.
En el cuadro de diálogo que aparece, haz clic en Permitir.
Línea de comandos
Si deseas obtener instrucciones de Google Cloud CLI para borrar un trabajo de replicación, consulta Cómo borrar un trabajo de replicación con Google Cloud CLI.
API de REST
API de JSON
Si quieres obtener instrucciones de la API de JSON para borrar un trabajo de replicación, consulta Cómo borrar un trabajo de replicación con la API de JSON.