> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Políticas de ciclo de vida

> Simule e automatize a limpeza por estado das tags, idade ou quantidade.

Políticas de ciclo de vida expiram imagens de um repositório. Cada regra tem prioridade exclusiva, seleção e ação `expire`. Regras selecionam imagens com tags, sem tags ou todas, com filtros de prefixo ou padrão quando disponíveis. Podem manter uma quantidade de imagens recentes ou expirar por tempo desde o envio ou último pull.

Leia a política em `GET /v1/repositories/{repository_id}/lifecycle-policy`. Substitua a lista completa com `PUT` no mesmo caminho. Regras omitidas não são preservadas.

<span id="preview-first" />

## Simule primeiro

Chame `POST /v1/repositories/{repository_id}/lifecycle-policy/preview` com uma lista candidata `rules`. A resposta identifica digests e tags correspondentes sem excluir nada. Uma solicitação vazia simula a política instalada. Verifique a proteção de versões e manifestos necessários antes de salvar.

Uma regra baseada no último pull usa a atividade registrada; não sabe quais imagens uma instância parada ou um rollback futuro pode exigir. Defina retenção separada para versões que precisam ser preservadas.

<span id="storage-reclamation" />

## Liberação de armazenamento

Remover um manifesto e liberar suas camadas são etapas distintas. Camadas referenciadas por outras imagens permanecem armazenadas. A proteção contra exclusão protege o repositório em si; não impede que políticas de ciclo de vida expirem imagens.

Use `registry:StartLifecyclePolicyPreview` para permitir simulações sem permitir instalar ou excluir políticas. Leia, substitua e remova políticas com `registry:GetLifecyclePolicy`, `registry:PutLifecyclePolicy` e `registry:DeleteLifecyclePolicy`, respectivamente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.