Cloudflare Purge-API-Limits, Tarif für Tarif
Cloudflare akzeptiert bis zu 100 Elemente pro Purge-Anfrage in den Tarifen Free, Pro und Business, beim Leeren nach URL 500 in Enterprise. Die Anfragerate ist pro Konto gedeckelt: 5 pro Minute in Free, 5 pro Sekunde in Pro, 10 pro Sekunde in Business und 50 pro Sekunde in Enterprise.
Zuletzt aktualisiert:
Eine Handvoll URLs zu leeren reißt kein Limit. Tausend zu leeren schon, und der Fehlschlag ist nicht offensichtlich: die API liefert einen Fehler für die Anfrage, die über die Linie ging, während die vorherigen durchgingen — du bleibst mit einem halb geleerten Cache zurück und ohne klares Signal.
Wie viele Elemente pro Anfrage
| Tarif | Elemente pro Anfrage | Leeren nach URL |
|---|---|---|
| Free | 100 | 100 |
| Pro | 100 | 100 |
| Business | 100 | 100 |
| Enterprise | 100 | 500 |
„Elemente“ sind je nach Methode URLs, Hostnames, Tags oder Präfixe. Überschreitest du die Zahl, wird die gesamte Anfrage abgelehnt: Cloudflare verarbeitet nicht die ersten hundert und verwirft den Rest, ein naives Skript mit 300 URLs leert also überhaupt nichts.
Wie viele Anfragen
| Tarif | Purge-Anfragen | Durchsatz beim Leeren nach URL |
|---|---|---|
| Free | 5 pro Minute | 800 URLs/Sekunde |
| Pro | 5 pro Sekunde | 1.500 URLs/Sekunde |
| Business | 10 pro Sekunde | 1.500 URLs/Sekunde |
| Enterprise | 50 pro Sekunde | 3.000 URLs/Sekunde |
Achte auf die Einheiten. Free bedeutet fünf Anfragen pro Minute, nicht pro Sekunde — Faktor sechzig gegenüber Pro und die überraschendste Zahl auf dieser Seite. Bei 100 URLs pro Anfrage leert eine Free-Zone 500 URLs pro Minute und keine mehr.
Das Limit gilt pro Konto, nicht pro Zone. Dreißig Zonen in einer Schleife zu leeren zählt als dreißig Anfragen auf dasselbe Budget — und genau so sieht ein Massen-Purge aus.
Was das in der Praxis heißt
Ein paar Rechnungen, die man im Kopf haben sollte, bevor man die Schleife schreibt:
- 1.000 URLs in Free: 10 Anfragen, aber nur 5 pro Minute erlaubt — also mindestens zwei Minuten mit Wartezeit dazwischen.
- 1.000 URLs in Pro: 10 Anfragen bei 5 pro Sekunde, rund zwei Sekunden.
- 50 Zonen komplett leeren in Free: 50 Anfragen bei 5 pro Minute sind zehn Minuten. Das ist der Fall, in dem ein Massen-Purge kaputt aussieht und bloß in der Warteschlange steht.
Die Fehler, die dir wirklich begegnen
| Antwort | Bedeutung | Was zu tun ist |
|---|---|---|
429 Too Many Requests | Du hast die Rate deines Tarifs überschritten | Warten und mit Verzögerung erneut versuchen, nie in einer engen Schleife |
Invalid API Token | Der Token ist falsch, abgeschnitten oder widerrufen | Token prüfen; meist wurde er unvollständig eingefügt |
Authentication error (10000) | Der Token ist gültig, aber ohne Cache Purge:Purge | Berechtigung ergänzen und neu ausstellen |
Too many URLs | Mehr Elemente als pro Anfrage erlaubt | In Stapel von höchstens 100 aufteilen |
Wie FlarePurge innerhalb der Limits bleibt
FlarePurge bündelt URL-Purges in Stapeln von 30 — bewusst unter der Obergrenze von 100. Der Abstand ist da, weil diese Grenze sich schon einmal verschoben hat, und ein Stapel mit Luft funktioniert weiter, wenn sie sich wieder verschiebt.
Massenoperationen über viele Zonen laufen mit gedeckelter Parallelität statt alle Anfragen auf einmal abzufeuern, und jeder Stapel meldet sein eigenes Ergebnis. Fällt eine Zone aus, siehst du welche, statt eines roten Banners über einer Operation, die halb funktioniert hat.
Welche Purge-Methode wann passt, steht unter alles leeren oder selektiv leeren.