Google Cloud ha annunciato il 5 novembre 2026 la disponibilità generale del versionamento con date per l’API di Compute Engine in tutte le regioni Google Cloud. Le integrazioni esistenti basate su /v1 non devono migrare: se una richiesta non specifica una versione datata, continua a usare /v1.

Che cosa cambia tra CBV e IBV

Il versionamento basato su canali (CBV) usa i canali di lunga durata /v1, /beta e /alpha, che ricevono aggiornamenti nel tempo. Il nuovo versionamento basato su interfacce (IBV) assegna versioni a singole interfacce, metodi e risorse, così possono evolvere in modo indipendente. Google indica 2026-09-01 come identificativo della prima versione stabile e 2026-10-01-preview per una versione di anteprima.

IBV è attivo per impostazione predefinita con l’API Compute Engine. Le chiamate CBV esistenti continuano a funzionare senza modifiche; restare su CBV, però, significa non accedere alle nuove funzionalità disponibili tramite IBV. Google descrive le regole operative nella guida al versionamento di Compute Engine.

Versione stabile o preview

Le versioni stabili, identificate nel formato YYYY-MM-DD, mantengono una compatibilità rigorosa e seguono la policy standard di deprecazione di Google. Google ne pianifica il rilascio ogni trimestre. Le preview, nel formato YYYY-MM-DD-preview, possono arrivare in qualsiasi momento e includono funzioni sperimentali: la compatibilità con le versioni precedenti o future non è garantita, le funzionalità possono cambiare o essere rimosse e Google sconsiglia queste versioni per i sistemi mission-critical in produzione.

Come selezionare una versione datata

Per una chiamata REST, si può specificare la versione nell’header HTTP X-Goog-Api-Version oppure nel parametro di query $apiVersion; il percorso di base resta /compute/v1/. Anche gli strumenti distinguono i due percorsi: i comandi gcloud compute puntano alle API stabili, mentre gcloud preview compute usa le preview. In Terraform, i provider google e google-beta puntano rispettivamente alle API stabili e a quelle di anteprima.