Elimina oggetti

Questa pagina mostra come eliminare gli oggetti dai bucket in Cloud Storage.

Avviso :l'eliminazione dell'oggetto non può essere annullata. Cloud Storage è progettato per offrire agli sviluppatori un'elevata flessibilità e controllo sui propri dati, mentre Google mantiene controlli rigorosi sul trattamento e sull'eliminazione definitiva dei dati eliminati. Per proteggerti dagli errori, consulta Opzioni per il controllo dei cicli di vita dei dati.

Autorizzazioni obbligatorie

Console

Per completare questa guida utilizzando la console Google Cloud, devi disporre delle autorizzazioni IAM appropriate. Se l'oggetto che vuoi eliminare esiste in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo contenente le autorizzazioni necessarie.

Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta Autorizzazioni IAM per la console Google Cloud.

Per un elenco dei ruoli pertinenti, consulta Ruoli Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.

Riga di comando

Per completare questa guida utilizzando un'utilità a riga di comando, devi disporre delle autorizzazioni IAM appropriate. Se l'oggetto che vuoi eliminare esiste in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo contenente le autorizzazioni necessarie.

Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta Autorizzazioni IAM per i comandi gsutil.

Per un elenco dei ruoli pertinenti, consulta Ruoli Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.

Librerie client

Per completare questa guida utilizzando le librerie client di Cloud Storage, devi disporre delle autorizzazioni IAM appropriate. Se l'oggetto che vuoi eliminare esiste in un progetto che non hai creato, potrebbe essere necessario che il proprietario del progetto ti assegni un ruolo contenente le autorizzazioni necessarie.

Se non diversamente specificato, le richieste della libreria client vengono effettuate tramite l'API JSON e richiedono le autorizzazioni elencate nelle autorizzazioni IAM per i metodi JSON. Per vedere quali metodi dell'API JSON vengono richiamati quando effettui richieste utilizzando una libreria client, registra le richieste non elaborate.

Per un elenco di ruoli IAM pertinenti, consulta i ruoli Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.

API REST

API JSON

Per completare questa guida utilizzando l'API JSON, devi disporre delle autorizzazioni IAM appropriate. Se l'oggetto che vuoi eliminare esiste in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo contenente le autorizzazioni necessarie.

Per un elenco delle autorizzazioni necessarie per azioni specifiche, consulta la pagina relativa alle autorizzazioni IAM per i metodi JSON.

Per un elenco dei ruoli pertinenti, consulta Ruoli Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.

Elimina un oggetto

Nota: l'eliminazione dei dati può comportare addebiti per recupero ed eliminazione anticipata se i dati erano stati archiviati in origine come spazio di archiviazione Nearline, Coldline Storage o Archive. Inoltre, tieni presente che se hai abilitato il controllo delle versioni degli oggetti per il tuo bucket, l'oggetto originale rimane nel bucket finché non viene eliminato esplicitamente tramite il relativo numero di generazione.

Completa i seguenti passaggi per eliminare gli oggetti da uno dei bucket Cloud Storage:

Console

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

   Vai a Bucket

2. Nell'elenco dei bucket, fai clic sul nome del bucket che contiene gli oggetti da eliminare.

   Si apre la pagina Dettagli bucket in cui è selezionata la scheda Oggetti.

3. Vai agli oggetti, che potrebbero trovarsi in una cartella.

4. Fai clic sulla casella di controllo in corrispondenza di ogni oggetto da eliminare.

   Puoi anche fare clic sulla casella di controllo delle cartelle, per eliminare tutti gli oggetti contenuti in quella cartella.

5. Fai clic sul pulsante Elimina.

6. Fai clic su Elimina nella finestra di dialogo visualizzata.

Se elimini più oggetti contemporaneamente, puoi monitorare l'avanzamento dell'eliminazione facendo clic sull'icona Notifiche nella console Google Cloud. La console Google Cloud può eliminare collettivamente fino a diversi milioni di oggetti e lo fa in background.

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

Riga di comando

gcloud

Utilizza il comando Google Cloud CLI gcloud storage rm:

gcloud storage rm gs://BUCKET_NAME/OBJECT_NAME

