Introducing Compute Engine API... Note

Introducing Compute Engine API multi-versioning: Predictable evolution without breaking production

Compute Engine now offers API multi-versioning for modernizing infrastructure without risking production stability. This feature introduces date-based API versions alongside the existing stable /v1 API. The long-standing /v1 API guarantees backward compatibility for millions of virtual machines and other cloud resources. However, evolving cloud needs demand newer API semantics, better resilience, and improved developer experiences. This new versioning model allows adoption of these improvements on a customer's schedule without impacting existing automation. Immutable, date-based snapshots include stable versions released quarterly and preview versions for early access. The original /v1 API remains fully supported and operational. Benefits include customer-controlled upgrades, pinning to known contracts, and on-demand upgrades. New versions also offer safer defaults like resilient global queries, actionable machine-readable errors, and cleaner API designs. This multi-versioning seamlessly integrates with client libraries, gcloud, and Terraform.