Buckets löschen

Auf dieser Seite wird gezeigt, wie Sie Cloud Storage-Buckets löschen.

Warnung: Durch das Löschen eines Buckets werden auch alle verwalteten Ordner im Bucket gelöscht. Diese können nicht wiederhergestellt werden. Wenn für den Bucket das vorläufige Löschen aktiviert ist, können Sie den Bucket oder einzelne Objekte aus dem Bucket innerhalb der in der Richtlinie für vorläufiges Löschen angegebenen Aufbewahrungsdauer wiederherstellen. Nachdem ein Bucket vorläufig gelöscht wurde, kann jeder den Bucketnamen für einen neuen Bucket verwenden. Wenn jemand anderes den Namen verwendet, können Sie den Bucket nicht wiederherstellen, da sein Name nicht mehr verwendet werden kann.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Storage-Administrator“ (roles/storage.admin) für den Bucket zuzuweisen, um die erforderlichen Berechtigungen zum Löschen eines Cloud Storage-Buckets zu erhalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Löschen eines Buckets erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

• storage.buckets.delete
• storage.buckets.list
  • Diese Berechtigung ist nur erforderlich, wenn Buckets mit der Google Cloud Console gelöscht werden.
• storage.objects.delete
  • Diese Berechtigung ist nur erforderlich, wenn sich in dem Bucket, den Sie löschen möchten, Objekte befinden.
• storage.objects.list
  • Diese Berechtigung ist nur erforderlich, um Buckets mithilfe der Google Cloud Console oder der Google Cloud CLI zu löschen.

Sie können diese Berechtigungen auch mit anderen benutzerdefinierten Rollen oder vordefinierten Rollen erhalten.

Eine Anleitung zum Zuweisen von Rollen für Buckets finden Sie unter IAM mit Buckets verwenden.

Buckets löschen

Console

1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
   

   Buckets aufrufen

2. Klicken Sie das Kästchen neben dem Bucket, der gelöscht werden soll, an.

3. Klicken Sie auf Löschen.

4. Bestätigen Sie im eingeblendeten Fenster, dass Sie diesen Bucket und seinen Inhalt löschen möchten.

5. Klicken Sie auf Löschen.

Hinweis: Wenn sich in Ihren Buckets eine große Anzahl an Objekten befindet, kann der Löschvorgang etwas länger als gewöhnlich dauern.

Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.

Befehlszeile

Um den Bucket zusammen mit allen Inhalten im Bucket zu löschen, verwenden Sie den Befehl Google Cloud CLI gcloud storage rm mit dem Flag --recursive:

gcloud storage rm --recursive gs://BUCKET_NAME

Dabei ist BUCKET_NAME der Name des zu löschenden Buckets. Beispiel: my-bucket.

Wenn der Vorgang erfolgreich ausgeführt wurde, sieht die Antwort in etwa so aus:

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

Wenn Sie vermeiden möchten, dass Objekte oder verwaltete Ordner versehentlich gelöscht werden, verwenden Sie den Befehl gcloud storage buckets delete. Damit wird ein Bucket nur gelöscht, wenn er leer ist.

Hinweis: Wenn Sie eine große Anzahl von Objekten in Ihren Buckets löschen müssen, sollten Sie die Google Cloud CLI nicht verwenden, da der Vorgang lange dauert. Verwenden Sie stattdessen die Google Cloud Console oder das Feature Verwaltung des Objektlebenszyklus. Weitere Informationen finden Sie unter Optionen zum Steuern von Datenlebenszyklen.

Clientbibliotheken

Hinweis: Wenn Sie Clientbibliotheken verwenden, muss Ihr Bucket leer sein, bevor Sie ihn löschen können. Einige Clientbibliotheken wie die Python-Clientbibliothek bieten ein Flag oder eine Funktion zum erzwungenen Löschen.

C++

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

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#

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

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: %w", err)
	}
	defer client.Close()

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

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

Java

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

/**
 * 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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

use Google\Cloud\Storage\StorageClient;

/**
 * Delete a Cloud Storage Bucket.
 *
 * @param string $bucketName The name of your Cloud Storage bucket.
 *        (e.g. 'my-bucket')
 */
function delete_bucket(string $bucketName): void
{
    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $bucket->delete();
    printf('Bucket deleted: %s' . PHP_EOL, $bucket->name());
}

Python

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

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

REST APIs

JSON API

Hinweis: Wenn Sie die JSON API verwenden, muss Ihr Bucket leer sein, bevor Sie ihn löschen können.

1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header Authorization zu generieren.

2. Verwenden Sie cURL, um die JSON API mit einer DELETE-Bucket-Anfrage aufzurufen:

   curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"

   Dabei ist BUCKET_NAME der Name des zu löschenden Buckets. Beispiel: my-bucket.

Bei Erfolg enthält die Antwort den Statuscode 204.

XML API

Hinweis: Wenn Sie die XML API verwenden, muss Ihr Bucket leer sein, bevor Sie ihn löschen können.

1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header Authorization zu generieren.

2. Verwenden Sie cURL, um die XML API mit einer DELETE-Bucket-Anfrage aufzurufen:

   curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.googleapis.com/BUCKET_NAME"

   Dabei ist BUCKET_NAME der Name des zu löschenden Buckets. Beispiel: my-bucket.

Nächste Schritte

• Bucket erstellen
• Buckets verschieben und umbenennen
• Objekte in einem Bucket auflisten.
• Objekt löschen
• Vorläufig gelöschten Bucket wiederherstellen