Google Cloud maakte op 5 november 2026 bekend dat datumgebaseerd interfaceversiebeheer (IBV) voor de Compute Engine API algemeen beschikbaar is in alle Google Cloud-regio’s. Bestaande /v1-aanroepen hoeven niet te veranderen: migreren is optioneel en verzoeken zonder gekozen datumversie blijven standaard de bestaande /v1-route gebruiken.
Twee manieren om de API te versioneren
Bij channel-based versioning (CBV) gebruiken teams de langlopende kanalen /v1, /beta en /alpha, die tussentijds worden bijgewerkt. Interface-based versioning (IBV) geeft afzonderlijke interfaces, methoden en resources eigen versies, zodat die onafhankelijk van elkaar kunnen evolueren. Google noemt 2026-09-01 als de eerste stabiele versie en 2026-10-01-preview als previewversie. Stabiele versies zijn gepland per kwartaal; previewversies kunnen op elk moment verschijnen.
Wat betekent dit voor bestaande /v1-integraties?
Je hoeft niets apart in te schakelen of te migreren om bestaande CBV-aanroepen te laten werken. IBV is standaard ingeschakeld bij de Compute Engine API, maar een verzoek dat geen datumversie opgeeft, gebruikt nog steeds /v1. Wie bij CBV blijft, krijgt geen toegang tot nieuwe functies die via IBV beschikbaar komen. Google Cloud beschrijft de standaardinstellingen en migratiekeuze in zijn versiebeheergids.
Stabiele versies en previews hebben andere risico’s
Stabiele IBV-versies handhaven strikte compatibiliteit en worden onderhouden volgens Googles standaardbeleid voor uitfasering. Previewversies bevatten experimentele functies; Google garandeert geen compatibiliteit met eerdere of toekomstige versies. Functies kunnen bovendien veranderen of verdwijnen voordat ze stabiel worden. Google raadt previews daarom af voor bedrijfskritische productie.
Een REST-aanroep kiest een datumversie via de HTTP-header X-Goog-Api-Version of de queryparameter $apiVersion; het basispad blijft /compute/v1/. Releases van clientbibliotheken zijn gekoppeld aan een specifieke datumversie. De stabiele gcloud compute-opdrachten gebruiken stabiele API’s, terwijl gcloud preview compute previews gebruikt. In Terraform richten de providers google en google-beta zich respectievelijk op stabiele versies en previews.
