Usa buckets borrados de forma no definitiva

Descripción general de la función de eliminación 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 el momento de la eliminación definitiva y no se puede modificar mientras se encuentre en el estado de borrado no definitivo. La hora de eliminación definitiva es al menos tan larga como la hora de eliminación definitiva más reciente de los objetos del bucket. Una vez que transcurre el tiempo de borrado definitivo, Cloud Storage borra el bucket de forma permanente. Cuando restableces un bucket borrado de forma no definitiva, este vuelve 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 el número de generación del bucket. 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 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 las vinculaciones de etiquetas no se recuperen cuando restablezcas un bucket borrado de forma no definitiva que tenga etiquetas. Para evitar la pérdida de datos, cuando restaures 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 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 necesarios

Se requieren los siguientes permisos para restablecer buckets que se borraron de forma no definitiva:

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

Enumera los buckets borrados de forma no definitiva

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

Sigue estas instrucciones para enumerar los buckets que se borraron de forma no definitiva en tu proyecto:

Console

  1. En la consola de Google Cloud , 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 los buckets borrados de forma no definitiva. Si un bucket borrado de forma no definitiva tiene varias generaciones, cada generación del bucket aparecerá en una fila separada.

Línea de comandos

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

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

API de REST

API de JSON

  1. Tener la 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 solicitud de GET 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

Sigue estas instrucciones para restablecer un bucket borrado de forma no definitiva.

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

Console

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

    Ir a Buckets

  2. Mostrar los buckets borrados de forma no definitiva en la lista de buckets, si aún no aparecen Para conocer los pasos, consulta Enumera los 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 Especifica la generación del bucket, selecciona la generación que deseas restablecer.

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

  6. En la sección Especifica los objetos que se deben restablecer, selecciona si deseas restablecer los objetos borrados de forma no definitiva que se encontraban 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 Haz lo siguiente:

      1. Selecciona el período 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 Restore.

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

    Si restableces los objetos del bucket, Cloud Storage creará 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 hacer un seguimiento del progreso de la operación, haz clic en el botón Notificaciones () en el encabezado de la consola de Google Cloud . 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 comando gcloud storage restore:

  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 Enumera los 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 la 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 solicitud de POST 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 único y permanente del bucket borrado de forma no definitiva que deseas restablecer. Para obtener el número de generación de tu bucket, consulta Enumera los 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?