Use contentores eliminados temporariamente

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

Esta página descreve como listar e restaurar contentores eliminados 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 restaurá-lo 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.

  • Quando restaura um contentor eliminado temporariamente através da CLI gcloud ou da API JSON, os objetos no contentor não são restaurados. Para restaurar objetos eliminados temporariamente, tem de realizar uma operação de restauro de objetos depois de restaurar o contentor eliminado temporariamente.

  • 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 de 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
  • Restaure objetos quando usar a Cloud de Confiance consola para restaurar um contentor eliminado temporariamente:
    • storage.objects.restore
    • storage.objects.create

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 listar os contentores eliminados temporariamente no seu projeto:

Consola

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

    Aceda a Recipientes

  2. Clique em Opções de visualização.

  3. Selecione Apenas contentores eliminados temporariamente.

  4. Clique em Guardar.

    É apresentada uma lista de contentores eliminados temporariamente. Se um contentor eliminado temporariamente tiver várias gerações, cada geração do contentor aparece numa linha separada.

Linha de comandos

Para apresentar uma lista de 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.s3nsapis.fr/storage/v1/b?softDeleted=true"

Restaure um contentor eliminado temporariamente

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

Quando restaura um contentor eliminado temporariamente através da consola, também pode restaurar os objetos eliminados temporariamente que estavam no contentor. Cloud de Confiance

Consola

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

    Aceda a Recipientes

  2. Apresentar contentores eliminados temporariamente na lista de contentores, se ainda não aparecerem. Para ver os passos, consulte o artigo Liste os contentores eliminados temporariamente.

  3. Na linha do contentor que quer restaurar, clique em Restaurar.

  4. Se o contentor tiver várias gerações, no separador Especificar geração do contentor, selecione a geração a restaurar.

  5. Clique no separador Especificar objetos a restaurar.

  6. Na secção Especifique os objetos a restaurar, selecione se quer restaurar os objetos eliminados temporariamente que estavam no contentor. Estão disponíveis as seguintes opções:

    • Não restaurar objetos.

      Se necessário, pode restaurar objetos eliminados temporariamente mais tarde.

    • Restaurar todos os objetos.

    • Restaurar objetos que correspondem aos critérios. Faça o seguinte:

      1. Selecione o intervalo de tempo a partir do qual quer restaurar objetos.

      2. Opcional: para restaurar apenas os objetos que correspondem a um padrão glob, selecione Filtrar por padrão glob e introduza um padrão glob.

  7. Opcional: especifique comportamentos de restauro adicionais na secção Opções adicionais.

  8. Clique em Restaurar.

    O Cloud Storage restaura o contentor eliminado temporariamente para um estado ativo.

    Se restaurar os objetos no contentor, o Cloud Storage cria uma operação de restauro em massa para os objetos. A operação ocorre de forma assíncrona e pode demorar uma hora ou mais a começar. Pode acompanhar o progresso da operação clicando no botão Notificações () no cabeçalho da Cloud de Confiance consola. Em alternativa, pode usar a CLI gcloud para acompanhar o estado da operação de longa duração associada.

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.

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. Para restaurar os objetos eliminados temporariamente, consulte o artigo Restaure um objeto eliminado 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.s3nsapis.fr/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. Para restaurar os objetos eliminados temporariamente, consulte o artigo Restaure um objeto eliminado temporariamente.

O que se segue?