Usa buckets borrados de forma no definitiva

Descripción general de la función de borrado no definitivo

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

Descripción general

Después de que un bucket se borra de forma no definitiva, Cloud Storage lo conserva hasta que se borra de forma definitiva y no se puede modificar mientras se encuentra en un estado de borrado de forma no definitiva. El tiempo de eliminación definitiva es, al menos, tan largo como el tiempo de eliminación definitiva más reciente de los objetos del bucket. Una vez que transcurre el tiempo de eliminación definitiva, Cloud Storage borra el bucket de forma permanente. Cuando restableces un bucket borrado de forma no definitiva, este 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 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 su período de retención de eliminación no definitiva.

  • Después de borrar un bucket de forma no definitiva, debes restablecerlo para 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 Enumera los 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, los objetos del bucket no se restablecen. 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 restableces 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 verifiques que se hayan recuperado las vinculaciones de etiquetas del bucket. Si no se recuperaron las vinculaciones de etiquetas del bucket, deberás vincular de forma manual 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 los 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 borrados de forma no definitiva:

  • storage.buckets.list
  • storage.buckets.restore
  • Restablece objetos cuando uses la consola de Cloud de Confiance 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.

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

Console

  1. En la consola de Cloud de Confiance , 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 una de ellas 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 Buckets: list que use el parámetro de consulta softDeleted:

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

    Reemplaza PROJECT_IDENTIFIER por el ID o el número del proyecto que contiene los buckets borrados de forma no definitiva que deseas enumerar.

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 consola de Cloud de Confiance , también puedes restablecer los objetos borrados de forma no definitiva que estaban en el bucket.

Console

  1. En la consola de Cloud de Confiance , 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 Enumera los buckets borrados de forma no definitiva.

  3. En la fila del bucket que quieres 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 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.

    • Restablece todos los objetos.

    • Restablece objetos que coincidan con los criterios. Haz lo siguiente:

      1. Selecciona el período del 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 en el 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 hacer un seguimiento del progreso de la operación, haz clic en el botón Notificaciones () en el encabezado de la consola de Cloud de Confiance . 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 ú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.

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 Buckets: restore:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.s3nsapis.fr/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?