Borra objetos

En esta página, se muestra cómo borrar objetos de tus depósitos 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 un objeto de uno de tus depósitos de Cloud Storage:

Console

1. Abre el navegador de Cloud Storage en Google Cloud Console.
   Abrir el navegador de Cloud Storage

2. En la lista de depósitos, haz clic en el nombre del depósito que contiene el objeto que deseas borrar.

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

3. Navega hasta el objeto, que puede estar en una carpeta.

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

5. Haz clic en el botón Borrar.

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

Nota: Con estos pasos también puedes borrar carpetas. Cuando borras una carpeta, también se borran todos los objetos en ella.

gsutil

Usa el comando gsutil rm:

gsutil rm gs://[BUCKET_NAME]/[OBJECT_NAME]

Donde:

• [BUCKET_NAME] es el nombre del depósito 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 parecerá al siguiente ejemplo:

Operation completed over 1 objects.

Nota: Puedes borrar grupos de objetos que tienen un prefijo común mediante el comodín **. Ten en cuenta que el comodín ** solo borra las versiones no actuales de objetos cuando usas la marca -a en el comando de eliminación.

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 bucket_name, std::string 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

private void DeleteObject(string bucketName, IEnumerable<string> objectNames)
{
    var storage = StorageClient.Create();
    foreach (string objectName in objectNames)
    {
        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

ctx := context.Background()

ctx, cancel := context.WithTimeout(ctx, time.Second*10)
defer cancel()
o := client.Bucket(bucket).Object(object)
if err := o.Delete(ctx); err != nil {
	return err
}

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.
 */
// const bucketName = 'Name of a bucket, e.g. my-bucket';
// const filename = 'File to delete, e.g. file.txt';

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

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

async function deleteFile() {
  // Deletes the file from the bucket
  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.
 * @param array $options
 *
 * @return void
 */
function delete_object($bucketName, $objectName, $options = [])
{
    $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

# bucket_name = "Your Google Cloud Storage bucket name"
# file_name   = "Name of file in Google Cloud Storage to delete"

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}"

API de REST

API de JSON

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias 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]"

   Donde:

   • [OAUTH2_TOKEN] es el nombre del token de acceso que generaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito 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

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias 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]"

   Donde:

   • [OAUTH2_TOKEN] es el nombre del token de acceso que generaste en el paso 1.
   • [BUCKET_NAME] es el nombre del depósito 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.

Pasos siguientes

• 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 depósito.