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-modedefine o campomode, antes inalcançável, ecf o11y telemetry queryecf o11y shared-queries createganham--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--profilevolta a escolher o perfil de autenticação. Um parâmetro de API chamadoforcenã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 runecf registrar registrations createaceitam campos do esquema com nome de flag do cf como--input-<nome>, como--input-quiet. Ocf schemalista 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 scopescontinua 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 listecf load-balancers account list, informam no--helpque rodam contra a account, a menos que--zoneseja informado, e que ignoramCLOUDFLARE_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 semformat: 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/config0.29.1,@cloudflare/deploy-helpers0.24.4 eminiflare5.20261101.0-beta.
Correções
- Cloudflare CLI 1.0.0-beta.27 —
--zonevazio: um--zonesem valor encerra o comando com--zone requires a non-empty value.e deixa de cair emCLOUDFLARE_ZONE_ID. Comandos que encaminham argumentos, comocf containers ssh, também param de descartar um-zsem 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
--bodycontinuam 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.