Esta página mostra-lhe como eliminar objetos dos seus contentores no Cloud Storage.
Funções necessárias
Para receber as autorizações de que precisa para eliminar objetos, peça ao seu administrador
para lhe conceder a função do IAM de utilizador de objetos de armazenamento (roles/storage.objectUser
)
para o contentor que contém os objetos que quer
eliminar.
Se planeia usar a Trusted Cloud consola para concluir as tarefas nesta página, peça ao seu administrador que lhe conceda a função de administrador de armazenamento (roles/storage.admin
) em vez da função de utilizador de objetos de armazenamento (roles/storage.objectUser
) ou a função básica de leitor (roles/viewer
) além da função de utilizador de objetos de armazenamento (roles/storage.objectUser
).
Estas funções contêm as autorizações necessárias para eliminar objetos. Para ver as autorizações exatas necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
storage.objects.delete
storage.objects.list
- Esta autorização só é necessária quando usa a consola Trusted Cloud ou quando usa a flag
--recursive
ou carateres universais na CLI Google Cloud.
- Esta autorização só é necessária quando usa a consola Trusted Cloud ou quando usa a flag
storage.buckets.list
- Esta autorização só é necessária quando usa a Trusted Cloud consola para seguir as instruções nesta página.
Também pode obter estas autorizações com outras funções predefinidas ou funções personalizadas.
Para ver informações sobre a concessão de funções em contentores, consulte o artigo Use o IAM com contentores.
Elimine um objeto
Conclua os passos seguintes para eliminar objetos de um dos seus contentores do Cloud Storage:
Consola
- Na Trusted Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor que contém os objetos que quer eliminar.
É aberta a página Detalhes do contentor, com o separador Objetos selecionado.
Navegue para os objetos, que podem estar localizados numa pasta.
Clique na caixa de verificação de cada objeto que quer eliminar.
Também pode clicar na caixa de verificação das pastas, o que elimina todos os objetos contidos nessa pasta.
Clique no botão Eliminar.
Clique em Eliminar na caixa de diálogo apresentada.
Se eliminar muitos objetos de uma vez, pode acompanhar o progresso da eliminação clicando no ícone Notificações na Trusted Cloud consola. A consola pode eliminar em massa até vários milhões de objetos e faz isso em segundo plano.Trusted Cloud
Para saber como obter informações detalhadas sobre erros relativos a operações do Cloud Storage falhadas na Trusted Cloud consola, consulte a secção Resolução de problemas.
Linha de comandos
Use o comando da CLI do Google Cloud gcloud storage rm
:
gcloud storage rm gs://BUCKET_NAME/OBJECT_NAME
Onde:
BUCKET_NAME
é o nome do contentor que contém o objeto que quer eliminar. Por exemplo,my-bucket
.OBJECT_NAME
é o nome do objeto que quer eliminar. Por exemplo,pets/dog.png
.
Se for bem-sucedido, a resposta é semelhante ao seguinte exemplo:
Removing objects: Removing gs://example-bucket/file.txt... Completed 1/1
Bibliotecas cliente
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.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
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.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
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.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
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.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
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.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
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.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
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.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
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.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com um pedidoDELETE
:curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Onde:
BUCKET_NAME
é o nome do contentor que contém o objeto que quer eliminar. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto que quer eliminar. Por exemplo,pets/dog.png
, URL codificado comopets%2Fdog.png
.
API XML
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API XML com um pedidoDELETE Object
:curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME"
Onde:
BUCKET_NAME
é o nome do contentor que contém o objeto que quer eliminar. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto que quer eliminar. Por exemplo,pets/dog.png
, URL codificado comopets%2Fdog.png
.
Elimine objetos em massa
Se quiser eliminar em massa cem mil ou mais objetos, evite usar gcloud storage
, uma vez que o processo demora muito tempo a ser concluído.
Em alternativa, considere uma das seguintes opções:
A funcionalidade Gestão do ciclo de vida de objetos pode eliminar qualquer número de objetos. Para eliminar objetos em massa no seu contentor através desta funcionalidade, defina uma regra de configuração do ciclo de vida no seu contentor em que a condição tem
Age
definido como 0 dias e a ação está definida comodelete
. Depois de definir a regra, o Cloud Storage executa a eliminação em massa de forma assíncrona.A Trusted Cloud consola também é uma opção recomendada quando elimina até um milhão de objetos. Depois de iniciar um pedido de eliminação deste tipo, o processo ocorre em segundo plano. Pode verificar o estado da eliminação em massa clicando no botão Notificações (notifications) no cabeçalho da consola Trusted Cloud .
Quando usa determinadas bibliotecas cliente ou a API JSON diretamente, pode agrupar os seus pedidos de eliminação para reduzir o número de ligações HTTP que tem de fazer.
O que se segue?
- Saiba mais sobre a funcionalidade de controlo de versões de objetos.
- Saiba mais sobre a funcionalidade de gestão do ciclo de vida de objetos.
- Saiba como eliminar um contentor.