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 IAM de
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 Trusted Cloud consola para executar as instruções nesta página)
Para informações sobre a concessão de funções, consulte os artigos Use o IAM com 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
- Na Trusted Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor cuja política de eliminação reversível quer editar.
Clique no separador Proteção.
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:
Clique em Edit.
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.
Clique em Guardar.
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
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.
- A unidade
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
.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).Use
cURL
para chamar a API JSON com um pedido dePATCH
contentor:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/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
- Na Trusted Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor cuja política de eliminação reversível quer verificar.
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 Trusted 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
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 pedido deGET
contentor:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=softDeletePolicy"
Em que
BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.
O que se segue?
- Saiba como usar objetos eliminados temporariamente.
- Saiba como usar contentores eliminados temporariamente.
- Saiba como desativar a eliminação temporária.