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 durante el período de retención de eliminación no definitiva y no se puede modificar mientras esté en ese estado. Después de que finaliza el período de retención de la función borrar de forma no definitiva, Cloud Storage borra de forma permanente el bucket y sus objetos. Los buckets con la función de eliminación no definitiva habilitada en el momento de la eliminación se pueden restablecer dentro de su período de retención de eliminación no definitiva. Cuando restableces un bucket borrado de forma no definitiva, se vuelve a un estado activo, y los objetos que estaban en el bucket en el momento de la eliminación también se pueden restablecer.

Consideraciones

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

  • Las operaciones de restablecimiento de buckets no restablecen los objetos borrados de forma no definitiva que estaban 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.

  • Para protegerte 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 un bucket se borra de forma no definitiva, debes restablecerlo antes de poder enumerar o restablecer los objetos borrados de forma no definitiva que contiene.

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

  • No puedes restablecer buckets borrados de forma no definitiva con el espacio de nombres jerárquico habilitado.

  • Es posible que no se recuperen las vinculaciones de etiquetas cuando restablezcas un bucket borrado de forma no definitiva con etiquetas. Para evitar la pérdida de datos, cuando restablezcas un bucket borrado de forma no definitiva con vinculaciones de etiquetas, te recomendamos que te asegures de 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 necesarios

Se requieren los siguientes permisos para restablecer buckets con eliminación no definitiva:

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

Muestra una lista de los buckets borrados de forma no definitiva

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

Usa las siguientes instrucciones para enumerar todos los buckets borrados de forma diferida 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 bucket GET:

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 con eliminación diferida:

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 temporal 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 con eliminación diferida.

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 bucket POST:

    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 Cómo enumerar buckets con eliminación diferida.

Cloud Storage restablece el bucket borrado de forma no definitiva a un estado activo. Ten en cuenta que, si restableces el bucket, no se restablecerán los objetos que estaban en el bucket en el momento de la eliminación no definitiva. Para restablecer los objetos borrados de forma no definitiva que estaban en el bucket en el momento de la eliminación, consulta Cómo restablecer un objeto borrado de forma no definitiva.

¿Qué sigue?