Cloudflare 퍼지 API 제한, 요금제별
Cloudflare는 Free·Pro·Business에서 퍼지 요청당 최대 100개, Enterprise의 URL 지정 퍼지에서는 500개까지 받습니다. 요청 빈도는 계정 단위로 제한되어 Free는 분당 5회, Pro는 초당 5회, Business는 초당 10회, Enterprise는 초당 50회입니다.
마지막 업데이트:
URL 몇 개를 지우는 정도로는 어떤 제한에도 닿지 않습니다. 천 개가 되면 닿는데, 실패하는 방식이 눈에 잘 띄지 않습니다. 선을 넘은 요청만 오류를 돌려주고 그 앞의 요청은 성공했기 때문에, 절반만 비워진 캐시와 분명하지 않은 상황만 남습니다.
요청당 항목 수
| 요금제 | 요청당 항목 | URL 지정 퍼지 |
|---|---|---|
| Free | 100 | 100 |
| Pro | 100 | 100 |
| Business | 100 | 100 |
| Enterprise | 100 | 500 |
「항목」은 방법에 따라 URL, 호스트명, 태그, 접두사를 뜻합니다. 수를 넘기면 요청 전체가 거부됩니다. 앞의 백 개를 처리하고 나머지를 버리는 식이 아니므로, URL 300개를 그대로 보내는 순진한 스크립트는 하나도 지우지 못합니다.
요청 횟수
| 요금제 | 퍼지 요청 | URL 지정 처리량 |
|---|---|---|
| Free | 분당 5회 | 초당 800 URL |
| Pro | 초당 5회 | 초당 1,500 URL |
| Business | 초당 10회 | 초당 1,500 URL |
| Enterprise | 초당 50회 | 초당 3,000 URL |
단위를 잘 보세요. Free는 분당 5회지 초당이 아닙니다. Pro와 60배 차이이고 이 페이지에서 가장 놀라운 숫자입니다. 요청당 100 URL로 잡으면 Free 영역은 분당 500 URL이 한계입니다.
이 제한은 영역이 아니라 계정 단위로 적용됩니다. 반복문으로 서른 개 영역을 지우면 같은 예산에 대한 서른 번의 요청이고, 그게 바로 대량 퍼지의 모습입니다.
실제로는 어떤 뜻인가
반복문을 쓰기 전에 머릿속에 넣어 둘 계산입니다.
- Free에서 URL 1,000개: 요청 10번인데 분당 5번만 허용되니 중간에 기다림을 넣어 최소 2분.
- Pro에서 URL 1,000개: 요청 10번을 초당 5번으로, 약 2초.
- Free에서 영역 50개 전체 삭제: 요청 50번을 분당 5번으로 하면 10분. 대량 퍼지가 고장 난 것처럼 보이지만 그저 차례를 기다리는 전형적인 경우입니다.
실제로 만나게 되는 오류
| 응답 | 의미 | 대처 |
|---|---|---|
429 Too Many Requests | 요금제가 허용하는 속도를 넘었다 | 간격을 두고 다시 시도하고, 촘촘한 반복문으로 두드리지 않는다 |
Invalid API Token | 토큰이 틀렸거나 잘렸거나 폐기됐다 | 토큰을 다시 확인한다. 보통은 불완전하게 붙여 넣은 경우 |
Authentication error (10000) | 토큰은 유효하지만 Cache Purge:Purge가 없다 | 권한을 추가하고 다시 발급한다 |
Too many URLs | 요청당 상한보다 항목이 많다 | 100개 이하 묶음으로 나눈다 |
FlarePurge가 제한 안에 머무는 방법
FlarePurge는 URL 퍼지를 30개씩 묶습니다. Cloudflare의 상한 100보다 일부러 낮게 잡았습니다. 이 상한은 전에도 움직인 적이 있고, 여유 있는 묶음이라야 다시 움직여도 계속 동작하기 때문입니다.
여러 영역에 걸친 대량 작업은 모든 요청을 한꺼번에 쏘지 않고 동시 실행 수를 제한해 돌리며, 묶음마다 결과를 알려 줍니다. 한 영역이 실패하면 어느 영역인지 보입니다. 절반만 성공한 작업 위에 빨간 띠 하나가 뜨는 것과는 다릅니다.
어떤 퍼지 방법을 고를지는 전체 삭제와 선택 삭제를 보세요.