Excluir buckets

Nesta página, você encontrará instruções de como excluir buckets do Cloud Storage.

Importante: depois de excluir um bucket, qualquer pessoa poderá reutilizar o nome dele.

Pré-requisitos

Os pré-requisitos podem variar com base na ferramenta usada:

Console

Para concluir este guia usando o Console do Google Cloud, é preciso ter as permissões de IAM adequadas. Se o bucket que você quer acessar existir em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias.

Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para o Console do Google Cloud.

Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.

Linha de comando

Para concluir este guia usando um utilitário de linha de comando, você precisa ter as permissões de IAM adequadas. Se o bucket que você quer acessar existir em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda a você um papel que contenha as permissões necessárias.

Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para comandos gsutil.

Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.

Exemplos de código

Para concluir este guia usando as bibliotecas de cliente do Cloud Storage, é preciso ter as permissões de IAM adequadas. Se o bucket que você quer enviar existir em um projeto criado por outra pessoa, talvez seja necessário que o proprietário do projeto conceda um papel que contenha as permissões necessárias. Salvo indicação em contrário, as solicitações de biblioteca de cliente são feitas por meio da API JSON.

Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para métodos JSON.

Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.

APIs REST

API JSON

Para concluir este guia usando a API JSON, é preciso ter as permissões do IAM adequadas. Se o bucket que você quer acessar para streaming existir em um projeto que você não criou, talvez seja necessário que o proprietário do projeto conceda um papel que contenha as permissões necessárias.

Para uma lista de permissões necessárias para ações específicas, consulte Permissões do IAM para métodos JSON.

Para ver a lista de papéis relevantes, consulte Papéis do Cloud Storage. Como alternativa, é possível criar um papel personalizado que tenha permissões mais limitadas.

Excluir um bucket

Console

Aviso: a exclusão de um bucket também exclui todos os objetos armazenados no bucket. Não é possível recuperar esses objetos. Para ver as ferramentas que impedem a exclusão acidental de dados, consulte Opções para controlar os ciclos de vida dos dados.

1. No Console do Cloud, acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Marque a caixa de seleção do bucket que pretende excluir.

3. Clique em Excluir.

4. Na janela de sobreposição que aparece, confirme que você quer excluir o bucket e o conteúdo nele.

5. Clique em Excluir.

Observação: se houver um grande número de objetos nos buckets, a operação de exclusão poderá levar mais tempo do que o normal para ser concluída.

Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console do Google Cloud, consulte Solução de problemas.

Linha de comando

gcloud

Aviso: o comando a seguir também exclui todos os objetos armazenados no bucket. Não é possível recuperar esses objetos. Para evitar a exclusão acidental de objetos, não use a sinalização --recursive no comando. Quando você exclui a sinalização, o comando só exclui um bucket se ele estiver vazio.

Use o comando gcloud storage rm da Google Cloud CLI com a sinalização --recursive:

gcloud storage rm --recursive gs://BUCKET_NAME/

Em que BUCKET_NAME é o nome do bucket a ser excluído. Por exemplo, my-bucket.

Se funcionar, a resposta será parecida com esta:

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

Observação: se você precisar excluir um grande número de objetos nos buckets, evite usar a gcloud, porque a operação leva muito tempo para ser concluída. Em vez disso, use o console do Google Cloud ou o recurso Gerenciamento do ciclo de vida de objetos. Para mais informações, consulte Opções para controlar os ciclos de vida dos dados.

gsutil

Aviso: o comando a seguir também exclui todos os objetos armazenados no bucket. Não é possível recuperar esses objetos. Para evitar a exclusão acidental de objetos, use o comando gsutil rb, que só exclui um bucket se ele estiver vazio.

Use o comando gsutil rm com a sinalização -r:

gsutil rm -r gs://BUCKET_NAME

Em que BUCKET_NAME é o nome do bucket a ser excluído. Por exemplo, my-bucket.

Se funcionar, a resposta será parecida com esta:

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

Observação: se você precisar excluir um grande número de objetos nos buckets, evite usar gsutil, porque a operação leva muito tempo para ser concluída. Em vez disso, use o console do Google Cloud ou o recurso Gerenciamento do ciclo de vida de objetos. Para mais informações, consulte Opções para controlar os ciclos de vida dos dados.

Amostras de código

C++

Para mais informações, consulte a documentação de referência da API Cloud Storage C++.

Ver no GitHub Feedback

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#

Para mais informações, consulte a documentação de referência da API Cloud Storage C#.

Ver no GitHub Feedback

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

Para mais informações, consulte a documentação de referência da API Cloud Storage Go.

Ver no GitHub Feedback

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: %v", 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: %v", bucketName, err)
	}
	fmt.Fprintf(w, "Bucket %v deleted\n", bucketName)
	return nil
}

Java

Para mais informações, consulte a documentação de referência da API Cloud Storage Java.

Ver no GitHub Feedback

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

Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.

Ver no GitHub Feedback

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

Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.

Ver no GitHub Feedback

use Google\Cloud\Storage\StorageClient;

/**
 * Delete a Cloud Storage Bucket.
 *
 * @param string $bucketName The name of your Cloud Storage bucket.
 */
function delete_bucket($bucketName)
{
    // $bucketName = 'my-bucket';

    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $bucket->delete();
    printf('Bucket deleted: %s' . PHP_EOL, $bucket->name());
}

Python

Para mais informações, consulte a documentação de referência da API Cloud Storage Python.

Ver no GitHub Feedback

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

Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.

Ver no GitHub Feedback

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

APIs REST

API JSON

Observação: o bucket precisa estar vazio antes de ser excluído.

1. Receba um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth. Para ver instruções, consulte Autenticação de APIs.

2. Use cURL para chamar a API JSON com uma solicitação bucket DELETE:

   curl -X DELETE -H "Authorization: Bearer OAUTH2_TOKEN" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"

   Em que:

   • OAUTH2_TOKEN é o token de acesso gerado na Etapa 1.
   • BUCKET_NAME é o nome do bucket a ser excluído. Por exemplo, my-bucket.

Se funcionar, a resposta conterá o código de status 204.

API XML

Observação: o bucket precisa estar vazio antes de ser excluído.

1. Receba um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth. Para ver instruções, consulte Autenticação de APIs.

2. Use cURL para chamar a API XML com uma solicitação DELETE bucket:

   curl -X DELETE -H "Authorization: Bearer OAUTH2_TOKEN" \
     "https://storage.googleapis.com/BUCKET_NAME"

   Em que:

   • OAUTH2_TOKEN é o token de acesso gerado na Etapa 1.
   • BUCKET_NAME é o nome do bucket a ser excluído. Por exemplo, my-bucket.

A seguir

• Crie um bucket.
• Mova ou renomeie um bucket.
• Exclua um objeto.