Pular para o conteúdo
Beta

Cloudflare CLI 1.0.0-beta.27

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

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

Resumo

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>. A versão recusa --zone vazio e valida uniões aninhadas na montagem do corpo. O --help também explica o escopo de comandos que atendem account ou zone.

Novidades

  • Cloudflare CLI 1.0.0-beta.27 — Campos com nome de flag: comandos gerados não descartam, mesclam nem escondem mais campos da API com o mesmo nome de uma flag do cf. cf precursor update --detection-mode define o campo mode, antes inalcançável, e cf o11y telemetry query e cf o11y shared-queries create ganham --preview.
  • Cloudflare CLI 1.0.0-beta.27 — Perfil da organização: em cf cloudforce-one priority-intelligence profile update, o perfil da organização fica em --organization-profile, e --profile volta a escolher o perfil de autenticação. Um parâmetro de API chamado force não ocupa mais a flag de confirmação --force.
  • Cloudflare CLI 1.0.0-beta.27 — Campos com nome de flag em comandos de IA e registro: cf ai run e cf registrar registrations create aceitam campos do esquema com nome de flag do cf como --input-<nome>, como --input-quiet. O cf schema lista a flag por trás de um parâmetro de caminho ou de consulta quando existe uma.
  • Cloudflare CLI 1.0.0-beta.27 — Escopos de OAuth: cf auth scopes continua funcionando com o novo grupo IAM do catálogo de escopos OAuth.
  • Cloudflare CLI 1.0.0-beta.27 — Superfície de comandos: a superfície de comandos gerada acompanha duas publicações do Forge OpenAPI.

Melhorias

  • Cloudflare CLI 1.0.0-beta.27 — Escopo de account e zone: comandos que atendem account ou zone, como cf rulesets list e cf load-balancers account list, informam no --help que rodam contra a account, a menos que --zone seja informado, e que ignoram CLOUDFLARE_ZONE_ID.
  • Cloudflare CLI 1.0.0-beta.27 — Uniões aninhadas: a montagem do corpo a partir de flags valida uniões marcadas aninhadas. Campos obrigatórios de cada ramo, objetos fechados e limites de array são preservados, inclusive em uniões escolhidas por valor de enum sem discriminador explícito, e a checagem vale para requisições e simulações.
  • Cloudflare CLI 1.0.0-beta.27 — Requisitos por alternativa: campos de mesmo nome em alternativas diferentes continuam distintos ao derivar as restrições de oneOf. As flags de VPC do Workers exigem apenas o túnel da alternativa escolhida e aceitam hosts IPv4 e IPv6 em pilha dupla.
  • Cloudflare CLI 1.0.0-beta.27 — Respostas de áudio: o gerador de comandos reconhece respostas audio/* como binárias, inclusive em esquemas sem format: binary. Os comandos gerados a partir da especificação fixada hoje não declaram resposta de áudio, então o comportamento atual não muda.
  • Cloudflare CLI 1.0.0-beta.27 — Dependências: são atualizadas as dependências publicadas pelo repositório Workers SDK, entre elas @cloudflare/config 0.29.1, @cloudflare/deploy-helpers 0.24.4 e miniflare 5.20261101.0-beta.

Correções

  • Cloudflare CLI 1.0.0-beta.27 — --zone vazio: um --zone sem valor encerra o comando com --zone requires a non-empty value. e deixa de cair em CLOUDFLARE_ZONE_ID. Comandos que encaminham argumentos, como cf containers ssh, também param de descartar um -z sem valor, e os argumentos encaminhados vão depois de --.
  • Cloudflare CLI 1.0.0-beta.27 — Cabeçalhos obrigatórios: parâmetros HTTP de cabeçalho obrigatórios, como --if-match, são enviados apenas como cabeçalho e não são mais copiados para o corpo com um nome de campo gerado.
  • Cloudflare CLI 1.0.0-beta.27 — Objetos opcionais aninhados: campos obrigatórios de um objeto opcional só são exigidos quando o objeto é informado, o que evita que flags de objetos irmãos se exijam entre si.
  • Cloudflare CLI 1.0.0-beta.27 — Corpo bruto: requisições com --body continuam fora da validação por flag individual do corpo.

Ponto de Atenção

A troca de nome em cf cloudforce-one priority-intelligence profile update muda scripts que usavam --profile para o perfil da organização, e o --zone vazio não é mais aceito. Teste sugerido: rode o comando de atualização com --organization-profile e com --profile, confira qual perfil de autenticação cada um seleciona e execute cf rulesets list --zone "" para ver a recusa.

Notas da versão

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

Versões anteriores

    • 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
    • Cloudflare CLI 1.0.0-beta.28

      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.

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