Nesta página, você encontrará instruções de como excluir buckets do Cloud Storage. Quando você exclui um bucket, os recursos dentro dele também são excluídos, como objetos e pastas gerenciadas.
Se você excluir um bucket com a exclusão reversível ativada, será possível restaurar o bucket ou objetos individuais dele durante o período de retenção especificado na política de exclusão reversível. As pastas gerenciadas não podem ser recuperadas, mesmo que o bucket tenha a exclusão reversível ativada.
Antes de começar
Para ter as permissões necessárias para excluir um bucket do Cloud Storage, peça ao administrador para conceder a você o papel do IAM de Administrador do Storage (roles/storage.admin
) no bucket.
Esse papel predefinido contém as permissões necessárias para excluir um bucket. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
-
storage.buckets.delete
-
storage.buckets.list
- Essa permissão é necessária apenas para excluir buckets usando o console Trusted Cloud .
-
storage.objects.delete
- Essa permissão é necessária somente quando há objetos no bucket que você quer excluir.
-
storage.objects.list
- Essa permissão é necessária apenas para excluir buckets usando o console Trusted Cloud ou a Google Cloud CLI.
Essas permissões também podem ser concedidas com outros papéis personalizados ou papéis predefinidos.
Para instruções sobre como conceder papéis a buckets, consulte Usar o IAM com buckets.
Excluir um bucket
Console
- No console Trusted Cloud , acesse a página Buckets do Cloud Storage.
Marque a caixa de seleção do bucket que pretende excluir.
Clique em Excluir.
Na janela de sobreposição que aparece, confirme que você quer excluir o bucket e o conteúdo nele.
Clique em Excluir.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console Trusted Cloud , consulte Solução de problemas.
Linha de comando
Para excluir o bucket com todo o conteúdo dele,
use o comando da Google Cloud CLI gcloud storage rm
com
a flag --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/...
Para evitar a exclusão acidental de objetos ou pastas gerenciadas,
use o comando gcloud storage buckets delete
, que só exclui um
bucket se ele estiver vazio.
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
C#
Saiba mais na documentação de referência C# da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Go
Saiba mais na documentação de referência Go da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Java
Saiba mais na documentação de referência Java da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Node.js
Saiba mais na documentação de referência Node.js da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
PHP
Saiba mais na documentação de referência PHP da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Python
Saiba mais na documentação de referência Python da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Ruby
Saiba mais na documentação de referência Ruby da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
APIs REST
API JSON
Ter CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com uma solicitação de bucketDELETE
:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME"
Em que
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
Ter CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API XML com uma solicitaçãoDELETE
bucket:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME"
Em que
BUCKET_NAME
é o nome do bucket a ser excluído. Por exemplo,my-bucket
.
A seguir
- Crie um bucket.
- Mova ou renomeie um bucket.
- Listar objetos em um bucket.
- Exclua um objeto.
- Restaure um bucket excluído de maneira reversível.