En esta página, se describe cómo usar la función de replicación turbo en un bucket de doble región.
Permisos necesarios
Console
Para completar esta guía con la consola de Google Cloud, debes tener los permisos de IAM adecuados. Para usar esta función, debes tener un bucket en una ubicación birregional o tener la intención de crear uno. Si el bucket al que deseas acceder para transmitir existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con los permisos necesarios.
A fin de obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para la consola de Google Cloud.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Línea de comandos
Para completar esta guía con una utilidad de línea de comandos, debes tener los permisos de IAM adecuados. Para usar esta función, debes tener un bucket en una ubicación birregional o tener la intención de crear uno. Si el bucket al que deseas acceder para transmitir existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para los comandos de gcloud storage
.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
Bibliotecas cliente
Para completar esta guía con las bibliotecas cliente de Cloud Storage, debes tener los permisos de IAM adecuados. Para usar esta función, debes tener un bucket en una ubicación birregional o tener la intención de crear uno. Si el bucket al que deseas acceder para transmitir existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con los permisos necesarios.
A menos que se indique lo contrario, las solicitudes de la biblioteca cliente se realizan mediante la API de JSON y requieren permisos, como se indica en Permisos de IAM para métodos de JSON. Para ver qué métodos de la API de JSON se invocan cuando realizas solicitudes a través de una biblioteca cliente, registra las solicitudes sin procesar.
Para obtener una lista de los roles de IAM relevantes, consulta Roles de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
APIs de REST
API de JSON
Para completar esta guía con la API de JSON, debes tener los permisos de IAM adecuados. Para usar esta función, debes tener un bucket en una ubicación birregional o tener la intención de crear uno. Si el bucket al que deseas acceder para transmitir existe en un proyecto que no creaste, tal vez necesites que el propietario del proyecto te otorgue un rol con los permisos necesarios.
Si deseas obtener una lista de los permisos necesarios para acciones específicas, consulta Permisos de IAM para métodos JSON.
Para obtener una lista de los roles relevantes, consulta Funciones de Cloud Storage. Como alternativa, puedes crear un rol personalizado que tenga permisos más limitados.
API de XML
Esta función no se puede administrar a través de la API de XML. En su lugar, usa la API de JSON.
Configurar la replicación turbo
Para habilitar o inhabilitar la replicación turbo en un bucket existente, completa las siguientes instrucciones:
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 deseado.
Haz clic en la pestaña Configuración.
En la fila Replicación, haz clic en
Editar.La ventana que aparece indica si estás a punto de Habilitar la replicación turbo o Inhabilitar la replicación turbo.
Haz clic en Guardar para confirmar la configuración nueva.
Línea de comandos
Usa el comando gcloud storage buckets update
con la marca --rpo
:
gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE
Aquí:
BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
STATE
esASYNC_TURBO
cuando se habilita la replicación turbo oDEFAULT
cuando se inhabilita.
Si se ejecuta de forma correcta, la respuesta se ve de la siguiente manera:
Updating gs://my-bucket/... Completed 1
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilita la replicación turbo en un bucket:
En el siguiente ejemplo, se habilita la replicación predeterminada en un bucket:
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilita la replicación turbo en un bucket:
En el siguiente ejemplo, se habilita la replicación predeterminada en un bucket:
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilita la replicación turbo en un bucket:
En el siguiente ejemplo, se habilita la replicación predeterminada en un bucket:
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilita la replicación turbo en un bucket:
En el siguiente ejemplo, se habilita la replicación predeterminada en un bucket:
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilita la replicación turbo en un bucket:
En el siguiente ejemplo, se habilita la replicación predeterminada en un bucket:
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilita la replicación turbo en un bucket:
En el siguiente ejemplo, se habilita la replicación predeterminada en un bucket:
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilita la replicación turbo en un bucket:
En el siguiente ejemplo, se habilita la replicación predeterminada en un bucket:
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
En el siguiente ejemplo, se habilita la replicación turbo en un bucket:
En el siguiente ejemplo, se habilita la replicación predeterminada en un bucket:
API de REST
API de JSON
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Crea un archivo JSON que contenga la siguiente información:
{ "rpo": "STATE" }
En el ejemplo anterior,
STATE
esASYNC_TURBO
cuando se habilita la replicación turbo oDEFAULT
cuando se inhabilita.Usa
cURL
para llamar a la API de JSON con una solicitud de bucketPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Dónde:
JSON_FILE_NAME
es la ruta de acceso del archivo JSON que creaste en el paso 2.OAUTH2_TOKEN
es el token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
Si la solicitud se realiza correctamente, no se mostrará ninguna respuesta.
API de XML
Esta función no se puede administrar a través de la API de XML. En su lugar, usa la API de JSON.
Comprueba el estado de replicación de un bucket
Para verificar el objetivo de punto de recuperación (RPO) o el estado de replicación de un bucket, completa las siguientes instrucciones:
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 que deseas verificar.
Haz clic en la pestaña Configuración.
Si la replicación turbo está habilitada en el bucket, la replicación se establece en Turbo.
Línea de comandos
Usa el comando gcloud storage buckets describe
con la marca --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(rpo)"
Dónde:
BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
Si se ejecuta de forma correcta, la respuesta se parece al siguiente ejemplo:
rpo: ASYNC_TURBO
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Java.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Node.js.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage PHP.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Python.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Ruby.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
API de REST
API de JSON
- Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth. Para obtener instrucciones, consulta Autenticación de la API.
Usa
cURL
para llamar a la API de JSON con una solicitud de bucketGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
Aquí:
OAUTH2_TOKEN
es el nombre del token de acceso que generaste en el paso 1.BUCKET_NAME
es el nombre del bucket correspondiente. Por ejemplo,my-bucket
.
La respuesta se ve como el siguiente ejemplo:
{ "name": "my-bucket", "projectNumber": "234...", ... "rpo": "ASYNC_TURBO" }
Observa la clave
rpo
. El valorASYNC_TURBO
indica que la replicación turbo está habilitada.DEFAULT
indica que se aplica la replicación predeterminada. El camporpo
siempre está presente para buckets multirregionales y de región doble, pero está ausente en los buckets de una sola región.
API de XML
Esta función no se puede administrar a través de la API de XML. En su lugar, usa la API de JSON.
¿Qué sigue?
- Más información sobre la replicación turbo
- Más información sobre los precios de la replicación turbo.
- Obtén información sobre las métricas que supervisan el rendimiento de los buckets, incluido el rendimiento de la replicación.
- Obtén información sobre cómo las alertas de Cloud Monitoring se pueden usar para crear políticas de alertas en función de métricas especificadas y administrar notificaciones asociadas.