Eliminare i bucket

Questa pagina mostra come eliminare i bucket di Cloud Storage.

Attenzione: l'eliminazione di un bucket comporta anche l'eliminazione delle cartelle gestite al suo interno, che non possono essere recuperate, e degli oggetti al suo interno, che possono essere recuperati solo se per il bucket è attivata l'eliminazione temporanea e solo entro la durata del periodo di conservazione dell'eliminazione temporanea del bucket. Tuttavia, una volta eliminato un bucket, chiunque può utilizzare il nome del bucket per un nuovo bucket. Se qualcun altro utilizza il nome, non potrai ripristinare il bucket perché il nome non è più disponibile per l'utilizzo.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per eliminare un bucket Cloud Storage, chiedi all'amministratore di concederti il ruolo IAM Amministratore archiviazione (roles/storage.admin) per il bucket.

Questo ruolo predefinito contiene le autorizzazioni necessarie per eliminare un bucket. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

• storage.buckets.delete
• storage.buckets.list
  • Questa autorizzazione è necessaria solo per eliminare i bucket utilizzando la console Google Cloud.
• storage.objects.delete
  • Questa autorizzazione è obbligatoria solo se esistono oggetti nel bucket che vuoi eliminare.
• storage.objects.list
  • Questa autorizzazione è necessaria solo per eliminare i bucket utilizzando la console Google Cloud o Google Cloud CLI.

Potresti anche ottenere queste autorizzazioni con altri ruoli personalizzati o ruoli predefiniti.

Per istruzioni sulla concessione dei ruoli per i bucket, consulta Utilizzare IAM con i bucket.

Eliminare un bucket

Console

1. Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
   

   Vai a Bucket

2. Seleziona la casella di controllo del bucket da eliminare.

3. Fai clic su Elimina.

4. Nella finestra di overlay visualizzata, conferma che desideri eliminare del bucket e dei relativi contenuti.

5. Fai clic su Elimina.

Nota: se i tuoi bucket contengono un numero elevato di oggetti, l'operazione di eliminazione potrebbe richiedere più tempo del solito.

Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud, consulta la sezione Risoluzione dei problemi.

Riga di comando

Per eliminare il bucket e tutti i relativi contenuti, utilizza il comando Google Cloud CLI gcloud storage rm con il flag --recursive:

gcloud storage rm --recursive gs://BUCKET_NAME

Dove BUCKET_NAME è il nome del bucket da eliminare. Ad esempio, my-bucket.

Se l'esito è positivo, la risposta è simile al seguente esempio:

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

Se vuoi evitare di eliminare accidentalmente oggetti o cartelle gestite, utilizza il comando gcloud storage buckets delete, che elimina un bucket solo se è vuoto.

Nota: se devi eliminare un numero elevato di oggetti nei tuoi bucket, evita di utilizzare gcloud, poiché l'operazione richiede molto tempo per essere completata. Utilizza invece la console Google Cloud o funzionalità Gestione del ciclo di vita degli oggetti. Per saperne di più, consulta Opzioni per il controllo del ciclo di vita dei dati.

Librerie client

Nota: quando utilizzi le librerie client, il bucket deve essere vuoto prima di poterlo eliminare. Alcune librerie client, come la libreria client Python, forniscono un flag o una funzione di eliminazione forzata.

C++

Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.

Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.

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#

Per ulteriori informazioni, consulta API Cloud Storage C# documentazione di riferimento.

Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.

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

Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.

Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.

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

Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.

Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.

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

Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.

Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.

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

Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.

Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.

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

Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.

Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.

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

Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.

Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.

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

Nota: quando utilizzi l'API JSON, il bucket deve essere vuoto prima di poterlo eliminare.

1. Avere gcloud CLI installato e inizializzato, che consente generi un token di accesso per l'intestazione Authorization.

2. Utilizza cURL per chiamare l'API JSON con un Richiesta DELETE bucket:

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

   Dove BUCKET_NAME è il nome del bucket eliminare. Ad esempio, my-bucket.

Se l'esito è positivo, la risposta contiene un codice di stato 204.

API XML

Nota: quando utilizzi l'API XML, il bucket deve essere vuoto prima di poter eliminarlo.

1. Avere gcloud CLI installato e inizializzato, che consente generi un token di accesso per l'intestazione Authorization.

2. Utilizza cURL per chiamare l'API XML con una richiesta DELETE Bucket:

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

   Dove BUCKET_NAME è il nome del bucket da eliminare. Ad esempio, my-bucket.

Passaggi successivi

• Crea un bucket.
• Sposta o rinomina un bucket.
• Elenca gli oggetti in un bucket.
• Elimina un oggetto.