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 los pasos a continuación para borrar un objeto de uno de tus depósitos de Cloud Storage:

Console

1. Abre el navegador de Cloud Storage en Google Cloud Platform 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.

3. En la pestaña Objetos, dirígete al objeto.

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]

En el que:

• [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 parece 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 archivadas de objetos cuando usas la marca -a en el comando de eliminación.

Ejemplos 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

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

BlobId blobId = BlobId.of(bucketName, blobName);
boolean deleted = storage.delete(blobId);
if (deleted) {
  // the blob was deleted
} else {
  // the blob was not found
}

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

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

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

/**
 * 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';

// Deletes the file from the bucket
await storage
  .bucket(bucketName)
  .file(filename)
  .delete();

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

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

def delete_blob(bucket_name, blob_name):
    """Deletes a blob from the bucket."""
    storage_client = storage.Client()
    bucket = storage_client.get_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

# project_id  = "Your Google Cloud project ID"
# 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 project_id: project_id
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://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/o/[OBJECT_NAME]"

   En el que:

   • [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]"

   En el que:

   • [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.

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