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 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 no actuales 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 GitHubComentarios

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 GitHubComentarios

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 GitHubComentarios

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 GitHubComentarios

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 GitHubComentarios

// 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 GitHubComentarios

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 GitHubComentarios

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 GitHubComentarios

# 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://storage.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.

Próximos pasos

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