Пошук

Ліміти витрат для Cloudflare Workers і Durable Objects: налаштування в дашборді та через cf CLI

·

У листопаді 2026 року Cloudflare додала продуктові ліміти витрат та email-оповіщення для Workers і Durable Objects на рівні облікового запису. Ліміти діють у межах поточного білінгового періоду підписки й налаштовуються окремо для кожного продукту. Далі розглянемо, як керувати ними через дашборд та cf CLI.

Як працюють продуктові ліміти витрат

Нові обмеження витрат застосовуються до всього облікового запису для вибраного продукту (Workers або Durable Objects) і діють лише в межах поточного білінгового періоду підписки. Для кожного продукту ви окремо задаєте такі параметри:

  • грошовий ліміт у доларах США для поточного періоду;
  • email-адресу для сповіщень;
  • один або кілька порогів, при досягненні яких надсилатимуться листи;
  • режим Block usage — чи потрібно блокувати використання після досягнення ліміту.

Коли витрати за продуктом досягають заданого ліміту та увімкнено Block usage, Cloudflare блокує підтримувані операції цього продукту (наприклад, нові виклики Workers). Якщо блокування вимкнено, ви отримуєте лише email-сповіщення, а застосунки продовжують працювати.

Щоб відновити роботу після спрацювання ліміту, потрібно виконати один із таких кроків:

  • підвищити ліміт вище поточних витрат;
  • вимкнути або видалити ліміт;
  • дочекатися початку наступного білінгового періоду — тоді використання автоматично буде розблоковано.

Через затримку в обліку використання зафіксовані витрати можуть трохи перевищити встановлений ліміт до того, як блокування набуде чинності. Деталі того, що саме враховується в ліміт, наведено в документації «What counts toward a limit».

Налаштування лімітів і оповіщень у дашборді Cloudflare

Для базового керування витратами Workers і Durable Objects через вебінтерфейс використовуйте розділ Billing — Spend limits.

Кроки налаштування

  1. Перейдіть у Cloudflare dashboard і виберіть потрібний обліковий запис.
  2. Відкрийте розділ Billing — Spend limits.
  3. Оберіть продукт: Workers або Durable Objects.
  4. Задайте Spending limit у доларах США. Наприклад, ліміт $10 для Workers.
  5. Вкажіть Notification email, на яку приходитимуть попередження.
  6. Додайте один або кілька alert thresholds — порогів витрат, після досягнення яких надходитимуть листи. У прикладі для ліміту $10 можна поставити сповіщення на $5 і $9.
  7. Визначте, як працюватиме опція Block usage:
    • увімкнено — при досягненні ліміту нове використання підтримуваних операцій продукту буде заблоковано;
    • вимкнено — ви отримуватимете сповіщення, але застосунки продовжать працювати.

Такий підхід дає змогу або жорстко обмежити витрати, або лише відстежувати їх через email, не ризикуючи простоями сервісу.

Workers controls with usage blocking at $10, a notification email, and alert thresholds at $5 and $9.

Моніторинг і момент спрацювання ліміту

У тому ж розділі Spend limits доступний огляд по кожному продукту, де показано:

  • поточні зафіксовані витрати;
  • пороги сповіщень;
  • статус використання, включно з інформацією про паузу сервісу.

Email-оповіщення надсилаються при досягненні зазначених порогів, незалежно від того, чи вмикаєте ви блокування. Якщо ж спрацьовує сам ліміт, Cloudflare блокує підтримувані операції продукту доти, доки ви не зміните або не вимкнете обмеження, або не почнеться новий білінговий період.

Spend limits overview with Workers marked Services paused and separate spend and threshold indicators for Durable Objects.

Приклад: комбінування лімітів і оповіщень для Workers і Durable Objects

Cloudflare описує приклад, коли для різних продуктів одного облікового запису застосовуються різні стратегії керування витратами:

  • для Workers встановлено ліміт витрат $50 з блокуванням використання;
  • для Durable Objects налаштовано лише email-оповіщення на рівні $20, без блокування.

У такому сценарії, коли витрати Durable Objects досягають $20, ви отримаєте email, але об'єкти й надалі працюватимуть. Коли ж витрати Workers сягнуть $50, спрацює ліміт, і нові виклики Workers буде заблоковано до зміни або скидання обмеження.

flowchart LR
    A["Durable Objects reaches $20"] --> B["Email alert sent"]
    B --> C["Usage continues"]
    D["Workers reaches $50"] --> E["Spending limit takes effect"]
    E --> F["New Worker invocations blocked"]

Створення ліміту витрат через cf CLI

Окрім дашборда, продуктовими лімітами можна керувати за допомогою cf CLI. Це корисно, якщо ви хочете автоматизувати керування витратами або включити його у свій CI/CD-процес.

Підготовка

  1. Встановіть cf CLI та оберіть обліковий запис за офіційною інструкцією: Install the cf CLI and select your account.
  2. Переконайтеся, що у вас є права керувати білінгом для цього облікового запису.

Приклад ліміту для Workers на $50

Щоб задати ліміт витрат для Workers у розмірі $50 за поточний білінговий період із блокуванням використання, використовується команда:

cf billing spend-policies create \
  --name 'Workers $50 spending limit' \
  --product-id workers \
  --enabled true \
  --threshold-cents 5000 \
  --action usage_block

Ключові параметри цієї команди:

  • --name 'Workers $50 spending limit' — довільна назва політики витрат, за якою її зручно буде знайти;
  • --product-id workers — цільовий продукт; для Durable Objects потрібно вказати --product-id durable_objects і відповідно змінити назву політики;
  • --enabled true — політика витрат одразу активна;
  • --threshold-cents 5000 — ліміт у центах США; тут 5000 означає $50. Ліміт враховує вже зафіксоване використання за поточний білінговий період;
  • --action usage_block — при досягненні порога нове використання підтримуваних операцій продукту буде заблоковано до зміни політики або початку нового періоду.

Щоб створити ліміт для Durable Objects, достатньо змінити --product-id та потрібну суму в --threshold-cents, залишивши решту параметрів за потреби такими самими.

Поєднання продуктових лімітів з account-wide budget alerts та AI Gateway

Раніше того ж року Cloudflare вже додала account-wide budget alerts. Вони сповіщають про сумарні витрати по обліковому запису, але не блокують використання сервісів. Нові продуктові ліміти для Workers і Durable Objects доповнюють цей механізм — їх можна використовувати паралельно.

Щоб налаштувати загальноакаунтові сповіщення, потрібно перейти в Billing — Billable Usage або скористатися budget alerts guide. Для детальнішого керування продуктовими лімітами й оповіщеннями через дашборд та cf CLI доступний посібник spending limits and alerts guide.

Окремо Cloudflare нагадує, що ці продуктові ліміти можна застосовувати разом із AI Gateway spend limits, щоб керувати витратами на обчислення та AI inference в усій застосунковій інфраструктурі. Підтримка додаткових продуктів у системі лімітів витрат планується надалі.

Джерело: Cloudflare Changelog

Пошук

Закрити