Usa buckets borrados de forma no definitiva

Descripción general de la función de borrado de forma no definitiva

En esta página, se describe cómo enumerar y restablecer buckets borrados de forma no definitiva.

Descripción general

Después de que se borra un bucket de forma no definitiva, Cloud Storage lo retiene hasta su hora de eliminación definitiva y no se puede modificar mientras está en ese estado. La hora de borrar de forma definitiva es al menos tan larga como la hora de borrar de forma definitiva más reciente de los objetos del bucket. Una vez que transcurre la hora de eliminación definitiva, Cloud Storage borra el bucket de forma permanente. Cuando restableces un bucket borrado de forma no definitiva, se devuelve a un estado activo y también se pueden restablecer los objetos que estaban en el bucket en el momento de la eliminación.

Consideraciones

  • Para proteger contra la eliminación maliciosa, un bucket borrado de forma no definitiva no se puede borrar de forma permanente hasta que se haya retenido durante todo el período de retención de eliminación no definitiva.

  • Después de que se borra un bucket de forma no definitiva, debes restablecerlo antes de poder enumerar o restablecer los objetos borrados de forma no definitiva que contiene.

  • Para restablecer un bucket borrado de forma no definitiva, debes tener su número de generación. Para recuperar el número de generación de un bucket borrado de forma no definitiva, consulta Cómo enumerar buckets borrados de forma no definitiva.

  • Un bucket borrado de forma no definitiva solo se puede restablecer si no hay un bucket activo con el mismo nombre. Si tú o alguien más crea un bucket con el mismo nombre que un bucket borrado de forma no definitiva, no podrás restablecer el bucket borrado de forma no definitiva hasta que se borre el nuevo.

  • Cuando restableces un bucket borrado de forma no definitiva con la gcloud CLI o la API de JSON, no se restablecen los objetos del bucket. Para restablecer los objetos borrados de forma no definitiva, deberás realizar una operación de restablecimiento de objetos después de restablecer el bucket borrado de forma no definitiva.

  • Es posible que no se recuperen las vinculaciones de etiquetas cuando restableces un bucket borrado de forma no definitiva con etiquetas. Para evitar la pérdida de datos, cuando restableces un bucket borrado de forma no definitiva con vinculaciones de etiquetas, te recomendamos que verifiques que se hayan recuperado las vinculaciones de etiquetas del bucket. Si no se recuperaron las vinculaciones de etiquetas del bucket, deberás vincular manualmente las etiquetas no recuperadas al bucket.

Permisos necesarios

Para obtener los permisos que necesitas para restablecer buckets borrados de forma no definitiva, pídele a tu administrador que te otorgue el rol de IAM de administrador de almacenamiento (roles/storage.admin) en el proyecto de Cloud Storage.

Este rol predefinido contiene los permisos necesarios para restablecer buckets borrados de forma no definitiva. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos requeridos

Se requieren los siguientes permisos para restablecer buckets borrados de forma no definitiva:

  • storage.buckets.list
  • storage.buckets.restore
  • Restablece objetos cuando usas la Google Cloud console para restablecer un bucket borrado de forma no definitiva:
    • storage.objects.restore
    • storage.objects.create

Enumera buckets borrados de forma no definitiva

Puedes realizar operaciones de lista para recuperar los metadatos de tus buckets borrados de forma no definitiva.

Usa las siguientes instrucciones para enumerar los buckets borrados de forma no definitiva en tu proyecto:

Console

  1. En la Google Cloud console, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. Haz clic en Ver opciones.

  3. Selecciona Solo buckets borrados de forma no definitiva.

  4. Haz clic en Guardar.

    Se muestra una lista de buckets borrados de forma no definitiva. Si un bucket borrado de forma no definitiva tiene varias generaciones, cada generación del bucket aparece en una fila separada.

Línea de comandos

Para enumerar buckets borrados de forma no definitiva, usa el gcloud storage ls comando:

gcloud storage ls --buckets --soft-deleted --full

