Google Cloud a annoncé le 5 novembre 2026 la disponibilité générale du versionnage par dates de l’API Compute Engine dans toutes les régions Google Cloud. Les intégrations qui utilisent déjà /v1 n’ont pas à migrer : elles peuvent continuer avec leur version actuelle, tandis que les équipes qui veulent choisir un contrat daté peuvent adopter le nouveau modèle. Google cite 2026-09-01 comme première version stable et 2026-10-01-preview comme version preview.
Deux façons de versionner l’API Compute Engine
Le versionnage par canal (CBV) repose sur des canaux de longue durée, comme /v1, /beta et /alpha, qui reçoivent des mises à jour. Le versionnage par interface (IBV) attribue une version aux interfaces, aux méthodes et aux ressources, qui peuvent ainsi évoluer indépendamment. Google prévoit des versions stables chaque trimestre; des versions preview peuvent paraître à tout moment. Le guide de versionnage de Google Cloud détaille ces règles.
Les appels /v1 peuvent rester en place
Google indique que la migration vers IBV est facultative et qu’aucune activation séparée n’est nécessaire : IBV est activé par défaut avec l’API Compute Engine. Un appel sans version datée utilise toujours l’endpoint CBV /v1. En revanche, les équipes qui restent sur CBV n’accèdent pas aux nouvelles fonctions proposées uniquement par IBV.
Pour les appels REST, la base reste /compute/v1/. Il faut préciser la version datée dans l’en-tête X-Goog-Api-Version ou dans le paramètre de requête $apiVersion.
Stable pour la production, preview pour les essais
Les versions stables suivent une compatibilité stricte : une version stable plus récente ne doit pas casser les fonctionnalités existantes ni imposer une réécriture du code. Google les maintient selon sa politique standard de dépréciation. Les versions preview ajoutent des fonctions expérimentales, sans garantie de compatibilité avec les versions précédentes ou futures; Google ne les recommande pas pour les environnements de production critiques, car leurs fonctions peuvent encore changer ou être retirées.
Les bibliothèques clientes associent chaque publication à une version datée. Les commandes gcloud compute ciblent les versions stables, tandis que gcloud preview compute cible les versions preview. Avec Terraform, le fournisseur google-beta donne accès aux previews.
