Cloudflare Spend Management ganha limites para Workers
Neste artigo
- Cloudflare Spend Management separa alerta de bloqueio
- Quais gastos entram no orçamento de cada produto
- Ativando o limite mensal no painel da conta
- Por que o limite não fixa o total da fatura
- Alertas e gráficos ajudam a agir antes da interrupção
- API e CLI exigem permissões de faturamento
- Como identificar bloqueios e retomar as operações
- Outros controles atendem necessidades diferentes
- Fontes
- Perguntas frequentes
O Cloudflare Spend Management passa a oferecer bloqueio de operações de Workers e Durable Objects quando o consumo alcança um orçamento definido pela conta. O recurso ajuda a conter gastos com uso excedente, mas exige uma escolha: ao atingir o limite, aplicações podem parar de atender novas operações, e algumas cobranças continuam.
Cloudflare Spend Management separa alerta de bloqueio
O controle funciona por produto, com duas modalidades: enviar e-mails sobre o consumo ou bloquear operações ao alcançar determinado valor. Workers e Durable Objects têm políticas e saldos separados, conforme a documentação de faturamento.
Na API, cada configuração recebe o nome de *spend policy*. O tipo `notification` corresponde ao aviso; `usage_block`, à interrupção do produto. Uma conta pode manter vários alertas junto de um limite bloqueador, mas só um bloqueio habilitado por produto.
Até 13 de novembro de 2026, a documentação descrevia limites para Workers e Durable Objects, com expansão anunciada para outros produtos, sem prazo. A disponibilidade específica no Brasil não foi confirmada; os valores de configuração são expressos em dólares.
Quais gastos entram no orçamento de cada produto
Em Workers, o cálculo considera requisições e tempo de CPU depois do desconto das franquias. A assinatura mensal fica de fora, e o orçamento é compartilhado por todos os Workers da conta: um projeto de testes pode consumir o saldo e provocar a interrupção de aplicações de produção. Não há divisão do limite por Worker, namespace ou métrica. (Workers)
Durable Objects soma requisições, duração, linhas SQLite lidas e escritas e operações de leitura, escrita e exclusão do armazenamento key-value. O armazenamento persistente e a assinatura Workers Paid ficam fora desse cálculo. (Durable Objects)
Até a publicação desta matéria, o Workers Paid tinha base de US$ 5 mensais. O modelo Standard incluía 10 milhões de requisições e 30 milhões de milissegundos de CPU; os excedentes custavam US$ 0,30 por milhão de requisições e US$ 0,02 por milhão de milissegundos de CPU. (Preços de Workers)
O exemplo oficial de 15 milhões de requisições, com média de 7 ms de CPU, resultava em US$ 8: US$ 5 de assinatura, US$ 1,50 de requisições e US$ 1,50 de CPU. A distinção importa ao escolher o limite, porque ele acompanha o consumo faturável coberto, enquanto a assinatura é cobrada separadamente.
No Durable Objects pago, estavam incluídos 1 milhão de requisições e 400 mil GB-s de duração por mês. Os excedentes custavam, respectivamente, US$ 0,15 por milhão e US$ 12,50 por milhão de GB-s. O produto também existia no Workers Free, restrito ao backend SQLite, com franquias diárias reiniciadas à meia-noite UTC. (Preços de Durable Objects)
Ativando o limite mensal no painel da conta
A configuração fica na área de faturamento. O campo aceita um valor positivo com até duas casas decimais, segundo o passo a passo oficial.
- Abra Billing na conta Cloudflare que reúne os produtos desejados.
- Selecione Spend Management.
- Selecione Edit the spending limit na linha de Workers ou Durable Objects.
- Preencha Monthly limit (USD) com o orçamento mensal em dólares.
- Selecione Save limit.
- Confira o estado On para verificar se o bloqueio está habilitado.
Um limite novo é ativado ao salvar. Já a edição de um limite existente preserva seu estado anterior: alterar o valor de uma configuração desligada não a liga automaticamente.
Por que o limite não fixa o total da fatura
A Cloudflare informa que a medição, a propagação do bloqueio e as operações em andamento podem deixar o consumo ultrapassar o valor configurado. Por isso, o orçamento serve como mecanismo de contenção, sem garantir um teto exato de cobrança. (Limites de Workers)
Em Durable Objects, requisições já em execução, mensagens em WebSockets abertos e operações do backend key-value legado podem continuar gerando custos. As operações key-value entram no cálculo do orçamento, embora não sejam bloqueadas; dados armazenados também seguem sujeitos à cobrança. (Limites de Durable Objects)
Há ainda um cuidado para aplicações que usam alarmes: alarmes retidos com agendamento superior a sete dias podem ser excluídos. Esse comportamento precisa entrar no planejamento de recuperação de tarefas após uma interrupção prolongada.
Alertas e gráficos ajudam a agir antes da interrupção
As políticas de notificação com destinatário podem avisar quando o consumo chega a 80% e 100% do valor escolhido. Manter esses avisos junto do bloqueio dá à equipe um ponto de intervenção antes da suspensão. (Guia da CLI)
Para investigar aumentos, o Billable Usage apresenta gráfico diário por produto e uma tabela com consumo total, consumo faturável e custo. Filtros e períodos ajudam a localizar a origem da alta; esse painel exige leitura de faturamento, atende contas Pay-as-you-go e não atende contratos Enterprise. A restrição é específica desse painel. (Monitoramento de uso)
Os alertas anteriores têm outro alcance. Em 4 de junho de 2026, a Cloudflare levou uso faturável e criação de alertas às páginas de Workers & Pages, D1, R2, KV, Queues, Vectorize, Durable Objects e Containers, mas os avisos consideravam o gasto total da conta. (Histórico de junho)
Em 20 de julho, a empresa anunciou alertas automáticos de US$ 10 para contas Pay-as-you-go elegíveis sem aviso existente, com implantação por grupos. Esse mecanismo processa o uso do dia anterior uma vez ao dia e não interrompe serviços. (Histórico dos alertas automáticos)
API e CLI exigem permissões de faturamento
A CLI oferece criação, consulta, alteração e exclusão de políticas. Ela usa o identificador da conta, e não o da zona; o valor do orçamento é informado em centavos de dólar, de modo que 5.000 centavos correspondem a US$ 50. Há também uma opção de simulação para visualizar a requisição antes da criação. (Documentação da CLI)
Tokens precisam de Account > Billing > Read para consultar políticas ou Edit para alterá-las. A criação de um token personalizado fica em My Profile > API Tokens > Create Token > Custom token, com as permissões de faturamento escolhidas conforme a tarefa. (Permissões de faturamento)
A API recomenda tokens em preferência à Global API Key e retorna versão da política e `ETag` para controlar alterações concorrentes. Uma segunda política bloqueadora ativa para o mesmo produto e conta recebe HTTP `409`; políticas de notificação não têm essa mesma restrição numérica. (Referência da API)
Como identificar bloqueios e retomar as operações
O erro 1103 após uma alta de consumo pede uma checagem em Billing > Spend Management, embora esse código também tenha outras causas. Quando o orçamento de Workers é atingido, o bloqueio rejeita novas execuções HTTP, Cron, consumidores de Queue, Email Workers e chamadas vindas de outros Workers ou Durable Objects. (Diagnóstico em Workers)
Em Durable Objects, a mensagem “Exceeded the account's spending cap for Durable Objects.” indica o limite da conta. Para retomar, aumente o valor acima do gasto atual, desligue o limite ou remova a configuração; a mudança pode levar alguns minutos. (Diagnóstico em Durable Objects)
Na CLI ou API, HTTP `403` pede revisão da conta e das permissões de faturamento. O código `412` exige buscar a versão atual antes de repetir a alteração; o `428` exige fornecer essa versão com o parâmetro de correspondência indicado pela ferramenta. (Erros da CLI)
Outros controles atendem necessidades diferentes
Para conter CPU por execução, Workers oferece `limits.cpu_ms` no Wrangler ou a configuração em Workers & Pages > [Worker] > Settings. No plano pago, o padrão documentado é 30 segundos, com máximo de 300 mil milissegundos. Esse controle atua sobre cada execução, enquanto o orçamento acompanha o consumo acumulado. (Limites de Workers)
Para inferência de IA, o AI Gateway oferece limites por modelo, provedor ou metadados, como usuário e aplicação. Ao esgotar o orçamento, retorna HTTP `429`; requisições simultâneas podem ultrapassar brevemente o valor. (AI Gateway)
Quem usa Vercel encontra notificações, webhooks e pausa de implantações de produção da equipe. Nesse serviço, definir um orçamento sozinho não ativa a pausa: a interrupção precisa ser configurada. (Vercel Spend Management)
Fontes
- Cloudflare: configuração do Spend Management
- Cloudflare: comportamento dos limites em Workers
- Cloudflare: comportamento dos limites em Durable Objects
- Cloudflare: alertas de orçamento da conta
- Cloudflare: gerenciamento pela CLI
- Vercel: documentação de Spend Management
Perguntas frequentes
O limite de Workers também cobre R2, KV e Workers AI?
Não. Esses produtos ficam fora do orçamento de Workers; Durable Objects tem controle separado.
Posso definir um orçamento de zero dólar?
Não. A API exige um valor positivo, a partir de um centavo de dólar.
Atingir o limite derruba todos os arquivos do site?
O bloqueio rejeita novas execuções de Workers. Arquivos estáticos entregues sem executar um Worker continuam disponíveis.
O bloqueio de Durable Objects apaga os dados?
Não. Os dados permanecem armazenados, e a cobrança pelo armazenamento pode continuar durante a interrupção.
Quando as execuções voltam automaticamente?
No início do próximo período de faturamento da assinatura. O limite configurado permanece para o novo período.
Um budget alert impede cobranças adicionais?
Não. Ele envia uma notificação, mas não pausa os produtos nem impede o crescimento da fatura.
