# cache

> Órdenes openwaf-cloud ctl cache para purgar la caché del borde de una zona por URL, prefijo, nombre, etiqueta o entera, y ver las purgas recientes.

Las purgas quedan en la auditoría, pero no son configuración de la zona: no crean versión y volver atrás nunca recupera el contenido purgado.

## cache purge

```text
cache purge <zona> --everything | --url U… | --prefix host/ruta… | --host nombre… | --tag t… --reason "…"
```

Indica exactamente un tipo de purga; `--url`, `--prefix`, `--host` y `--tag` se pueden repetir (hasta 100 valores).

| Opción | Purga |
|---|---|
| `--everything` | Todo lo guardado de la zona. |
| `--url <url>` | Esa URL de la zona, con todas sus variantes. |
| `--prefix <host/ruta>` | Todas las URL que empiezan por ese host y esa ruta (sin parámetros ni fragmento). |
| `--host <nombre>` | Todo lo guardado de ese nombre. |
| `--tag <etiqueta>` | Todas las respuestas que llevaban ese valor de `Cache-Tag`. |

La API simula antes la purga y la CLI enseña los valores tal como se aplicarán (normalizados) y cualquier aviso, y después pide confirmación. `--dry-run` se queda ahí y `--yes` no pregunta. Los nodos de borde aplican una purga en cuanto les llega, en general en menos de un segundo. `--json` imprime la respuesta de la API.

```sh
openwaf-cloud ctl cache purge example.com --url https://www.example.com/styles.css \
  --url https://www.example.com/app.js --reason "Despliegue 42" --yes
openwaf-cloud ctl cache purge example.com --tag product-42 --reason "Cambio de precio" --yes
```

## cache purges

```text
cache purges <zona> [--limit N] [--json]
```

Las purgas de la zona de los últimos 7 días, de la más reciente a la más antigua: número de secuencia, hora, tipo, valores, en cuántos nodos de borde con caché se ha aplicado y quién la hizo.

| Opción | Significado |
|---|---|
| `--limit N` | Como mucho N purgas (20 por defecto, máximo 100). |