Limiti dell'API di purge di Cloudflare, piano per piano
Cloudflare accetta fino a 100 elementi per richiesta di purge sui piani Free, Pro e Business, e 500 per il purge per URL su Enterprise. Il ritmo delle richieste è limitato per account: 5 al minuto su Free, 5 al secondo su Pro, 10 al secondo su Business e 50 al secondo su Enterprise.
Ultimo aggiornamento:
Svuotare quattro URL non sfiora nessun limite. Svuotarne mille sì, e il fallimento non è evidente: l'API restituisce errore sulla richiesta che ha superato la soglia mentre le precedenti sono andate a buon fine, e ti ritrovi con una cache svuotata a metà e nessun segnale chiaro.
Quanti elementi per richiesta
| Piano | Elementi per richiesta | Purge per URL |
|---|---|---|
| Free | 100 | 100 |
| Pro | 100 | 100 |
| Business | 100 | 100 |
| Enterprise | 100 | 500 |
«Elementi» significa URL, hostname, tag o prefissi a seconda del metodo. Se superi il numero, viene rifiutata l'intera richiesta: Cloudflare non elabora i primi cento scartando il resto, quindi uno script ingenuo che manda 300 URL non ne svuota nessuna.
Quante richieste
| Piano | Richieste di purge | Portata del purge per URL |
|---|---|---|
| Free | 5 al minuto | 800 URL/secondo |
| Pro | 5 al secondo | 1.500 URL/secondo |
| Business | 10 al secondo | 1.500 URL/secondo |
| Enterprise | 50 al secondo | 3.000 URL/secondo |
Attenzione alle unità. Free sono cinque richieste al minuto, non al secondo: un fattore sessanta rispetto a Pro, ed è il numero più sorprendente di questa pagina. A 100 URL per richiesta, una zona Free svuota 500 URL al minuto e non una di più.
Il limite vale per account, non per zona. Svuotare trenta zone in un ciclo conta come trenta richieste sullo stesso budget, che è esattamente la forma di un purge di massa.
Cosa significa in pratica
Qualche conto da tenere a mente prima di scrivere il ciclo:
- 1.000 URL su Free: 10 richieste, ma ne sono ammesse solo 5 al minuto, quindi due minuti come minimo con un'attesa in mezzo.
- 1.000 URL su Pro: 10 richieste a 5 al secondo, circa due secondi.
- 50 zone svuotate del tutto su Free: 50 richieste a 5 al minuto fanno dieci minuti. È il caso in cui un purge di massa sembra rotto e sta soltanto aspettando il suo turno.
Gli errori che vedrai davvero
| Risposta | Cosa significa | Cosa fare |
|---|---|---|
429 Too Many Requests | Hai superato il ritmo consentito dal tuo piano | Aspetta e riprova con un ritardo, mai in un ciclo stretto |
Invalid API Token | Il token è sbagliato, troncato o revocato | Ricontrollalo; di solito è stato incollato incompleto |
Authentication error (10000) | Il token è valido ma gli manca Cache Purge:Purge | Aggiungi il permesso e riemettilo |
Too many URLs | Più elementi del tetto per richiesta | Dividi in lotti da 100 o meno |
Come FlarePurge resta dentro i limiti
FlarePurge raggruppa i purge per URL in lotti da 30, di proposito sotto il tetto di 100 di Cloudflare. Il margine c'è perché quel tetto si è già spostato in passato, e un lotto con un po' di aria continua a funzionare quando si sposterà di nuovo.
Le operazioni di massa su molte zone girano con la concorrenza limitata invece di sparare tutte le richieste insieme, e ogni lotto riporta il proprio esito. Se fallisce una zona vedi quale, invece di un banner rosso su un'operazione riuscita a metà.
Per scegliere il metodo di purge adatto, guarda svuotare tutto o purge selettivo.