Pular para o conteúdo
Beta

Cloudflare CLI 1.0.0-beta.28

Confira as mudanças desta versão e os avisos antes de atualizar.

Publicada em
Posição no histórico
5 de 10
Nesta página

Resumo

O Cloudflare CLI 1.0.0-beta.28 valida o limite de itens de corpos em array em vez de dividir a requisição em lotes. A versão imprime metadados de paginação no stderr, aceita vários arquivos em campos binários de multipart e faz a validação do --body antes da autenticação. Também corrige a leitura de validade de token com escopos restritos no cf auth whoami.

Novidades

  • Cloudflare CLI 1.0.0-beta.28 — Limite de corpo em array: corpos JSON em array que ultrapassam o maxItems do esquema da API são recusados, inclusive em entrada inline, arquivo e simulação. O envio automático em lotes sai de todos os métodos HTTP, e o limite interrompe a chamada em vez de alterar o sentido do comando ou perder resultados.
  • Cloudflare CLI 1.0.0-beta.28 — Superfície de comandos: a superfície de comandos gerada acompanha a publicação do Forge OpenAPI.

Melhorias

  • Cloudflare CLI 1.0.0-beta.28 — Paginação no stderr: o result_info da API, com cursores e totais de página, é impresso no stderr, e a listagem pode ser percorrida com --cursor ou com as flags de página do endpoint. O stdout continua igual para scripts, e --quiet suprime o aviso.
  • Cloudflare CLI 1.0.0-beta.28 — Multipart binário: cf ai to-markdown --file caminho envia o arquivo no campo files da API. A flag --files @primeiro.html @segundo.pdf aceita vários arquivos, e flags repetidas preservam bytes e nomes.
  • Cloudflare CLI 1.0.0-beta.28 — Metadados de confirmação: as flags --force e o alias -f aparecem nas completions de shell e nos demais consumidores de metadados para comandos DELETE gerados e para operações que exigem confirmação.
  • Cloudflare CLI 1.0.0-beta.28 — Rótulos de ação: operações PUT e PATCH confirmadas mostram Updating e Updated, e ações POST confirmadas usam Processing e Done. Os avisos de cada operação e o comportamento de --force continuam iguais.
  • Cloudflare CLI 1.0.0-beta.28 — Descrição de --body: comandos que enviam --body como text/plain apresentam nos metadados a mesma descrição de --help, inclusive em tipos com parâmetros como text/plain;charset=UTF-8. Sem descrição informada, os metadados e o --help usam o texto de corpo simples.
  • Cloudflare CLI 1.0.0-beta.28 — Nomes de opção nos metadados: os metadados de opção passam pela normalização kebab-case do construtor de comandos, e as completions e o cf tools anunciam as flags aceitas pelos comandos existentes.
  • Cloudflare CLI 1.0.0-beta.28 — Dependências: são atualizadas as dependências publicadas pelo repositório Workers SDK em três levas, entre elas @cloudflare/config 0.30.2, @cloudflare/deploy-helpers 0.26.0 e miniflare 5.20261104.0-beta.

Correções

  • Cloudflare CLI 1.0.0-beta.28 — Erros de uso: nomes de comando desconhecidos no primeiro e no segundo nível seguidos de --help ou -h encerram com erro, com mensagem curta e indicação do --help correspondente. Flags globais desconhecidas também listam as globais disponíveis.
  • Cloudflare CLI 1.0.0-beta.28 — Validade de token com escopo: o cf auth whoami consulta a verificação do token para que endpoints restritos de detalhe de usuário e de account não façam um token ativo parecer inválido. Quando nenhuma verificação disponível resolve o estado, a saída informa validade desconhecida.
  • Cloudflare CLI 1.0.0-beta.28 — --body antes da autenticação: os comandos analisam --body e conferem o limite de itens antes de autenticar ou de mostrar confirmação. Corpo malformado ou arquivo @file ilegível falha de imediato, e --body "" em endpoint JSON é recusado como JSON inválido.
  • Cloudflare CLI 1.0.0-beta.28 — Corpo de texto obrigatório: comandos com corpo text/plain obrigatório recusam a chamada sem --body ou --file antes da autenticação e da requisição. A mensagem de validação cita as duas opções de entrada.

Ponto de Atenção

A remoção do envio em lotes muda o comportamento de chamadas que dependiam da divisão automática em várias requisições, e a validação de --body antes do login faz o comando falhar mais cedo. Teste sugerido: envie um corpo em array acima do maxItems e confirme a recusa. Depois rode uma listagem longa com --quiet e sem a flag para comparar a saída de erro.

Notas da versão

As mudanças estão nas notas oficiais do Cloudflare CLI 1.0.0-beta.28, publicadas em 05/11/2026. A publicação é uma pré-release da linha 1.0.0.

Versões anteriores

    • Cloudflare CLI 1.0.0-beta.27

      O Cloudflare CLI 1.0.0-beta.27 separa campos da API que colidiam com flags próprias do cf, e comandos gerados expõem --organization-profile e --input-<nome>.

      Beta
    • Cloudflare CLI 1.0.0-beta.26

      O Cloudflare CLI 1.0.0-beta.26 ajusta a busca de comandos do cf cli search e coloca cf deploy no topo dos resultados para site estático e Pages.

      Beta
    • Cloudflare CLI 1.0.0-beta.24

      O Cloudflare CLI 1.0.0-beta.24 entrega ao Miniflare a resolução do registro de desenvolvimento usada por cf dev e --local.

      Beta
    • Cloudflare CLI 1.0.0-beta.23

      O Cloudflare CLI 1.0.0-beta.23 atualiza a superfície de comandos gerada a partir da publicação do Forge OpenAPI e sobe as dependências do Workers SDK.

      Beta

Versões posteriores

    • Cloudflare CLI 1.0.0-beta.32

      O Cloudflare CLI 1.0.0-beta.32 exige Wrangler 4.161.0 ou mais recente no delegado cf-wrangler e para de definir CLOUDFLARECFAUTH nos servidores de desenvolvimento.

      BetaBreaking change
    • Cloudflare CLI 1.0.0-beta.31

      O Cloudflare CLI 1.0.0-beta.31 grava os caminhos dos source maps relativos à raiz do projeto antes do upload, o que encurta os stack traces de Workers publicados.

      BetaBreaking change
    • Cloudflare CLI 1.0.0-beta.30

      O Cloudflare CLI 1.0.0-beta.30 reescreve a saída de autenticação para leitura humana e acrescenta cf whoami como alias de cf auth whoami.

      BetaBreaking change
Ver todas as 10 versões do Cloudflare CLI
Histórico de versões