Nesta página, você aprenderá como excluir objetos em buckets do Cloud Storage.
Funções exigidas
Para receber as permissões necessárias para excluir objetos, peça ao administrador
que conceda a você o papel do IAM de usuário de objetos do Storage (roles/storage.objectUser
)
para o bucket que contém os objetos que você quer
excluir.
Se você planeja usar o Trusted Cloud console para concluir as tarefas desta
página, peça ao administrador para conceder a você o papel Administrador do Storage
(roles/storage.admin
) em vez do papel de Usuário do objeto do Storage
(roles/storage.objectUser
) ou o papel básico de Leitor (roles/viewer
), além do papel de Usuário do objeto do Storage (roles/storage.objectUser
).
Esses papéis contêm as permissões necessárias para excluir objetos. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.objects.delete
storage.objects.list
- Essa permissão só é necessária ao usar o console Trusted Cloud ou
ao usar a flag
--recursive
ou caracteres curinga na Google Cloud CLI.
- Essa permissão só é necessária ao usar o console Trusted Cloud ou
ao usar a flag
storage.buckets.list
- Essa permissão só é necessária ao usar o console Trusted Cloud para executar as instruções desta página.
Também é possível conseguir essas permissões com outros papéis predefinidos ou personalizados.
Para informações sobre como conceder papéis nos buckets, consulte Usar o IAM com buckets.
Excluir um objeto
Conclua as etapas a seguir para excluir objetos a partir de um dos buckets do Cloud Storage:
Console
- No console Trusted Cloud , acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome daquele que contém os objetos que você quer excluir.
A página Detalhes do bucket é aberta, com a guia Objetos selecionada.
Navegue até o objeto, que pode estar localizado em uma pasta.
Clique na caixa de seleção de cada objeto que você quer excluir.
Também é possível clicar na caixa de seleção das pastas, o que excluirá todos os objetos contidos nessa pasta.
Clique no botão Excluir.
Clique em Excluir na caixa de diálogo exibida.
Se você excluir muitos objetos de uma vez, poderá acompanhar o progresso da exclusão clicando no ícone Notificações no console do Trusted Cloud . O consoleTrusted Cloud pode excluir em massa até vários milhões de objetos e faz isso em segundo plano.
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
Use o comando gcloud storage rm
da Google Cloud CLI:
gcloud storage rm gs://BUCKET_NAME/OBJECT_NAME
Em que:
BUCKET_NAME
é o nome do bucket que contém o objeto que você quer excluir. Por exemplo,my-bucket
.OBJECT_NAME
é o nome do objeto que você quer excluir. Por exemplo,pets/dog.png
.
Se a operação for bem-sucedida, a resposta será semelhante a esta:
Removing objects: Removing gs://example-bucket/file.txt... Completed 1/1
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çãoDELETE
:curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Em que:
BUCKET_NAME
é o nome do bucket que contém o objeto que você quer excluir. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto que você quer excluir. Por exemplo,pets/dog.png
, codificado por URL comopets%2Fdog.png
.
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 Object
:curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME"
Em que:
BUCKET_NAME
é o nome do bucket que contém o objeto que você quer excluir. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto que você quer excluir. Por exemplo,pets/dog.png
, codificado por URL comopets%2Fdog.png
.
Excluir objetos em massa
Para excluir cem mil ou mais objetos em massa, evite usar
gcloud storage
, já que o processo leva muito tempo para ser concluído.
Em vez disso, considere uma das seguintes opções:
O recurso Gerenciamento do ciclo de vida de objetos pode excluir qualquer quantidade de objetos. Para excluir objetos em massa no seu bucket usando esse recurso, defina uma regra de configuração de ciclo de vida no bucket em que a condição tenha
Age
definido como 0 dias e a ação esteja definida comodelete
. Depois de definir a regra, o Cloud Storage realiza a exclusão em massa de forma assíncrona.O console Trusted Cloud também é uma opção recomendada ao excluir até um milhão de objetos. Depois de iniciar essa solicitação de exclusão, o processo ocorre em segundo plano. Para verificar o status da exclusão em massa, clique no botão Notificações (notifications) no cabeçalho do console Trusted Cloud .
Ao usar determinadas bibliotecas de cliente ou a API JSON diretamente, é possível agrupar em lote suas solicitações de exclusão para reduzir o número de conexões HTTP necessárias.
A seguir
- Saiba mais sobre o recurso de controle de versões de objetos.
- Conheça o recurso Gerenciamento do ciclo de vida de objetos.
- Veja como excluir um bucket.