Defina e faça a gestão de políticas de eliminação recuperável

Vista geral Utilização

Esta página descreve como definir e gerir políticas de eliminação temporária. Pode definir novas políticas em contentores para ativar a eliminação reversível, bem como atualizar e verificar o estado das políticas existentes. Para saber como desativar a eliminação temporária, consulte o artigo Desative a eliminação temporária.

Para saber como listar e restaurar objetos eliminados temporariamente, consulte o artigo Use objetos eliminados temporariamente. Para saber como listar e restaurar contentores eliminados temporariamente, consulte o artigo Use contentores eliminados temporariamente.

Funções necessárias

Para obter as autorizações de que precisa para ativar e gerir políticas de eliminação reversível, peça ao seu administrador para lhe conceder a função de IAM Administrador do armazenamento (roles/storage.admin) no contentor ou no projeto que contém o contentor.

Esta função predefinida contém as autorizações necessárias para ativar e gerir políticas de eliminação reversível. 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 ativar e gerir políticas de eliminação reversível:

  • storage.buckets.get
  • storage.buckets.update
  • storage.buckets.list (esta autorização só é necessária se planear usar a Google Cloud consola para executar as instruções nesta página)

Para ver informações sobre a concessão de funções, consulte os artigos Defina e faça a gestão de políticas de IAM em contentores ou Faça a gestão do acesso a projetos.

Edite a política de eliminação reversível de um contentor

A nova duração da retenção de eliminação temporária aplica-se apenas a objetos ou contentores que eliminar após a entrada em vigor da política de eliminação temporária. Os objetos eliminados temporariamente existentes não são afetados pelas atualizações feitas à política de eliminação temporária e são retidos durante o período que estava em vigor quando foram eliminados.

Siga estas instruções para editar a política de eliminação reversível de um contentor:

Consola

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

    Aceda a Recipientes

  2. Na lista de contentores, clique no nome do contentor cuja política de eliminação reversível quer editar.

  3. Clique no separador Proteção.

  4. Na secção Política de eliminação temporária (para recuperação de dados), adicione uma nova política de eliminação temporária ou edite a duração da retenção de uma política existente através dos seguintes passos:

    1. Clique em Edit.

    2. Na caixa de diálogo Definir uma política de eliminação temporária apresentada, especifique uma duração da retenção da eliminação temporária escolhendo uma unidade de tempo e uma duração.

    3. Clique em Guardar.

Para saber como obter informações detalhadas sobre erros relativos a operações do Cloud Storage falhadas na Google Cloud consola, consulte a secção Resolução de problemas.

Linha de comandos

Para adicionar ou editar a política de eliminação reversível num contentor, use o comando gcloud storage buckets update com a flag --soft-delete-duration:

  gcloud storage buckets update gs://BUCKET_NAME --soft-delete-duration=SOFT_DELETE_DURATION

Onde:

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

  • SOFT_DELETE_DURATION especifica a duração da retenção de eliminação temporária.

    • A unidade s representa segundos.
    • A unidade d representa dias.
    • A unidade m representa meses.

    Por exemplo:

    • 7d43200s define uma duração de retenção de sete dias e meio (7 dias e 43 200 segundos).

    • 2w1d define uma duração de retenção de duas semanas e um dia.

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. Crie um ficheiro JSON que contenha as seguintes informações:

    {
  "softDeletePolicy": {
    "retentionDurationSeconds": "TIME_IN_SECONDS"
  }
}

    Onde TIME_IN_SECONDS é a quantidade de tempo em segundos que quer definir para a duração da retenção de eliminação temporária. Por exemplo, 2678400 durante 2 678 400 segundos (31 dias).

  3. Use cURL para chamar a API JSON com um pedido de PATCH contentor:

    curl -X PATCH --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"

    Onde:

    • JSON_FILE_NAME é o caminho para o ficheiro JSON que criou no passo 2.
    • BUCKET_NAME é o nome do contentor relevante. Por exemplo, my-bucket.

Verifique se a política de eliminação reversível está ativada num contentor

Consola

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

    Aceda a Recipientes

  2. Na lista de contentores, clique no nome do contentor cuja política de eliminação reversível quer verificar.

  3. Clique no separador Proteção.

    O estado é apresentado na secção Política de eliminação temporária (para recuperação de dados).

Também pode usar o separador Proteção para verificar se existe uma política de eliminação temporária no seu contentor.

Para saber como obter informações detalhadas sobre erros relativos a operações do Cloud Storage falhadas na Google Cloud consola, consulte a secção Resolução de problemas.

Linha de comandos

Para verificar o estado da política de eliminação reversível de um contentor, use o comando gcloud storage buckets describe:

  gcloud storage buckets describe gs://BUCKET_NAME \
      --format="default(soft_delete_policy)"

Onde:

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

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/BUCKET_NAME?fields=softDeletePolicy"

    Em que BUCKET_NAME é o nome do contentor relevante. Por exemplo, my-bucket.

O que se segue?