Utiliser des buckets soumis à suppression réversible

Présentation de la fonctionnalité de suppression réversible

Cette page explique comment lister et restaurer un bucket supprimé de manière réversible.

Présentation

Une fois qu'un bucket est supprimé de façon réversible, il est conservé par Cloud Storage pendant la durée de conservation de la suppression réversible et ne peut pas être modifié lorsqu'il est dans cet état. À la fin de la durée de conservation de la suppression réversible, Cloud Storage supprime définitivement le bucket et ses objets. Les buckets pour lesquels la fonctionnalité de suppression réversible est activée au moment de la suppression peuvent être restaurés pendant la durée de conservation de la suppression réversible. Lorsque vous restaurez un bucket supprimé de façon réversible, il est rétabli à l'état actif, et les objets qui se trouvaient dans le bucket au moment de la suppression peuvent également être restaurés.

Remarques

  • Pour restaurer un bucket supprimé de façon réversible, vous devez disposer du numéro de génération du bucket. Pour récupérer le numéro de génération d'un bucket supprimé de façon réversible, consultez la section Lister les buckets supprimés de façon réversible.

  • Les opérations de restauration de bucket ne restaurent pas les objets supprimés de façon réversible qui se trouvaient dans le bucket au moment de la suppression. Pour restaurer des objets supprimés de façon réversible après la restauration du bucket supprimé de façon réversible, vous devez effectuer une opération de restauration d'objets.

  • Pour vous protéger contre les suppressions malveillantes, un bucket supprimé de façon réversible ne peut pas être supprimé définitivement tant qu'il n'a pas été conservé pendant toute la durée de conservation de la suppression réversible.

  • Une fois qu'un bucket est supprimé de façon réversible, vous devez le restaurer avant de pouvoir lister ou restaurer les objets supprimés de façon réversible qu'il contient.

  • Un bucket supprimé de façon réversible ne peut être restauré que s'il n'existe pas de bucket actif portant le même nom. Si vous ou une autre personne créez un bucket portant le même nom qu'un bucket supprimé de façon réversible, vous ne pouvez pas le restaurer tant que le nouveau bucket n'est pas supprimé.

  • Vous ne pouvez pas restaurer les buckets supprimés de manière réversible avec l'espace de noms hiérarchique activé.

  • Les liaisons de tags peuvent ne pas être récupérées lorsque vous restaurez un bucket supprimé de façon réversible avec des tags. Pour éviter toute perte de données, lorsque vous restaurez un bucket supprimé de manière réversible avec des liaisons de tags, nous vous recommandons de vérifier que les liaisons de tags du bucket ont été récupérées. Si les liaisons de tags du bucket n'ont pas été récupérées, vous devrez les associer manuellement au bucket.

Autorisations requises

Pour obtenir les autorisations nécessaires pour restaurer des buckets supprimés de manière réversible, demandez à votre administrateur de vous accorder le rôle IAM Administrateur de l'espace de stockage (roles/storage.admin) sur le projet Cloud Storage.

Ce rôle prédéfini contient les autorisations requises pour restaurer des buckets supprimés de manière réversible. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour restaurer des buckets supprimés réversiblement:

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

Lister les buckets supprimés de façon réversible

Vous pouvez effectuer des opérations de liste pour récupérer les métadonnées de vos buckets supprimés de manière temporaire.

Suivez les instructions ci-dessous pour répertorier tous les buckets supprimés de façon réversible de votre projet:

Ligne de commande

Pour répertorier tous les buckets soumis à suppression réversible, exécutez la commande gcloud storage ls:

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

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API JSON avec une requête 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"

Restaurer un bucket soumis à suppression réversible

Suivez les instructions ci-dessous pour restaurer un bucket supprimé de manière temporaire:

Ligne de commande

Pour restaurer un bucket supprimé de façon réversible, utilisez la commande gcloud storage restore:

     gcloud storage restore gs://BUCKET_NAME#GENERATION_NUMBER

Remplacez les éléments suivants :

  • BUCKET_NAME: nom du bac supprimé de manière temporaire que vous souhaitez restaurer.

  • GENERATION_NUMBER: numéro de génération unique et permanent du bucket soumis à suppression réversible que vous souhaitez restaurer. Pour obtenir le numéro de génération de votre bucket, consultez la section Répertorier les buckets supprimés de manière temporaire.

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API JSON avec une requête 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

    Où :

    • BUCKET_NAME correspond au nom du bucket que vous souhaitez restaurer. Exemple :my-bucket

    • GENERATION_NUMBER correspond au numéro de génération unique et permanent du bucket soumis à suppression réversible que vous souhaitez restaurer. Pour obtenir le numéro de génération de votre bucket, consultez la section Répertorier les buckets supprimés de manière temporaire.

Cloud Storage restaure le bucket supprimé de façon réversible en état actif. Notez que la restauration du bucket ne restaure pas les objets qui s'y trouvaient au moment de la suppression réversible. Pour restaurer les objets supprimés de façon réversible qui se trouvaient dans le bucket au moment de la suppression, consultez Restaurer un objet supprimé de façon réversible.

Étape suivante