Google Cloud adota versões datadas e imutáveis na API do Compute Engine

Google Cloud adota versões datadas e imutáveis na API do Compute Engine

Publicado em 15/11/2026 0 visualizações

Ainda sem avaliações

Google Cloud oferece versões imutáveis por data para a API do Compute Engine, selecionáveis por cabeçalho ou parâmetro de consulta.

Versões fixadas por data

O Google Cloud disponibilizou o versionamento múltiplo da API do Compute Engine. A mudança acrescenta versões imutáveis identificadas por data à interface de longa duração /v1, permitindo que clientes escolham o comportamento da API para cada solicitação.

As versões estáveis seguem o formato AAAA-MM-DD e serão lançadas trimestralmente, começando por 2026-09-01. As versões de prévia recebem o sufixo -preview e têm validade de um ano; 2026-09-01 e 2026-10-01-preview já estão disponíveis em todas as regiões.

Seleção e estabilidade da API

O cliente seleciona uma versão pelo cabeçalho X-Goog-Api-Version ou pelo parâmetro de consulta $apiVersion, sem alteração no caminho /compute/v1/. Quando uma solicitação não especifica versão, continua usando /v1, que não tem data de encerramento definida.

Cada versão estável é uma cópia congelada dos recursos geralmente disponíveis e de seus padrões na data indicada. O Google não fará mudanças incompatíveis depois da publicação, mas ainda não informou quais versões trimestrais poderão trazer mudanças incompatíveis em relação à versão anterior.

Mudanças de comportamento e erros

Uma diferença está no resultado de AggregatedList. Em /v1, resultados parciais só são devolvidos se a solicitação definir returnPartialSuccess; nas versões datadas, essa opção fica ativada por padrão, de modo que uma falha em uma zona não interrompa uma consulta de toda a frota.

As respostas de erro passam a usar a estrutura google.rpc.ErrorInfo, com campos para motivo, domínio e metadados. Se um cliente solicitar uma versão inexistente, os metadados da resposta listam as versões disponíveis, oferecendo informações estruturadas para tratar o erro.

O Google também diz que as novas versões permitirão restringir verificações antigas de permissões do IAM que eram amplas demais e adotar padrões de configuração mais seguros. A empresa pretende aproximar esquemas de recursos antigos, alguns com mais de uma década, de suas propostas de melhoria de APIs.

Suporte nas ferramentas e bibliotecas

As bibliotecas cliente para Python, Go, Java, Node.js, C#, Ruby e PHP agora se vinculam a uma versão estável datada em cada lançamento. Os espaços de nomes compute_v1 e apiv1 permanecem, portanto os caminhos de importação não mudam; versões de prévia dos SDKs usam as APIs de prévia.

O gcloud compute passa a usar a versão estável incluída na ferramenta, enquanto o novo grupo gcloud preview compute aponta para a versão de prévia. Scripts existentes nos grupos compute, beta e alpha permanecem inalterados, e os documentos de descoberta são publicados separadamente para cada versão.

No Terraform, o provedor google usa versões estáveis e o google-beta usa versões de prévia, sem exigir uma configuração de versão no HCL. Assim, a escolha da versão também chega às ferramentas de infraestrutura, além das chamadas diretas à API.

Autor

Jaime LinharesEmpresa

CEO do Guia de TI

Comentários

0

Comece a conversa.
Seja a primeira pessoa a comentar este conteúdo.

Deixe um comentário