Em 5 de novembro de 2026, o Google Cloud anunciou a disponibilidade geral do versionamento por data da API Compute Engine em todas as regiões da plataforma. A migração é opcional: integrações existentes continuam funcionando com /v1, enquanto versões datadas permitem escolher contratos específicos da API. O Google identificou 2026-09-01 como a versão estável inicial e 2026-10-01-preview como versão de prévia para testes.

O que muda entre CBV e IBV

O modelo antigo, chamado versionamento baseado em canais (CBV), usa /v1, /beta e /alpha, que recebem atualizações ao longo do tempo. No versionamento baseado em interfaces (IBV), interfaces, métodos e recursos podem ter versões datadas e evoluir de forma independente. O Google planeja publicar versões estáveis trimestralmente; versões preview podem sair a qualquer momento.

O que acontece com as integrações /v1

Não é necessário migrar nem ativar o IBV separadamente: ele vem habilitado por padrão com a API Compute Engine. Chamadas sem uma versão datada continuam usando o endpoint CBV /v1. Permanecer no CBV, porém, significa não acessar recursos novos que estejam disponíveis apenas no IBV, segundo o guia de versionamento do Google Cloud.

Stable para produção, preview para testes

As versões estáveis mantêm compatibilidade rigorosa e seguem a política padrão de descontinuação do Google Cloud. Já as versões preview incluem recursos experimentais, não garantem compatibilidade com versões anteriores ou futuras e podem mudar ou ser removidas. O Google não recomenda usá-las em produção de missão crítica.

Como selecionar uma versão datada

Em chamadas REST, o caminho-base continua sendo /compute/v1/. Para escolher uma versão, use o cabeçalho HTTP X-Goog-Api-Version ou o parâmetro de consulta $apiVersion. Cada lançamento das bibliotecas cliente fica associado a uma versão datada; no gcloud, os comandos gcloud compute apontam para APIs estáveis e gcloud preview compute para APIs preview. No Terraform, os provedores google e google-beta atendem, respectivamente, às versões estáveis e preview.