Borra objetos

En esta página, se muestra cómo borrar objetos de tus buckets en Cloud Storage. Para obtener una descripción general de los objetos, consulta los Términos clave.

Advertencia: La eliminación de objetos no se puede deshacer. Cloud Storage está diseñado para proporcionar a los desarrolladores una gran flexibilidad y control sobre sus datos. Google realiza controles estrictos sobre el procesamiento y la eliminación permanente de los datos borrados. Para protegerte de errores, consulta Borra las recomendaciones de datos .

Sigue estos pasos para borrar objetos de uno de tus buckets de Cloud Storage:

Console

1. En Google Cloud Console, ve a la página Navegador de Cloud Storage.
   

   Ir al navegador

2. En la lista de buckets, haz clic en el nombre del bucket que contiene el objeto que deseas borrar.

   Se abrirá la página Detalles del bucket y se seleccionará la pestaña Objetos.

3. Navega hasta los objetos, que pueden estar en una carpeta.

4. Haz clic en la casilla de verificación de cada objeto que deseas borrar.

   También puedes hacer clic en la casilla de verificación de las carpetas , lo que borrarán todos los objetos que contiene esa carpeta.

5. Haz clic en el botón Borrar.

6. Haz clic en Borrar en el diálogo que aparece.

Si borras muchos objetos a la vez, puedes realizar un seguimiento del progreso de eliminación. Para ello, haz clic en el ícono Notificaciones en Cloud Console.

Para aprender a obtener información detallada sobre errores en las operaciones fallidas en el navegador de Cloud Storage, consulta Solución de problemas.

gsutil

Usa el comando gsutil rm:

gsutil rm gs://BUCKET_NAME/OBJECT_NAME

En el ejemplo anterior, se ilustra lo siguiente:

• BUCKET_NAME es el nombre del bucket que contiene el objeto que deseas borrar. Por ejemplo, my-bucket.
• OBJECT_NAME es el nombre del objeto que deseas borrar. Por ejemplo, pets/dog.png.

Si es correcto, la respuesta se parece al siguiente ejemplo:

Operation completed over 1 objects.

Nota: Puedes borrar grupos de objetos que tienen el mismo prefijo, como los objetos cuyos nombres imitan una estructura de carpeta, mediante el siguiente comando: Marca -r. Por ejemplo: gsutil rm -r gs://my-bucket/dir/

Muestras de código

C++

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.

Ver en GitHub Comentarios

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#

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.

Ver en GitHub Comentarios

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

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.

Ver en GitHub Comentarios

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)
	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

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.

Ver en GitHub Comentarios

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();
    storage.delete(bucketName, objectName);

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

Node.js

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.

Ver en GitHub Comentarios

/**
 * 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();

async function deleteFile() {
  await storage.bucket(bucketName).file(fileName).delete();

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

deleteFile().catch(console.error);

PHP

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.

Ver en GitHub Comentarios

use Google\Cloud\Storage\StorageClient;

/**
 * Delete an object.
 *
 * @param string $bucketName The name of your Cloud Storage bucket.
 * @param string $objectName The name of your Cloud Storage object.
 */
function delete_object($bucketName, $objectName)
{
    // $bucketName = 'my-bucket';
    // $objectName = 'my-object';

    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $object = $bucket->object($objectName);
    $object->delete();
    printf('Deleted gs://%s/%s' . PHP_EOL, $bucketName, $objectName);
}

Python

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.

Ver en GitHub Comentarios

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)
    blob.delete()

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

Ruby

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.

Ver en GitHub Comentarios

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
  file    = bucket.file file_name

  file.delete

  puts "Deleted #{file.name}"
end

API de REST

API de JSON

Nota: Cada solicitud de eliminación enviada a la API de JSON puede contener solo un objeto para borrar.

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.

2. Usa cURL para llamar a la API de JSON con una solicitud DELETE:

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

   En el ejemplo anterior, se ilustra lo siguiente:

   • OAUTH2_TOKEN es el nombre del token de acceso que generaste en el paso 1.
   • BUCKET_NAME es el nombre del bucket que contiene el objeto que deseas borrar. Por ejemplo, my-bucket.
   • OBJECT_NAME es el nombre del objeto que deseas borrar. Por ejemplo, pets/dog.png.

API de XML

Nota: Cada solicitud de eliminación enviada a la API de XML puede contener solo un objeto para borrar.

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus credenciales de OAuth.

2. Usa cURL para llamar a la API de XML con una solicitud DELETE Object:

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

   En el ejemplo anterior, se ilustra lo siguiente:

   • OAUTH2_TOKEN es el nombre del token de acceso que generaste en el paso 1.
   • BUCKET_NAME es el nombre del bucket que contiene el objeto que deseas borrar. Por ejemplo, my-bucket.
   • OBJECT_NAME es el nombre del objeto que deseas borrar. Por ejemplo, pets/dog.png.

¿Qué sigue?

• Obtén información sobre el control de versiones de objetos.
• Obtén información sobre Administración del ciclo de vida de los objetos.
• Borra un bucket.