Google Cloud ogłosiło 5 listopada 2026 r. ogólną dostępność datowanego wersjonowania API Compute Engine we wszystkich regionach Google Cloud. Dla zespołów utrzymujących integracje najważniejsze jest to, że nie muszą migrować: żądanie bez wskazanej wersji datowanej nadal trafia do /v1.

Czym różnią się CBV i IBV?

Dotychczasowe wersjonowanie kanałowe (CBV) opiera się na długotrwałych ścieżkach /v1, /beta i /alpha, które są aktualizowane w miejscu. W wersjonowaniu interfejsowym (IBV) osobne wersje otrzymują interfejsy, metody i zasoby, dzięki czemu mogą rozwijać się niezależnie.

Google wskazuje 2026-09-01 jako początkową wersję stable, a 2026-10-01-preview jako wersję preview. Są to identyfikatory wersji. Wersje stable mają format YYYY-MM-DD i są planowane kwartalnie; wersje preview używają formatu YYYY-MM-DD-preview i mogą pojawiać się w dowolnym momencie.

Czy istniejące integracje muszą coś zmieniać?

Nie. Migracja jest opcjonalna, a IBV jest domyślnie włączone wraz z Compute Engine API. Jeśli żądanie nie wskazuje wersji datowanej, domyślnie korzysta z kanału /v1. Pozostanie przy CBV pozwala zachować dotychczasowe wywołania, ale nie daje dostępu do nowych funkcji udostępnianych wyłącznie przez IBV. Szczegóły opisuje przewodnik Google Cloud dotyczący wersjonowania API.

Wersje stable zachowują ścisłą zgodność w ramach standardowej polityki wycofywania Google. Wersje preview zawierają funkcje eksperymentalne, nie gwarantują zgodności z wcześniejszymi ani przyszłymi wydaniami, a ich funkcje mogą się zmienić lub zostać usunięte. Google nie zaleca preview w krytycznych systemach produkcyjnych.

Jak wybrać wersję datowaną?

Bezpośrednie żądania REST mogą wskazywać wersję przez nagłówek X-Goog-Api-Version albo parametr zapytania $apiVersion; podstawowa ścieżka pozostaje /compute/v1/.

W narzędziach Google Cloud stabilne polecenia gcloud compute korzystają ze stabilnych interfejsów API, a gcloud preview compute z wersji preview. Dostawcy Terraform google i google-beta odpowiadają odpowiednio stabilnym i testowym interfejsom. Wydania bibliotek klienckich są przypisane do konkretnych wersji datowanych.