Elimina oggetti

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

Prima di iniziare

Per ottenere le autorizzazioni necessarie per eliminare gli oggetti, chiedi all'amministratore di concederti il ruolo IAM Utente oggetti Storage (roles/storage.objectUser) per il bucket che contiene gli oggetti che vuoi eliminare.

Se prevedi di utilizzare la console Google Cloud per completare le attività in questa pagina, chiedi all'amministratore di concederti il ruolo Amministratore Storage (roles/storage.admin) anziché il ruolo Utente oggetti Storage (roles/storage.objectUser) o il ruolo Visualizzatore (roles/viewer) di base oltre al ruolo Utente oggetti Storage (roles/storage.objectUser).

Questi ruoli contengono le seguenti autorizzazioni, necessarie per eliminare gli oggetti:

storage.objects.delete
storage.objects.list
- Questa autorizzazione è necessaria solo quando si utilizza la console Google Cloud o quando si utilizzano il flag --recursive o i caratteri jolly in Google Cloud CLI.
storage.buckets.list
- Questa autorizzazione è necessaria solo quando si utilizza la console Google Cloud per eseguire le istruzioni in questa pagina.

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

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

Elimina un oggetto

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

Console

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

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

Viene visualizzata la pagina Dettagli bucket con la scheda Oggetti selezionata.
Passa agli oggetti, che potrebbero trovarsi in una cartella.
Fai clic sulla casella di controllo in corrispondenza di ciascun oggetto da eliminare.

Puoi anche fare clic sulla casella di controllo relativa alle cartelle, per eliminare tutti gli oggetti contenuti al suo interno.
Fai clic sul pulsante Elimina.
Fai clic su Elimina nella finestra di dialogo visualizzata.

Se elimini più oggetti contemporaneamente, puoi tenere traccia dell'avanzamento dell'eliminazione facendo clic sull'icona Notifiche nella console Google Cloud. La console Google Cloud può eliminare in blocco fino a diversi milioni di oggetti in background.

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

Riga di comando

Utilizza il comando Google Cloud CLI gcloud storage rm:

gcloud storage rm gs://BUCKET_NAME/OBJECT_NAME

Dove:

BUCKET_NAME è il nome del bucket che contiene 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 al seguente esempio:

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

Librerie client

C++

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

Per eseguire l'autenticazione in 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,
   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 maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.


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

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: %w", 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: %w", err)
	}
	o = o.If(storage.Conditions{GenerationMatch: attrs.Generation})

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

Java

Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.

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

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

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

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

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

Assicurati che gcloud CLI sia installato e inizializzato per generare un token di accesso per l'intestazione Authorization.

In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione Authorization.
Utilizza cURL per chiamare l'API JSON con una richiesta di DELETE:
```
curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
```
Dove:
- BUCKET_NAME è il nome del bucket che contiene 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

Assicurati che gcloud CLI sia installato e inizializzato per generare un token di accesso per l'intestazione Authorization.

In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione Authorization.
Utilizza cURL per chiamare l'API XML con una richiesta DELETE Object:
```
curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
```
Dove:
- BUCKET_NAME è il nome del bucket che contiene 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 più oggetti contemporaneamente

Se vuoi eliminare collettivamente centomila o più oggetti, evita di utilizzare gcloud storage, perché il completamento del processo richiede molto tempo. Prendi in considerazione una delle seguenti opzioni:

La funzionalità Gestione del ciclo di vita degli oggetti può eliminare un numero qualsiasi di oggetti. Per eliminare collettivamente gli oggetti nel bucket utilizzando questa funzionalità, imposta una regola di configurazione del ciclo di vita sul bucket in cui la condizione Age è impostata su 0 giorni e l'azione è impostata su delete. Una volta impostata la regola, Cloud Storage esegue l'eliminazione collettiva in modo asincrono.
La console Google Cloud è un'opzione consigliata anche per eliminare fino a un milione di oggetti. Una volta avviata la richiesta di eliminazione, il processo viene eseguito in background. Per verificare lo stato dell'eliminazione collettiva, fai clic sul pulsante Notifiche () nell'intestazione della console Google Cloud.
Quando usi determinate librerie client o se usi direttamente l'API JSON, puoi eseguire il batch delle richieste di eliminazione per ridurre il numero di connessioni HTTP da effettuare.

Passaggi successivi

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