Gestionar la replicación de turbo (original) (raw)

Para obtener los permisos necesarios para usar la replicación turbo, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Storage (roles/storage.admin) en el segmento.

Este rol predefinido contiene los permisos necesarios para usar la replicación turbo. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Para habilitar o inhabilitar la replicación turbo en un bucket, siga estas instrucciones:

Consola

  1. En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
    Ir a Contenedores
  2. En la lista de segmentos, haga clic en el nombre del segmento que quiera.
  3. Haz clic en la pestaña Configuration (Configuración).
  4. En la fila Replicación, haga clic enEditar.
    En la ventana que aparece se indica si vas a Habilitar la replicación turbo o Inhabilitar la replicación turbo.
  5. Haz clic en Guardar para confirmar el nuevo ajuste.

Línea de comandos

Usa el comando gcloud storage buckets update con la marca --rpo:

gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE

Donde:

Si la acción se realiza correctamente, la respuesta tendrá este aspecto:

Updating gs://my-bucket/... Completed 1

Bibliotecas de cliente

C++

Para obtener más información, consulta ladocumentación de referencia de la API C++ de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

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#

Para obtener más información, consulta ladocumentación de referencia de la API C# de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

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

Para obtener más información, consulta ladocumentación de referencia de la API Go de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

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

Para obtener más información, consulta ladocumentación de referencia de la API Java de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la replicación turbo en un contenedor:

En el siguiente ejemplo se habilita la replicación predeterminada en un bucket:

Node.js

Para obtener más información, consulta ladocumentación de referencia de la API Node.js de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

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

Para obtener más información, consulta ladocumentación de referencia de la API PHP de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

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

Para obtener más información, consulta ladocumentación de referencia de la API Python de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la replicación turbo en un contenedor:

En el siguiente ejemplo se habilita la replicación predeterminada en un bucket:

Ruby

Para obtener más información, consulta ladocumentación de referencia de la API Ruby de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la replicación turbo en un contenedor:

En el siguiente ejemplo se habilita la replicación predeterminada en un bucket:

APIs REST

API JSON

  1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
  2. Crea un archivo JSON que contenga la siguiente información:
    {
    "rpo": "STATE"
    }
    Donde STATE es ASYNC_TURBO para habilitar la replicación turbo o DEFAULT para inhabilitarla.
  3. Usa cURL para llamar a la API JSON con una solicitud de PATCH contenedor:
    curl -X PATCH --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
    Donde:
    • JSON_FILE_NAME es la ruta del archivo JSON que has creado en el paso 2.
    • BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.
      Si la solicitud se realiza correctamente, no se devuelve ninguna respuesta.

API XML

Esta función no se puede gestionar a través de la API XML. Usa la API JSON.

Consola

  1. En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
    Ir a Contenedores
  2. En la lista de segmentos, haz clic en el nombre del segmento que quieras verificar.
  3. Haz clic en la pestaña Configuration (Configuración).
  4. Si la replicación turbo está habilitada en el segmento, el valor de Replicación será 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)"

Donde:

Si la acción se realiza correctamente, la respuesta se parecerá al siguiente ejemplo:

rpo: ASYNC_TURBO

Bibliotecas de cliente

C++

Para obtener más información, consulta ladocumentación de referencia de la API C++ de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

C#

Para obtener más información, consulta ladocumentación de referencia de la API C# de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Go

Para obtener más información, consulta ladocumentación de referencia de la API Go de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Java

Para obtener más información, consulta ladocumentación de referencia de la API Java de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Node.js

Para obtener más información, consulta ladocumentación de referencia de la API Node.js de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

PHP

Para obtener más información, consulta ladocumentación de referencia de la API PHP de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Python

Para obtener más información, consulta ladocumentación de referencia de la API Python de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Ruby

Para obtener más información, consulta ladocumentación de referencia de la API Ruby de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

APIs REST

API JSON

  1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
  2. Usa cURL para llamar a la API JSONcon una solicitud de GET contenedor:
    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
    Donde BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.
    La respuesta tiene este aspecto:
    {
    "name": "my-bucket",
    "projectNumber": "234...",
    ...
    "rpo": "ASYNC_TURBO"
    }
    Fíjate en la tecla rpo. El valor ASYNC_TURBO indica que la replicación turbo está habilitada. DEFAULT indica que se aplica la replicación predeterminada. El campo rpo siempre está presente en los segmentos birregionales y multirregionales, pero no en los segmentos de una sola región.

API XML

Esta función no se puede gestionar a través de la API XML. Usa la API JSON.