Límites de la API de purga de Cloudflare, plan a plan
Cloudflare acepta hasta 100 elementos por petición de purga en los planes Free, Pro y Business, y 500 en la purga por URL de Enterprise. El ritmo de peticiones va por cuenta: 5 por minuto en Free, 5 por segundo en Pro, 10 por segundo en Business y 50 por segundo en Enterprise.
Última actualización:
Purgar cuatro URLs no roza ningún límite. Purgar mil sí, y el fallo no es evidente: la API devuelve error en la petición que se pasó de la raya mientras las anteriores han funcionado, así que te quedas con una caché purgada a medias y sin ninguna señal clara de ello.
Cuántos elementos por petición
| Plan | Elementos por petición | Purga por URL |
|---|---|---|
| Free | 100 | 100 |
| Pro | 100 | 100 |
| Business | 100 | 100 |
| Enterprise | 100 | 500 |
«Elementos» son URLs, hostnames, tags o prefijos según el método. Si te pasas del número, se rechaza la petición entera: Cloudflare no procesa las primeras cien y descarta el resto, así que un script ingenuo que manda 300 URLs no purga absolutamente nada.
Cuántas peticiones
| Plan | Peticiones de purga | Caudal de purga por URL |
|---|---|---|
| Free | 5 por minuto | 800 URLs/segundo |
| Pro | 5 por segundo | 1.500 URLs/segundo |
| Business | 10 por segundo | 1.500 URLs/segundo |
| Enterprise | 50 por segundo | 3.000 URLs/segundo |
Fíjate en las unidades. Free son cinco peticiones por minuto, no por segundo, o sea sesenta veces menos que Pro, y es el número que más sorprende de toda esta página. A 100 URLs por petición, una zona Free purga 500 URLs por minuto y ni una más.
El límite se aplica por cuenta, no por zona. Purgar treinta zonas en un bucle son treinta peticiones contra el mismo presupuesto, que es exactamente la forma que tiene una purga masiva.
Qué significa esto en la práctica
Cuatro cuentas que conviene tener en la cabeza antes de escribir el bucle:
- 1.000 URLs en Free: 10 peticiones, pero solo caben 5 por minuto, así que dos minutos como mínimo y con espera en medio.
- 1.000 URLs en Pro: 10 peticiones a 5 por segundo, unos dos segundos.
- 50 zonas purgando todo en Free: 50 peticiones a 5 por minuto son diez minutos. Este es el caso en el que una purga masiva parece rota y solo está esperando turno.
Los errores que vas a ver de verdad
| Respuesta | Qué significa | Qué hacer |
|---|---|---|
429 Too Many Requests | Te has pasado del ritmo que permite tu plan | Espera y reintenta con retardo, nunca en un bucle cerrado |
Invalid API Token | El token está mal, cortado o revocado | Revísalo; lo habitual es que se copiara incompleto |
Authentication error (10000) | El token es válido pero le falta Cache Purge:Purge | Añade el permiso y vuelve a emitirlo |
Too many URLs | Más elementos de los que caben por petición | Reparte en lotes de 100 o menos |
Cómo se mantiene FlarePurge dentro de los límites
FlarePurge agrupa las purgas por URL en lotes de 30, a propósito por debajo del tope de 100 de Cloudflare. El margen está ahí porque ese tope ya se ha movido antes, y un lote holgado sigue funcionando cuando vuelva a moverse.
Las operaciones masivas sobre muchas zonas van con la concurrencia limitada en lugar de disparar todas las peticiones a la vez, y cada lote informa de su resultado. Si falla una zona ves cuál, en vez de un aviso rojo sobre una operación que ha funcionado a medias.
Para elegir qué método de purga te conviene, mira purgar todo o purga selectiva.