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 un bucket borrado 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 su 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.

  • Una vez 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.

  • Las operaciones de restablecimiento de buckets no restablecen los objetos borrados de forma no definitiva que se encontraban en el bucket en el momento de la eliminación. Para restablecer objetos borrados de forma no definitiva después de que se restablezca el bucket borrado de forma no definitiva, deberás realizar una operación de restablecimiento de objetos.

  • 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 los buckets que se borraron de forma no definitiva:

  • storage.buckets.list
  • storage.buckets.restore

Enumera los buckets borrados de forma no definitiva

Puedes realizar operaciones de lista para recuperar los metadatos de los buckets que borraste de forma lógica.

Sigue estas instrucciones para enumerar todos los buckets borrados de forma no definitiva en tu proyecto:

Línea de comandos

Para enumerar todos 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 temporal:

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.

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 se encontraban en él en el momento de la eliminación no definitiva. Para restablecer los objetos borrados de forma no definitiva que se encontraban en el bucket en el momento de la eliminación, consulta Restablece un objeto borrado de forma no definitiva.

¿Qué sigue?