Dove:

• BUCKET_NAME è il nome del bucket contenente l'oggetto che vuoi eliminare. Ad esempio, my-bucket.
• OBJECT_NAME è il nome dell'oggetto che vuoi eliminare. Ad esempio, pets/dog.png.

In caso di esito positivo, la risposta è simile all'esempio seguente:

Removing objects:
Removing gs://example-bucket/file.txt...
Completed 1/1

Nota: puoi eliminare gruppi di oggetti con lo stesso prefisso, ad esempio oggetti i cui nomi imitino una struttura di cartelle, utilizzando il flag --recursive. Ad esempio: gcloud storage rm --recursive gs://my-bucket/dir/

gsutil

Utilizza il comando gsutil rm:

gsutil rm gs://BUCKET_NAME/OBJECT_NAME

Dove:

• BUCKET_NAME è il nome del bucket contenente l'oggetto che vuoi eliminare. Ad esempio, my-bucket.
• OBJECT_NAME è il nome dell'oggetto che vuoi eliminare. Ad esempio, pets/dog.png.

In caso di esito positivo, la risposta è simile all'esempio seguente:

Operation completed over 1 objects.

Nota: puoi eliminare gruppi di oggetti con lo stesso prefisso, ad esempio oggetti i cui nomi imitino una struttura di cartelle, utilizzando il flag -r. Ad esempio: gsutil rm -r gs://my-bucket/dir/

Librerie client

C++

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

Visualizza su GitHub Feedback

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

  if (!status.ok()) throw std::runtime_error(status.message());
  std::cout << "Deleted " << object_name << " in bucket " << bucket_name
            << "\n";
}

C#

Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage C#.

Visualizza su GitHub Feedback

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

public class DeleteFileSample
{
    public void DeleteFile(
        string bucketName = "your-unique-bucket-name",
        string objectName = "your-object-name")
    {
        var storage = StorageClient.Create();
        storage.DeleteObject(bucketName, objectName);
        Console.WriteLine($"Deleted {objectName}.");
    }
}

Go

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

Visualizza su GitHub Feedback

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

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

// deleteFile removes specified object.
func deleteFile(w io.Writer, bucket, object string) error {
	// bucket := "bucket-name"
	// object := "object-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()

	o := client.Bucket(bucket).Object(object)

	// Optional: set a generation-match precondition to avoid potential race
	// conditions and data corruptions. The request to delete the file is aborted
	// if the object's generation number does not match your precondition.
	attrs, err := o.Attrs(ctx)
	if err != nil {
		return fmt.Errorf("object.Attrs: %v", err)
	}
	o = o.If(storage.Conditions{GenerationMatch: attrs.Generation})

	if err := o.Delete(ctx); err != nil {
		return fmt.Errorf("Object(%q).Delete: %v", object, err)
	}
	fmt.Fprintf(w, "Blob %v deleted.\n", object)
	return nil
}

Java

Per ulteriori informazioni, consulta la documentazione di riferimento per l'API Cloud Storage Java.

Visualizza su GitHub Feedback

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

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

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    // The ID of your GCS object
    // String objectName = "your-object-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Blob blob = storage.get(bucketName, objectName);
    if (blob == null) {
      System.out.println("The object " + objectName + " wasn't found in " + bucketName);
      return;
    }

    // Optional: set a generation-match precondition to avoid potential race
    // conditions and data corruptions. The request to upload returns a 412 error if
    // the object's generation number does not match your precondition.
    Storage.BlobSourceOption precondition =
        Storage.BlobSourceOption.generationMatch(blob.getGeneration());

    storage.delete(bucketName, objectName, precondition);

    System.out.println("Object " + objectName + " was deleted from " + bucketName);
  }
}

Node.js

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

Visualizza su GitHub Feedback

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

// The ID of your GCS file
// const fileName = 'your-file-name';

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

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

