Supprimer des buckets

Cette page explique comment supprimer des buckets Cloud Storage. Pour obtenir une présentation des buckets, consultez la page Termes clés.

Important : Une fois le bucket supprimé, tout le monde peut réutiliser son nom pour en créer un autre.

Prérequis

Les conditions préalables peuvent varier en fonction de l'outil utilisé :

Console

Pour suivre ce guide à l'aide de Google Cloud Console, vous devez disposer des autorisations IAM appropriées. Si le bucket auquel vous souhaitez accéder existe dans un projet que vous n'avez pas créé, vous devrez peut-être demander au propriétaire du projet qu'il vous attribue un rôle contenant les autorisations nécessaires.

Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour Google Cloud Console.

Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.

Command line

Pour suivre ce guide à l'aide d'un utilitaire de ligne de commande, vous devez disposer des autorisations IAM appropriées. Si le bucket auquel vous souhaitez accéder existe dans un projet que vous n'avez pas créé, vous devrez peut-être demander au propriétaire du projet qu'il vous attribue un rôle contenant les autorisations nécessaires.

Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les commandes gsutil.

Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.

Exemples de code

Pour suivre ce guide à l'aide des bibliothèques clientes Cloud Storage, vous devez disposer des autorisations IAM appropriées. Si le bucket auquel vous souhaitez accéder existe dans un projet que vous n'avez pas créé, vous devrez peut-être demander au propriétaire du projet qu'il vous attribue un rôle contenant les autorisations nécessaires. Sauf indication contraire, les requêtes de bibliothèque cliente sont effectuées via l'API JSON.

Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les méthodes JSON.

Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.

API REST

API JSON

Pour suivre ce guide à l'aide de l'API JSON, vous devez disposer des autorisations IAM appropriées. Si le bucket auquel vous souhaitez accéder existe dans un projet que vous n'avez pas créé, vous devrez peut-être demander au propriétaire du projet qu'il vous attribue un rôle contenant les autorisations nécessaires.

Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les méthodes JSON.

Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.

Supprimer un bucket

Console

Avertissement : La suppression d'un bucket entraîne également celle des objets qui y sont stockés. Ces objets ne peuvent pas être récupérés. Pour en savoir plus sur les outils qui empêchent de supprimer les données par inadvertance, consultez la section Options de contrôle du cycle de vie des données.

1. Dans Google Cloud Console, accédez à la page du Navigateur Cloud Storage.
   

   Accéder à la page du navigateur

2. Cochez la case correspondant au bucket que vous souhaitez supprimer.

3. Cliquez sur Supprimer.

4. Dans la fenêtre qui apparaît en superposition, confirmez que vous souhaitez supprimer le bucket et son contenu.

5. Cliquez sur Supprimer.

Remarque : Si vous avez un grand nombre d'objets dans vos buckets, l'opération de suppression peut prendre plus de temps que d'habitude.

Pour savoir comment obtenir des informations d'erreur détaillées sur les opérations ayant échoué dans le navigateur Cloud Storage, consultez la page Dépannage.

Command line

gcloud

Aperçu

Ce produit ou cette fonctionnalité sont couverts par les Conditions des offres de pré-disponibilité des conditions d'utilisation de Google Cloud. Les produits et fonctionnalités proposés avant la mise à disposition générale peuvent ne pas être compatibles. De plus, les modifications apportées aux produits et aux fonctionnalités qui étaient proposés avant la mise à disposition générale peuvent ne pas être compatibles avec d'autres versions qui étaient proposées avant la mise à disposition générale. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Avertissement : La commande suivante supprime également tous les objets stockés dans le bucket. Ces objets ne peuvent pas être récupérés. Pour éviter de supprimer des objets par inadvertance, n'utilisez pas l'option --recursive dans la commande. Lorsque vous excluez l'option, la commande ne supprime un bucket que s'il est vide.

Exécutez la commande Google Cloud CLI gcloud alpha storage rm avec l'option --recursive :

gcloud alpha storage rm --recursive gs://BUCKET_NAME/

où BUCKET_NAME correspond au nom du bucket à supprimer. Exemple :my-bucket

Si l'opération réussit, la réponse se présente comme suit :

Removing gs://my-bucket/...

Remarque : Si vous devez supprimer un grand nombre d'objets dans vos buckets, évitez d'utiliser gcloud, car l'opération prend beaucoup de temps. Utilisez plutôt Cloud Console ou la fonctionnalité de gestion du cycle de vie des objets. Pour en savoir plus, consultez la page Options de contrôle du cycle de vie des données.

gsutil

Avertissement : La commande suivante supprime également tous les objets stockés dans le bucket. Ces objets ne peuvent pas être récupérés. Pour éviter de supprimer des objets par inadvertance, exécutez la commande gsutil rb, qui ne supprime un bucket que s'il est vide.

Exécutez la commande gsutil rm avec l'option -r :

gsutil rm -r gs://BUCKET_NAME

où BUCKET_NAME correspond au nom du bucket à supprimer. Exemple :my-bucket

Si l'opération réussit, la réponse se présente comme suit :

Removing gs://my-bucket/...

