Borrar buckets

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

Si borras un bucket que tiene habilitada la eliminación no definitiva, puedes restablecer el bucket o los objetos individuales del bucket durante el período de retención especificado en la política de eliminación no definitiva. Las carpetas administradas no se pueden recuperar, incluso si el bucket tiene habilitada la eliminación no definitiva.

Advertencia: Una vez que se borra un bucket, cualquiera puede volver a usar su nombre para un bucket nuevo y, potencialmente, recibir datos o solicitudes destinados al bucket borrado original. Para obtener información sobre cómo mitigar este riesgo, consulta Consideraciones sobre el nombre del bucket. Ten en cuenta que no se puede restablecer un bucket borrado de forma no definitiva si se vuelve a usar su nombre.

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 Google Cloud consola.
• 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 Google Cloud consola 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 Configura y administra políticas de IAM en buckets.

Borrar un bucket

Console

Cuando borras un bucket con la Google Cloud consola, también se borran los recursos dentro del bucket, como objetos, carpetas administradas y memorias caché creadas con Rapid Cache.

1. En la Google Cloud consola, 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 sobre cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la Google Cloud consola, consulta Solución de problemas.

Línea de comandos

Para borrar el bucket, junto con todo el contenido que contiene, usa el comando Google Cloud CLI gcloud storage rm 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 una de las siguientes opciones:

• Usa la Google Cloud consola.
• Crea un trabajo de operaciones por lotes de almacenamiento.
• Configura la administración del ciclo de vida de los objetos.

Para obtener más información sobre cómo proteger tus datos de la eliminación accidental, 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 de 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 de 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 de 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 de 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 de 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 de 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 de 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. Ten 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 DELETE solicitud de bucket:

   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. Ten 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 DELETE solicitud de bucket:

   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.