Usar objetos con versiones

Descripción general Configuración

En esta página se describe cómo enumerar, acceder, restaurar y eliminar objetos no actuales, lo que suele aplicarse a los segmentos en los que la gestión de versiones de objetos está habilitada. Los objetos que no son actuales también se denominan "objetos con versiones".

Antes de empezar

Para trabajar con objetos no actuales, sigue estos pasos.

Habilitar la gestión de versiones de objetos

Si aún no lo ha hecho, habilite el control de versiones de objetos en su contenedor.

Obtener los roles necesarios

Para obtener los permisos que necesitas para gestionar objetos no actuales, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Usuario de objetos de Storage (roles/storage.objectUser) en el proyecto. Este rol predefinido contiene los permisos necesarios para gestionar objetos no actuales. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

  • storage.objects.create
  • storage.objects.delete
  • storage.objects.get
  • storage.objects.list

También puedes obtener estos permisos con roles personalizados.

Para obtener información sobre cómo conceder roles en proyectos, consulta el artículo Gestionar el acceso a proyectos.

En función de tu caso práctico, es posible que necesites permisos adicionales o roles alternativos:

  • Si tienes previsto usar la consola para realizar las tareas de esta página, también necesitarás el permiso storage.buckets.list, que no se incluye en el rol Usuario de objeto de almacenamiento (roles/storage.objectUser). Google Cloud Para obtener este permiso, pide a tu administrador que te conceda el rol Administrador de Storage (roles/storage.admin) en el proyecto.

  • Si el acceso uniforme a nivel de segmento está inhabilitado en tu segmento, necesitarás permisos adicionales en los siguientes casos:

    • Si tiene previsto devolver objetos no actuales junto con sus ACLs, también necesita el permiso storage.objects.getIamPolicy, que no se incluye en el rol Usuario de objeto de almacenamiento (roles/storage.objectUser). Para obtener este permiso, pide al administrador que te asigne el rol Administrador de objetos de Storage (roles/storage.objectAdmin) en el proyecto.

    • Si tienes previsto cambiar el nombre o restaurar objetos no actuales que tengan LCA, también necesitas el permiso storage.objects.setIamPolicy, que no se incluye en el rol de usuario de objetos de Storage (roles/storage.objectUser). Para obtener este permiso, pide al administrador que te asigne el rol Administrador de objetos de Storage (roles/storage.objectAdmin) en el proyecto.

Mostrar versiones de objetos que no están al día

Para enumerar las versiones activas y no actuales de los objetos y ver sus generationnúmeros, sigue estos pasos:

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 contiene el objeto que quieres.

    Se abrirá la página Detalles del segmento, con la pestaña Objetos seleccionada.

  3. Para ver los objetos que no sean actuales, haga clic en el menú desplegable Mostrar y seleccione Objetos activos y no actuales.

  4. En la lista de objetos, haga clic en el nombre del objeto cuyas versiones quiera ver.

    Se abrirá la página Detalles del objeto, con la pestaña Objeto activo seleccionada.

  5. Haga clic en la pestaña Historial de versiones para ver todas las versiones del objeto.

Línea de comandos

Usa el comando gcloud storage ls --all-versions:

gcloud storage ls --all-versions gs://BUCKET_NAME

Donde BUCKET_NAME es el nombre del segmento que contiene los objetos. Por ejemplo, my-bucket.

La respuesta tiene este aspecto:

gs://BUCKET_NAME/OBJECT_NAME1#GENERATION_NUMBER1
gs://BUCKET_NAME/OBJECT_NAME2#GENERATION_NUMBER2
gs://BUCKET_NAME/OBJECT_NAME3#GENERATION_NUMBER3
...

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. 

namespace gcs = ::google::cloud::storage;
[](gcs::Client client, std::string const& bucket_name) {
  for (auto&& object_metadata :
       client.ListObjects(bucket_name, gcs::Versions{true})) {
    if (!object_metadata) throw std::move(object_metadata).status();

    std::cout << "bucket_name=" << object_metadata->bucket()
              << ", object_name=" << object_metadata