Elimine contentores

Esta página mostra-lhe como eliminar contentores do Cloud Storage. Quando elimina um contentor, os recursos no contentor também são eliminados, como objetos e pastas geridas.

Se eliminar um contentor com a eliminação temporária ativada, pode restaurar o contentor ou objetos individuais do contentor durante o período de retenção especificado na política de eliminação temporária. Não é possível recuperar pastas geridas, mesmo que a eliminação reversível esteja ativada no contentor.

Aviso: depois de um contentor ser eliminado, qualquer pessoa pode reutilizar o nome do contentor para um novo contentor e, potencialmente, receber dados ou pedidos destinados ao contentor original eliminado. Para saber como mitigar este risco, consulte Considerações sobre o nome do contentor. Tenha em atenção que não é possível restaurar um contentor eliminado temporariamente se o respetivo nome for reutilizado.

Antes de começar

Para receber as autorizações necessárias para eliminar um contentor do Cloud Storage, peça ao seu administrador para lhe conceder a função de administrador do armazenamento (roles/storage.admin) do IAM no contentor.

Esta função predefinida contém as autorizações necessárias para eliminar um contentor. Para ver as autorizações exatas necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

• storage.buckets.delete
• storage.buckets.list
  • Esta autorização só é necessária quando elimina contentores através da Google Cloud consola.
• storage.objects.delete
  • Esta autorização só é necessária se existirem objetos no contentor que quer eliminar.
• storage.objects.list
  • Esta autorização só é necessária para eliminar contentores através da consola Google Cloud ou da Google Cloud CLI.

Também pode conseguir estas autorizações com outras funções personalizadas ou funções predefinidas.

Para obter instruções sobre como conceder funções para contentores, consulte o artigo Use o IAM com contentores.

Elimine um contentor

Consola

1. Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
   

   Aceda a Recipientes

2. Selecione a caixa de verificação do contentor que quer eliminar.

3. Clique em Eliminar.

4. Na janela de sobreposição apresentada, confirme que quer eliminar o contentor e o respetivo conteúdo.

5. Clique em Eliminar.

Nota: se tiver um grande número de objetos nos seus contentores, a operação de eliminação pode demorar mais tempo do que o habitual a ser concluída.

Para saber como obter informações detalhadas sobre erros relativos a operações do Cloud Storage falhadas na Google Cloud consola, consulte a secção Resolução de problemas.

Linha de comandos

Para eliminar o contentor, juntamente com todos os conteúdos no contentor, use o comando Google Cloud CLI gcloud storage rm com a flag --recursive:

gcloud storage rm --recursive gs://BUCKET_NAME

Em que BUCKET_NAME é o nome do contentor a eliminar. Por exemplo, my-bucket.

Se for bem-sucedido, a resposta é semelhante ao exemplo seguinte:

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

Se quiser evitar a eliminação acidental de objetos ou pastas geridas, use o comando gcloud storage buckets delete, que só elimina um contentor se este estiver vazio.

Nota: se precisar de eliminar um grande número de objetos nos seus contentores, evite usar a Google Cloud CLI, uma vez que a operação demora muito tempo a ser concluída. Em alternativa, use uma das seguintes opções:

• Use a Google Cloud consola.
• Crie uma tarefa de operações em lote de armazenamento.
• Configure a gestão do ciclo de vida de objetos.

Para mais informações sobre como proteger os seus dados contra a eliminação acidental, consulte as Opções para controlar os ciclos de vida dos dados.

Bibliotecas cliente

Nota: quando usa bibliotecas de cliente, o seu contentor tem de estar vazio antes de o poder eliminar. Algumas bibliotecas cliente, como a biblioteca cliente Python, oferecem uma função ou uma flag de eliminação forçada.

C++

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

Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de 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#

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

Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de 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

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

Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de 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

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

Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de 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

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

Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de 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

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

Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de 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

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

Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de 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

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

Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de 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

APIs REST

API JSON

Nota: quando usa a API JSON, o seu contentor tem de estar vazio antes de o poder eliminar.

1. Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho Authorization.

2. Use cURL para chamar a API JSON com um pedido de DELETE contentor:

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

   Onde BUCKET_NAME é o nome do contentor que quer eliminar. Por exemplo, my-bucket.

Se for bem-sucedido, a resposta contém um código de estado 204.

API XML

Nota: quando usa a API XML, o seu contentor tem de estar vazio antes de o poder eliminar.

1. Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho Authorization.

2. Use cURL para chamar a API XML com um pedido de DELETE contentor:

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

   Onde BUCKET_NAME é o nome do contentor que quer eliminar. Por exemplo, my-bucket.

O que se segue?

• Crie um contentor.
• Mova ou mude o nome de um contentor.
• Listar objetos num contentor.
• Elimine um objeto.
• Restaure um contentor eliminado temporariamente.