Remarque : Si vous devez supprimer un grand nombre d'objets dans vos buckets, évitez d'utiliser gsutil, car l'opération prend beaucoup de temps. Utilisez plutôt Cloud Console ou la fonctionnalité de gestion du cycle de vie des objets. Pour en savoir plus, consultez la page Options de contrôle du cycle de vie des données.

Exemples de code

C++

Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.

Afficher sur GitHub Commentaires

namespace gcs = ::google::cloud::storage;
[](gcs::Client client, std::string const& bucket_name) {
  google::cloud::Status status = client.DeleteBucket(bucket_name);

  if (!status.ok()) throw std::runtime_error(status.message());
  std::cout << "The bucket " << bucket_name << " was deleted successfully.\n";
}

C#

Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.

Afficher sur GitHub Commentaires

using Google.Cloud.Storage.V1;
using System;

public class DeleteBucketSample
{
    public void DeleteBucket(string bucketName = "your-unique-bucket-name")
    {
        var storage = StorageClient.Create();
        storage.DeleteBucket(bucketName);
        Console.WriteLine($"The bucket {bucketName} was deleted.");
    }
}

Go

Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.

Afficher sur GitHub Commentaires

import (
	"context"
	"fmt"
	"io"
	"time"

	"cloud.google.com/go/storage"
)

// deleteBucket deletes the bucket.
func deleteBucket(w io.Writer, bucketName string) error {
	// bucketName := "bucket-name"
	ctx := context.Background()
	client, err := storage.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("storage.NewClient: %v", err)
	}
	defer client.Close()

	ctx, cancel := context.WithTimeout(ctx, time.Second*10)
	defer cancel()

	bucket := client.Bucket(bucketName)
	if err := bucket.Delete(ctx); err != nil {
		return fmt.Errorf("Bucket(%q).Delete: %v", bucketName, err)
	}
	fmt.Fprintf(w, "Bucket %v deleted\n", bucketName)
	return nil
}

Java

Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.

Afficher sur GitHub Commentaires

import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class DeleteBucket {
  public static void deleteBucket(String projectId, String bucketName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of the bucket to delete
    // String bucketName = "your-unique-bucket-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Bucket bucket = storage.get(bucketName);
    bucket.delete();

    System.out.println("Bucket " + bucket.getName() + " was deleted");
  }
}

Node.js

Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.

Afficher sur GitHub Commentaires

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// The ID of your GCS bucket
// const bucketName = 'your-unique-bucket-name';

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

async function deleteBucket() {
  await storage.bucket(bucketName).delete();
  console.log(`Bucket ${bucketName} deleted`);
}

deleteBucket().catch(console.error);

PHP

Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.

Afficher sur GitHub Commentaires

use Google\Cloud\Storage\StorageClient;

/**
 * Delete a Cloud Storage Bucket.
 *
 * @param string $bucketName The name of your Cloud Storage bucket.
 */
function delete_bucket($bucketName)
{
    // $bucketName = 'my-bucket';

    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $bucket->delete();
    printf('Bucket deleted: %s' . PHP_EOL, $bucket->name());
}

Python

Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.

Afficher sur GitHub Commentaires

from google.cloud import storage

def delete_bucket(bucket_name):
    """Deletes a bucket. The bucket must be empty."""
    # bucket_name = "your-bucket-name"

    storage_client = storage.Client()

    bucket = storage_client.get_bucket(bucket_name)
    bucket.delete()

    print(f"Bucket {bucket.name} deleted")

Ruby

Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.

Afficher sur GitHub Commentaires

def delete_bucket bucket_name:
  # The ID of your GCS bucket
  # bucket_name = "your-unique-bucket-name"

  require "google/cloud/storage"

  storage = Google::Cloud::Storage.new
  bucket  = storage.bucket bucket_name, skip_lookup: true

  bucket.delete

  puts "Deleted bucket: #{bucket.name}"
end

API REST

API JSON

Remarque : Pour que vous puissiez supprimer le bucket, celui-ci doit être vide.

1. Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth. Pour obtenir des instructions, consultez la page Authentification des API.

2. Exécutez cURL pour appeler l'API JSON avec une requête de bucket DELETE :

   curl -X DELETE -H "Authorization: Bearer OAUTH2_TOKEN" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"

   Où :

   • OAUTH2_TOKEN correspond au jeton d'accès que vous avez généré à l'étape 1.
   • BUCKET_NAME correspond au nom du bucket à supprimer. Par exemple, my-bucket.

Si la requête aboutit, la réponse contient un code d'état 204.

API XML

Remarque : Pour que vous puissiez supprimer le bucket, celui-ci doit être vide.

1. Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth. Pour obtenir des instructions, consultez la page Authentification des API.

2. Utilisez cURL pour appeler l'API XML avec une requête de bucket DELETE :

   curl -X DELETE -H "Authorization: Bearer OAUTH2_TOKEN" \
     "https://storage.googleapis.com/BUCKET_NAME"

   Où :

   • OAUTH2_TOKEN correspond au jeton d'accès que vous avez généré à l'étape 1.
   • BUCKET_NAME correspond au nom du bucket à supprimer. Exemple :my-bucket

Étape suivante

• Créez un bucket.
• Déplacez ou renommez un bucket.
• Supprimez un objet.