> ## 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 y automatice la limpieza por estado de etiquetas, antigüedad o cantidad.

Las políticas de ciclo de vida vencen imágenes de un repositorio. Cada regla tiene prioridad única, selección y acción `expire`. Las reglas seleccionan imágenes con etiquetas, sin etiquetas o todas, con filtros de prefijo o patrón cuando estén disponibles. Pueden conservar una cantidad de imágenes recientes o vencer por tiempo desde el envío o último pull.

Lea la política en `GET /v1/repositories/{repository_id}/lifecycle-policy`. Sustituya la lista completa con `PUT` en la misma ruta. Las reglas omitidas no se conservan.

<span id="preview-first" />

## Simule primero

Llame a `POST /v1/repositories/{repository_id}/lifecycle-policy/preview` con una lista candidata `rules`. La respuesta identifica digests y etiquetas coincidentes sin eliminar nada. Una solicitud vacía simula la política instalada. Compruebe la protección de versiones y manifiestos necesarios antes de guardar.

Una regla basada en el último pull usa la actividad registrada; no sabe qué imágenes puede necesitar una instancia detenida o una reversión futura. Defina una retención separada para versiones que deban conservarse.

<span id="storage-reclamation" />

## Liberación de almacenamiento

Eliminar un manifiesto y liberar sus capas son pasos distintos. Las capas referenciadas por otras imágenes siguen almacenadas. La protección contra eliminación protege el repositorio en sí; no impide que las políticas de ciclo de vida venzan imágenes.

Use `registry:StartLifecyclePolicyPreview` para permitir simulaciones sin permitir instalar o eliminar políticas. Lea, sustituya y elimine políticas con `registry:GetLifecyclePolicy`, `registry:PutLifecyclePolicy` y `registry:DeleteLifecyclePolicy`, respectivamente.


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