Esta página aborda as retenções de objetos, que são flags de metadados que coloca em objetos individuais. Enquanto um objeto tiver uma retenção, não pode ser eliminado nem substituído. No entanto, pode editar os metadados do objeto.
Tipos de retenções
O Cloud Storage oferece os seguintes tipos de retenções:
- Retenções baseadas em eventos
- Retenções temporárias
Um objeto pode ter um tipo de retenção, ambos os tipos ou nenhum tipo de retenção. Quando um objeto não tem uma configuração de retenção e é armazenado num contentor sem uma política de retenção, ambos os tipos de retenção comportam-se exatamente da mesma forma. A tabela seguinte descreve o comportamento de cada tipo de retenção se um objeto tiver uma configuração de retenção ou estiver armazenado num contentor com uma política de retenção:
| O objeto tem uma retenção com base no evento | O objeto tem uma retenção temporária | |
|---|---|---|
| O objeto tem uma configuração de retenção | Não aplicável: os objetos não podem ter simultaneamente uma retenção baseada em eventos e uma configuração de retenção | A libertação de uma suspensão temporária não afeta a hora de retenção do objeto |
| O objeto está armazenado num contentor com uma política de retenção | A libertação de uma autorização prévia baseada em eventos repõe o tempo do objeto no contentor para efeitos do período de retenção | A libertação de uma retenção temporária não afeta o tempo do objeto no contentor para efeitos do período de retenção |
Exemplo de retenção com base no evento
Suponhamos que tem dois objetos, o objeto A e o objeto B, num contentor cuja política de retenção define um período de retenção de 1 ano. Quando adicionou os objetos ao contentor, colocou uma retenção baseada em eventos no objeto A e uma retenção temporária no objeto B. Passa um ano e, embora normalmente pudesse eliminá-los nesta altura, não pode eliminar nenhum dos objetos porque ambos continuam a ter uma retenção.
Neste ponto, solta a pega de ambos os objetos. Para o objeto A, que estava a usar uma retenção baseada em eventos, o respetivo tempo no contentor é reiniciado para efeitos do período de retenção. Isto significa que tem de permanecer no contentor durante mais um ano antes de poder ser eliminado ou substituído. O objeto B, que estava a usar uma retenção temporária, pode ser eliminado ou substituído imediatamente, porque a retenção temporária não tem efeito no momento em que o objeto cumpriu o respetivo tempo de retenção.
Este comportamento permite-lhe usar retenções baseadas em eventos em conjunto com as políticas de retenção para controlar a retenção com base na ocorrência de algum evento, como reter documentos de empréstimo durante um determinado período após o empréstimo ter sido pago. As retenções temporárias podem ser usadas para fins regulamentares ou legais, como a retenção de documentos de negociação para investigação legal.
A propriedade de retenção com base no evento predefinida
Além de aplicar retenções a objetos individuais, pode ativar a propriedade predefinida baseada em eventos no seu contentor. Quando o faz, cada novo objeto que é adicionado posteriormente ao contentor tem automaticamente uma retenção baseada em eventos.
Este comportamento é útil quando quer que um objeto persista no seu contentor durante um determinado período após a ocorrência de um determinado evento. Por exemplo, o seu contentor pode destinar-se a armazenar empréstimos que tem de reter durante um determinado número de anos assim que forem liquidados. Com uma política de retenção adequada e a propriedade de retenção baseada em eventos predefinida ativada para o seu contentor, quando carrega um documento de empréstimo para o contentor, é aplicada uma retenção baseada em eventos ao mesmo. Quando o empréstimo é liquidado, pode libertar a retenção. Nesse momento, a política de retenção garante que o empréstimo permanece armazenado e inalterável até cumprir o período de retenção definido na sua política de retenção.
Restrições
As solicitações que tentam aplicar uma retenção baseada em eventos a um objeto que tem uma configuração de retenção existente falham.
- As solicitações que colocariam simultaneamente uma retenção baseada em eventos num objeto e definiriam uma configuração de retenção para o objeto também falham.
Não é possível gerir as retenções de objetos com a API XML, e o estado de retenção de um objeto não é incluído quando usa a API XML para obter metadados de objetos.
No entanto, a tentativa de eliminar ou substituir um objeto com a API XML continua a falhar se o objeto tiver uma retenção.
Para carregamentos multipartes da API XML, pode iniciar um carregamento e carregar partes, mas o pedido para concluir o carregamento falha se substituir um objeto que tenha uma retenção.
As retenções de objetos não são suportadas para contentores que usam o espaço de nomes hierárquico.
O que se segue?
- Saiba como ativar as retenções baseadas em eventos por predefinição e como definir retenções de objetos individuais.
- Saiba mais sobre as políticas de retenção, que protegem os dados contra a eliminação durante um período especificado.
- Saiba mais sobre as configurações do ciclo de vida do seu contentor, que podem eliminar automaticamente objetos depois de remover as respetivas retenções.