// Optional:
// Set a generation-match precondition to avoid potential race conditions
// and data corruptions. The request to delete is aborted if the object's
// generation number does not match your precondition. For a destination
// object that does not yet exist, set the ifGenerationMatch precondition to 0
// If the destination object already exists in your bucket, set instead a
// generation-match precondition using its generation number.
const deleteOptions = {
  ifGenerationMatch: generationMatchPrecondition,
};
async function deleteFile() {
  await storage.bucket(bucketName).file(fileName).delete(deleteOptions);

  console.log(`gs://${bucketName}/${fileName} deleted`);
}

deleteFile().catch(console.error);

PHP

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

Visualizza su GitHub Feedback

use Google\Cloud\Storage\StorageClient;

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

Python

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

Visualizza su GitHub Feedback

from google.cloud import storage

def delete_blob(bucket_name, blob_name):
    """Deletes a blob from the bucket."""
    # bucket_name = "your-bucket-name"
    # blob_name = "your-object-name"

    storage_client = storage.Client()

    bucket = storage_client.bucket(bucket_name)
    blob = bucket.blob(blob_name)
    generation_match_precondition = None

    # Optional: set a generation-match precondition to avoid potential race conditions
    # and data corruptions. The request to delete is aborted if the object's
    # generation number does not match your precondition.
    blob.reload()  # Fetch blob metadata to use in generation_match_precondition.
    generation_match_precondition = blob.generation

    blob.delete(if_generation_match=generation_match_precondition)

    print(f"Blob {blob_name} deleted.")

Ruby

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

Visualizza su GitHub Feedback

def delete_file bucket_name:, file_name:
  # The ID of your GCS bucket
  # bucket_name = "your-unique-bucket-name"

  # The ID of your GCS object
  # file_name = "your-file-name"

  require "google/cloud/storage"

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

  file.delete

  puts "Deleted #{file.name}"
end

API REST

API JSON

Nota: ogni richiesta di eliminazione inviata all'API JSON può contenere un solo oggetto da eliminare.

1. Richiedi un token di accesso all'autorizzazione da Playground OAuth 2.0. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta Autenticazione API.

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

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

   Dove:

   • OAUTH2_TOKEN è il nome del token di accesso che hai generato nel passaggio 1.
   • BUCKET_NAME è il nome del bucket contenente l'oggetto che vuoi eliminare. Ad esempio: my-bucket.
   • OBJECT_NAME è il nome con codifica URL dell'oggetto che vuoi eliminare. Ad esempio, pets/dog.png, con codifica URL come pets%2Fdog.png.

API XML

Nota: ogni richiesta di eliminazione inviata all'API XML può contenere un singolo oggetto da eliminare.

1. Richiedi un token di accesso all'autorizzazione da Playground OAuth 2.0. Configura il parco giochi in modo che utilizzi le tue credenziali OAuth. Per le istruzioni, consulta Autenticazione API.

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

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

   Dove:

   • OAUTH2_TOKEN è il nome del token di accesso che hai generato nel passaggio 1.
   • BUCKET_NAME è il nome del bucket contenente l'oggetto che vuoi eliminare. Ad esempio: my-bucket.
   • OBJECT_NAME è il nome con codifica URL dell'oggetto che vuoi eliminare. Ad esempio, pets/dog.png, con codifica URL come pets%2Fdog.png.

Eliminare collettivamente gli oggetti

• Se vuoi eliminare collettivamente centinaia o più oggetti, evita di utilizzare gcloud storage o gsutil, poiché il processo richiede molto tempo. Utilizza invece la console Google Cloud, che può eliminare fino a diversi milioni di oggetti, o la Gestione del ciclo di vita degli oggetti, che può eliminare un numero qualsiasi di oggetti.

  • Per eliminare collettivamente gli oggetti nel bucket utilizzando la Gestione del ciclo di vita degli oggetti, imposta una regola di configurazione del ciclo di vita nel bucket in cui la condizione ha Age impostato su 0 giorni e l'azione è impostata su delete.

• Quando utilizzi determinate librerie client o direttamente con l'API JSON, puoi raggruppare le richieste di eliminazione per ridurre il numero di connessioni HTTP necessarie.

Passaggi successivi

• Scopri di più sulla funzionalità di controllo delle versioni degli oggetti.
• Scopri di più sulla funzionalità Gestione del ciclo di vita degli oggetti.
• Scopri come eliminare un bucket.