Borrar buckets

En esta página, se muestra cómo borrar buckets de Cloud Storage.

Advertencia: Si borras un bucket también se borran las carpetas administradas dentro del bucket, que no se pueden recuperar. Si el bucket tiene habilitada la eliminación no definitiva, puedes restablecer el bucket o objetos individuales del bucket durante el período de retención especificado en la política de eliminación no definitiva. Una vez que se borra un bucket de forma no definitiva, cualquier persona puede usar el nombre del bucket para uno nuevo. Si otra persona usa el nombre, no podrás restablecer el bucket porque su nombre ya no está disponible para su uso.

Antes de comenzar

Para obtener los permisos necesarios para borrar un bucket de Cloud Storage, pídele a tu administrador que te otorgue el rol de IAM de administrador de almacenamiento (roles/storage.admin) en el bucket.

Este rol predefinido contiene los permisos necesarios para borrar un bucket. Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:

Permisos necesarios

• storage.buckets.delete
• storage.buckets.list
  • Este permiso solo es necesario cuando se borran buckets mediante la consola de Google Cloud.
• storage.objects.delete
  • Este permiso solo es necesario si los objetos existen dentro del bucket que deseas borrar.
• storage.objects.list
  • Este permiso solo es necesario para borrar buckets mediante la consola de Google Cloud o Google Cloud CLI.

También puedes obtener estos permisos con otros roles personalizados o roles predefinidos.

Para obtener instrucciones para otorgar roles a los buckets, consulta Usa IAM con buckets.

Borrar un bucket

Console

1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. Selecciona la casilla de verificación del bucket que desees borrar.

3. Haz clic en Borrar.

4. En la ventana de superposición que aparece, confirma que deseas borrar el bucket y su contenido.

5. Haz clic en Borrar.

Nota: Si tienes una gran cantidad de objetos en tus buckets, la operación de eliminación puede tomar más tiempo de lo normal en completarse.

Para obtener información acerca de cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la consola de Google Cloud, consulta Solución de problemas.

Línea de comandos

Para borrar el bucket, junto con todo su contenido, usa el comando gcloud storage rm de Google Cloud CLI con la marca --recursive:

gcloud storage rm --recursive gs://BUCKET_NAME

En el que BUCKET_NAME es el nombre del bucket que se borrará. Por ejemplo, my-bucket

Si se ejecuta de forma correcta, la respuesta se parece al siguiente ejemplo:

Removing gs://my-bucket/...

Si quieres evitar la eliminación accidental de objetos o carpetas administradas, usa el comando gcloud storage buckets delete, que solo borra un bucket si está vacío.

Nota: Si tienes que borrar una gran cantidad de objetos en tus buckets, evita usar Google Cloud CLI, ya que la operación tarda mucho tiempo en completarse. En su lugar, usa la consola de Google Cloud o la función de Administración del ciclo de vida de los objetos. Si deseas obtener más información, consulta Opciones para controlar los ciclos de vida de los datos.

Bibliotecas cliente

Nota: Cuando usas bibliotecas cliente, tu bucket debe estar vacío antes de que puedas borrarlo. Algunas bibliotecas cliente, como la biblioteca cliente de Python, proporcionan una función o marca de eliminación forzada.

C++

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

namespace gcs = ::google::cloud::storage;
[](gcs::Client client, std::string const& bucket_name) {
  google::cloud::Status status = client.DeleteBucket(bucket_name);
  if (!status.ok()) throw std::runtime_error(status.message());

  std::cout << "The bucket " << bucket_name << " was deleted successfully.\n";
}

C#

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

using Google.Cloud.Storage.V1;
using System;

public class DeleteBucketSample
{
    public void DeleteBucket(string bucketName = "your-unique-bucket-name")
    {
        var storage = StorageClient.Create();
        storage.DeleteBucket(bucketName);
        Console.WriteLine($"The bucket {bucketName} was deleted.");
    }
}

Go

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

import (
	"context"
	"fmt"
	"io"
	"time"

	"cloud.google.com/go/storage"
)

// deleteBucket deletes the bucket.
func deleteBucket(w io.Writer, bucketName string) error {
	// bucketName := "bucket-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*30)
	defer cancel()

	bucket := client.Bucket(bucketName)
	if err := bucket.Delete(ctx); err != nil {
		return fmt.Errorf("Bucket(%q).Delete: %w", bucketName, err)
	}
	fmt.Fprintf(w, "Bucket %v deleted\n", bucketName)
	return nil
}

Java

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class DeleteBucket {
  public static void deleteBucket(String projectId, String bucketName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of the bucket to delete
    // String bucketName = "your-unique-bucket-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Bucket bucket = storage.get(bucketName);
    bucket.delete();

    System.out.println("Bucket " + bucket.getName() + " was deleted");
  }
}

Node.js

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// The ID of your GCS bucket
// const bucketName = 'your-unique-bucket-name';

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

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

async function deleteBucket() {
  await storage.bucket(bucketName).delete();
  console.log(`Bucket ${bucketName} deleted`);
}

deleteBucket().catch(console.error);

PHP

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

use Google\Cloud\Storage\StorageClient;

/**
 * Delete a Cloud Storage Bucket.
 *
 * @param string $bucketName The name of your Cloud Storage bucket.
 *        (e.g. 'my-bucket')
 */
function delete_bucket(string $bucketName): void
{
    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $bucket->delete();
    printf('Bucket deleted: %s' . PHP_EOL, $bucket->name());
}

Python

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

from google.cloud import storage


def delete_bucket(bucket_name):
    """Deletes a bucket. The bucket must be empty."""
    # bucket_name = "your-bucket-name"

    storage_client = storage.Client()

    bucket = storage_client.get_bucket(bucket_name)
    bucket.delete()

    print(f"Bucket {bucket.name} deleted")

Ruby

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

def delete_bucket bucket_name:
  # The ID of your GCS bucket
  # bucket_name = "your-unique-bucket-name"

  require "google/cloud/storage"

  storage = Google::Cloud::Storage.new
  bucket  = storage.bucket bucket_name, skip_lookup: true

  bucket.delete

  puts "Deleted bucket: #{bucket.name}"
end

API de REST

API de JSON

Nota: Cuando uses la API de JSON, tu bucket debe estar vacío antes de que puedas borrarlo.

1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

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

   curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"

   En el que BUCKET_NAME es el nombre del bucket que se borrará. Por ejemplo, my-bucket.

Si no hay errores, la respuesta contendrá un código de estado 204.

API de XML

Nota: Cuando uses la API de XML, tu bucket debe estar vacío antes de que puedas borrarlo.

1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

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

   curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.googleapis.com/BUCKET_NAME"

   En el que BUCKET_NAME es el nombre del bucket que se borrará. Por ejemplo, my-bucket.

¿Qué sigue?

• Crea un depósito.
• Mueve o cambia el nombre de un depósito.
• Hacer una lista de objetos de un bucket.
• Borra un objeto.
• Restablece un bucket borrado de forma no definitiva.