Buckets löschen

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

Warnung: Durch das Löschen eines Buckets werden auch verwaltete Ordner im Bucket gelöscht, die nicht wiederhergestellt werden können, sowie Objekte im Bucket, die nur wiederhergestellt werden, wenn für den Bucket vorläufiges Löschen aktiviert ist und die Aufbewahrungsdauer des Buckets für vorläufiges Löschen nicht überschritten ist. Sobald jedoch ein Bucket gelöscht wurde, kann jeder den Bucket-Namen für einen neuen Bucket verwenden. Wenn eine andere Person den Namen verwendet, können Sie den Bucket nicht wiederherstellen, da sein Name nicht mehr zur Verfügung steht.

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 Objekten 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 der Bucket verwaltete Ordner enthält, können Sie den Bucket zusammen mit allen darin enthaltenen verwalteten Ordnern und Objekten löschen. Verwenden Sie dazu den Google Cloud CLI-Befehl gcloud alpha storage rm mit dem Flag --recursive:

  gcloud alpha 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 in den Befehlen nicht das Flag --recursive. Wenn Sie das Flag ausschließen, löschen die Befehle nur, wenn der Bucket leer ist.

Hinweis: Wenn Sie eine große Anzahl von Objekten in Ihren Buckets löschen müssen, sollten Sie gcloud 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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.

   Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header Authorization einfügen.

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.

   Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header Authorization einfügen.

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