Elimina bucket

Questa pagina mostra come eliminare i bucket Cloud Storage .

Se elimini un bucket con l'eliminazione temporanea abilitata, puoi ripristinare il bucket o i singoli oggetti dal bucket durante il periodo di conservazione specificato nella policy di eliminazione temporanea. Le cartelle gestite non possono essere recuperate, anche se il bucket ha l'eliminazione temporanea abilitata.

Avviso: una volta eliminato un bucket, chiunque può riutilizzarne il nome per un nuovo bucket e potenzialmente ricevere dati o richieste destinate al bucket originale eliminato. Per scoprire come mitigare questo rischio, consulta Considerazioni sul nome del bucket. Tieni presente che un bucket eliminato temporaneamente non può essere ripristinato se il suo nome viene riutilizzato.

Prima di iniziare

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

Questo ruolo predefinito contiene le autorizzazioni necessarie per eliminare un bucket. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

• storage.buckets.delete
• storage.buckets.list
  • Questa autorizzazione è necessaria solo quando si eliminano i bucket utilizzando la Google Cloud console.
• storage.objects.delete
  • Questa autorizzazione è necessaria solo se esistono oggetti nel bucket che vuoi eliminare.
• storage.objects.list
  • Questa autorizzazione è necessaria solo per eliminare i bucket utilizzando la Google Cloud console 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 Impostare e gestire le policy IAM sui bucket.

Eliminare un bucket

Console

Quando elimini un bucket utilizzando la Google Cloud console, vengono eliminate anche le risorse all'interno del bucket, come oggetti, cartelle gestite e cache create con Rapid Cache.

1. Nella Google Cloud console, 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 di voler eliminare il bucket e i relativi contenuti.

5. Fai clic su Elimina.

Nota: se hai un numero elevato di oggetti nei bucket, 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 Google Cloud console, consulta Risoluzione dei problemi.

Riga di comando

Per eliminare il bucket, insieme a tutti i contenuti al suo interno, 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.

In caso di 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 bucket, evita di utilizzare Google Cloud CLI, perché l'operazione richiede molto tempo. In alternativa, utilizza una delle seguenti opzioni:

• Utilizza la Google Cloud console.
• Crea un job di operazioni batch di archiviazione.
• Configura la gestione del ciclo di vita degli oggetti.

Per saperne di più sulla protezione dei dati dall'eliminazione accidentale, consulta Opzioni per il controllo dei cicli 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 saperne di più, consulta la documentazione di riferimento dell'APIC++ di Cloud Storage.

Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

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 saperne di più, consulta la documentazione di riferimento dell'C# API di Cloud Storage.

Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

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 saperne di più, consulta la documentazione di riferimento dell' API Go di Cloud Storage.

Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

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 saperne di più, consulta la documentazione di riferimento dell'API Java Cloud Storage.

Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

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 saperne di più, consulta la documentazione di riferimento dell'Node.js API di Cloud Storage.

Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

/**
 * 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 saperne di più, consulta la documentazione di riferimento dell'API PHP Cloud Storage.

Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

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 saperne di più, consulta la documentazione di riferimento dell' API Python di Cloud Storage.

Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

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 saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Ruby .

Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

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. Assicurati che gcloud CLI sia installato e inizializzato, in modo da poter generare un token di accesso per l'intestazione Authorization.

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

   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 da eliminare. Ad esempio, my-bucket.

In caso di 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 poterlo eliminare.

1. Assicurati che gcloud CLI sia installato e inizializzato, in modo da poter generare un token di accesso per l'intestazione Authorization.

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

   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.
• Ripristina un bucket eliminato temporaneamente.