API de REST

API de JSON

  1. Tener gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una GET solicitud de bucket:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b?softDeleted=true"

Restablece un bucket borrado de forma no definitiva

Usa las siguientes instrucciones para restablecer un bucket borrado de forma no definitiva.

Cuando restableces un bucket borrado de forma no definitiva con la Google Cloud console, también puedes restablecer los objetos borrados de forma no definitiva que estaban en el bucket.

Console

  1. En la Google Cloud console, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. Muestra los buckets borrados de forma no definitiva en la lista de buckets, si aún no aparecen. Para conocer los pasos, consulta Cómo enumerar buckets borrados de forma no definitiva.

  3. En la fila del bucket que deseas restablecer, haz clic en Restablecer.

  4. Si el bucket tiene varias generaciones, en la pestaña Especificar generación del bucket, selecciona la generación que deseas restablecer.

  5. Haz clic en la pestaña Especificar los objetos que se deben restablecer.

  6. En la sección Especificar los objetos que se deben restablecer, selecciona si deseas restablecer los objetos borrados de forma no definitiva que estaban en el bucket. Las siguientes opciones están disponibles:

    • No restablecer objetos.

      Puedes restablecer los objetos borrados de forma no definitiva más adelante si es necesario.

    • Restablecer todos los objetos.

    • Restablecer objetos que coincidan con los criterios. Puedes hacer lo siguiente:

      1. Selecciona el intervalo de tiempo desde el que deseas restablecer los objetos.

      2. Opcional: Para restablecer solo los objetos que coincidan con un patrón glob, selecciona Filtrar por patrón glob y, luego, ingresa un patrón glob.

  7. Opcional: Especifica comportamientos de restablecimiento adicionales en la sección Opciones adicionales.

  8. Haz clic en Restablecer.

    Cloud Storage restablece el bucket borrado de forma no definitiva a un estado activo.

    Si restableces los objetos del bucket, Cloud Storage crea una operación de restablecimiento masivo para los objetos. La operación se realiza de forma asíncrona y puede tardar una hora o más en comenzar. Para realizar un seguimiento del progreso de la operación, haz clic en el botón Notificaciones () en el Google Cloud encabezado de laconsole. También puedes usar gcloud CLI para hacer un seguimiento del estado de la operación de larga duración asociada.

Línea de comandos

Para restablecer un bucket borrado de forma no definitiva, usa el gcloud storage restore comando:

  gcloud storage restore gs://BUCKET_NAME#GENERATION_NUMBER

Reemplaza lo siguiente:

  • BUCKET_NAME: Es el nombre del bucket borrado de forma no definitiva que deseas restablecer.

  • GENERATION_NUMBER: Es el número de generación permanente y único del bucket borrado de forma no definitiva que deseas restablecer. Para obtener el número de generación de tu bucket, consulta Cómo enumerar buckets borrados de forma no definitiva.

Cloud Storage restablece el bucket borrado de forma no definitiva a un estado activo. Ten en cuenta que restablecer el bucket no restablece los objetos que estaban en él. Para restablecer los objetos borrados de forma no definitiva, consulta Restablece un objeto borrado de forma no definitiva.

API de REST

API de JSON

  1. Tener gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una POST solicitud de bucket:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/restore?generation=GENERATION_NUMBER

    Aquí:

    • BUCKET_NAME es el nombre del bucket que deseas restablecer. Por ejemplo, my-bucket.

    • GENERATION_NUMBER es el número de generación permanente y único del bucket borrado de forma no definitiva que deseas restablecer. Para obtener el número de generación de tu bucket, consulta Cómo enumerar buckets borrados de forma no definitiva.

    Cloud Storage restablece el bucket borrado de forma no definitiva a un estado activo. Ten en cuenta que restablecer el bucket no restablece los objetos que estaban en él. Para restablecer los objetos borrados de forma no definitiva, consulta Restablece un objeto borrado de forma no definitiva.

¿Qué sigue?