Usar la gestión de versiones de objetos

Descripción general Uso

En esta página se describe cómo habilitar, inhabilitar y comprobar el estado del control de versiones de objetos en un contenedor. Consulta Usar objetos con versiones para saber cómo listar, restaurar y eliminar los objetos que se conservan mediante la gestión de versiones de objetos.

Roles obligatorios

Para obtener los permisos que necesitas para configurar y gestionar el control de versiones de objetos en un segmento, 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 o en el proyecto que lo contiene. Este rol predefinido contiene los permisos necesarios para configurar y gestionar el control de versiones de objetos de un segmento. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

  • storage.buckets.get
  • storage.buckets.update
  • storage.buckets.list
    • Este permiso solo es necesario si tienes previsto usar la Google Cloud consola para seguir las instrucciones de esta página.

También puedes obtener estos permisos con roles personalizados.

Para obtener información sobre cómo conceder roles en los segmentos, consulta Definir y gestionar políticas de gestión de identidades y accesos en segmentos. Para obtener información sobre cómo conceder roles en proyectos, consulta el artículo Gestionar el acceso a proyectos.

Definir la gestión de versiones de objetos en un segmento

Para habilitar o inhabilitar la gestión de versiones de objetos, debes activar o desactivar la función en un segmento. Una vez que se habilita la gestión de versiones de objetos, cada vez que se sustituye o se elimina una versión activa de un objeto, esa versión se convierte en una versión no actual.

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 en el que quiera habilitar o inhabilitar el control de versiones de objetos.

  3. Seleccione la pestaña Protección, situada en la parte superior de la página.

    El estado actual de la gestión de versiones de objetos se encuentra en la sección Gestión de versiones de objetos.

  4. En la sección Control de versiones de objetos, haga clic en el estado actual para cambiarlo.

    Aparecerá el cuadro de diálogo Gestión de versiones de objetos.

    1. Si vas a habilitar el control de versiones de objetos y quieres minimizar los costes de almacenamiento, marca la casilla Añadir reglas de ciclo de vida recomendadas para gestionar los costes de las versiones.

  5. Haz clic en Confirmar.

Línea de comandos

Usa el comando gcloud storage buckets update con la marca adecuada:

gcloud storage buckets update gs://BUCKET_NAME FLAG

Donde:

  • BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.

  • FLAG es --versioning para habilitar el control de versiones de objetos o --no-versioning para inhabilitarlo.

Si la solicitud se hace correctamente, la respuesta será similar a la del siguiente ejemplo:

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

Bibliotecas de cliente

C++

Para obtener más información, consulta la documentació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 gestión de versiones de objetos en un segmento:

namespace gcs = ::google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name