Limites da API de purge da Cloudflare, plano a plano
A Cloudflare aceita até 100 elementos por pedido de limpeza nos planos Free, Pro e Business, e 500 na limpeza por URL do Enterprise. O ritmo de pedidos é limitado por conta: 5 por minuto no Free, 5 por segundo no Pro, 10 por segundo no Business e 50 por segundo no Enterprise.
Última atualização:
Limpar quatro URLs não chega perto de nenhum limite. Limpar mil chega, e a falha não é evidente: a API devolve erro no pedido que passou da linha enquanto os anteriores correram bem, e fica com uma cache limpa a meio e sem nenhum sinal claro disso.
Quantos elementos por pedido
| Plano | Elementos por pedido | Limpeza por URL |
|---|---|---|
| Free | 100 | 100 |
| Pro | 100 | 100 |
| Business | 100 | 100 |
| Enterprise | 100 | 500 |
«Elementos» são URLs, hostnames, tags ou prefixos consoante o método. Se passar do número, é rejeitado o pedido inteiro: a Cloudflare não processa os primeiros cem e descarta o resto, por isso um script ingénuo que envia 300 URLs não limpa absolutamente nada.
Quantos pedidos
| Plano | Pedidos de limpeza | Débito da limpeza por URL |
|---|---|---|
| Free | 5 por minuto | 800 URLs/segundo |
| Pro | 5 por segundo | 1500 URLs/segundo |
| Business | 10 por segundo | 1500 URLs/segundo |
| Enterprise | 50 por segundo | 3000 URLs/segundo |
Repare nas unidades. Free são cinco pedidos por minuto, não por segundo: um fator sessenta em relação ao Pro, e é o número mais surpreendente desta página. A 100 URLs por pedido, uma zona Free limpa 500 URLs por minuto e nem mais um.
O limite aplica-se por conta, não por zona. Limpar trinta zonas num ciclo conta como trinta pedidos ao mesmo orçamento, que é exatamente o formato de uma limpeza em massa.
O que isto significa na prática
Umas contas que convém ter na cabeça antes de escrever o ciclo:
- 1000 URLs no Free: 10 pedidos, mas só cabem 5 por minuto, ou seja dois minutos no mínimo e com espera pelo meio.
- 1000 URLs no Pro: 10 pedidos a 5 por segundo, cerca de dois segundos.
- 50 zonas a limpar tudo no Free: 50 pedidos a 5 por minuto dão dez minutos. É o caso em que uma limpeza em massa parece avariada e só está à espera da vez.
Os erros que vai mesmo ver
| Resposta | O que significa | O que fazer |
|---|---|---|
429 Too Many Requests | Passou do ritmo que o seu plano permite | Espere e repita com atraso, nunca num ciclo fechado |
Invalid API Token | O token está errado, cortado ou revogado | Reveja-o; o habitual é ter sido copiado incompleto |
Authentication error (10000) | O token é válido mas falta-lhe Cache Purge:Purge | Acrescente a permissão e volte a emiti-lo |
Too many URLs | Mais elementos do que cabem por pedido | Divida em lotes de 100 ou menos |
Como o FlarePurge se mantém dentro dos limites
O FlarePurge agrupa as limpezas por URL em lotes de 30, de propósito abaixo do teto de 100 da Cloudflare. A margem existe porque esse teto já se mexeu antes, e um lote com folga continua a funcionar quando voltar a mexer-se.
As operações em massa sobre muitas zonas correm com a concorrência limitada em vez de dispararem todos os pedidos ao mesmo tempo, e cada lote reporta o seu resultado. Se falhar uma zona vê qual, em vez de um aviso vermelho sobre uma operação que correu bem a meio.
Para escolher o método de limpeza adequado, veja limpar tudo ou limpeza seletiva.