Use contentores eliminados temporariamente

Vista geral da funcionalidade de eliminação recuperável

Esta página descreve como listar e restaurar um contentor eliminado temporariamente.

Vista geral

Depois de um contentor ser eliminado temporariamente, é retido pelo Cloud Storage até à hora de eliminação definitiva e não pode ser modificado enquanto estiver num estado de eliminação temporária. O tempo de eliminação definitiva é, pelo menos, tão longo quanto o tempo de eliminação definitiva mais recente dos objetos do contentor. Após o tempo de eliminação definitiva, o Cloud Storage elimina permanentemente o contentor. Quando restaura um contentor eliminado temporariamente, este é reposto num estado ativo, e os objetos que estavam no contentor no momento da eliminação também podem ser restaurados.

Considerações

  • Para se proteger contra a eliminação maliciosa, não é possível eliminar permanentemente um contentor eliminado temporariamente até que o contentor seja retido durante todo o período de retenção de eliminação temporária.

  • Depois de um contentor ser eliminado temporariamente, tem de o restaurar antes de poder listar ou restaurar os objetos eliminados temporariamente no mesmo.

  • Para restaurar um contentor eliminado temporariamente, tem de ter o número de geração do contentor. Para obter o número de geração de um contentor eliminado temporariamente, consulte o artigo Liste contentores eliminados temporariamente.

  • Só é possível restaurar um contentor eliminado temporariamente se não existir um contentor ativo com o mesmo nome. Se você ou outra pessoa criar um contentor com o mesmo nome de um contentor eliminado temporariamente, não pode restaurar o contentor eliminado temporariamente até que o novo contentor seja eliminado.

  • As operações de restauro de contentores não restauram os objetos eliminados temporariamente que estavam no contentor no momento da eliminação. Para restaurar objetos eliminados temporariamente depois de o contentor eliminado temporariamente ter sido restaurado, tem de realizar uma operação de restauro de objetos.

  • As associações de etiquetas podem não ser recuperadas quando restaura um contentor eliminado temporariamente com etiquetas. Para evitar a perda de dados, quando restaura um contentor eliminado temporariamente com associações de etiquetas, recomendamos que verifique se as associações de etiquetas do contentor foram recuperadas. Se as associações de etiquetas do contentor não foram recuperadas, tem de associar manualmente as etiquetas não recuperadas ao contentor.

Autorizações necessárias

Para receber as autorizações de que precisa para restaurar contentores eliminados temporariamente, peça ao seu administrador para lhe conceder a função de IAM Administrador de armazenamento (roles/storage.admin) no projeto do Cloud Storage.

Esta função predefinida contém as autorizações necessárias para restaurar contentores eliminados temporariamente. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para restaurar contentores eliminados temporariamente:

  • storage.buckets.list
  • storage.buckets.restore

Liste os contentores eliminados temporariamente

Pode realizar operações de lista para obter os metadados dos contentores eliminados temporariamente.

Use as instruções seguintes para apresentar uma lista de todos os contentores eliminados temporariamente no seu projeto:

Linha de comandos

Para listar todos os contentores eliminados temporariamente, use o comando gcloud storage ls:

gcloud storage ls --buckets --soft-deleted --full

APIs REST

API JSON

  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 GET contentor:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b?softDeleted=true"

Restaure um contentor eliminado temporariamente

Use as seguintes instruções para restaurar um contentor eliminado temporariamente:

Linha de comandos

Para restaurar um contentor eliminado temporariamente, use o comando gcloud storage restore 

  gcloud storage restore gs://BUCKET_NAME#GENERATION_NUMBER

Substitua o seguinte:

  • BUCKET_NAME: o nome do contentor eliminado temporariamente que quer restaurar.

  • GENERATION_NUMBER: o número de geração permanente e exclusivo do contentor eliminado temporariamente que quer restaurar. Para obter o número de geração do seu contentor, consulte o artigo Liste contentores eliminados temporariamente.

APIs REST

API JSON

  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 POST contentor:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/restore?generation=GENERATION_NUMBER

    Onde:

    • BUCKET_NAME é o nome do contentor que quer restaurar. Por exemplo, my-bucket.

    • GENERATION_NUMBER é o número de geração permanente e exclusivo do contentor eliminado temporariamente que quer restaurar. Para obter o número de geração do seu contentor, consulte o artigo Liste contentores eliminados temporariamente.

O Cloud Storage restaura o contentor eliminado temporariamente para um estado ativo. Tenha em atenção que a restauração do contentor não restaura os objetos que estavam no contentor no momento da eliminação temporária. Para restaurar os objetos eliminados temporariamente que estavam no contentor no momento da eliminação, consulte o artigo Restaure um objeto eliminado temporariamente.

O que se segue?