Google Cloud anunció el 5 de noviembre de 2026 la disponibilidad general del versionado por fechas para la API de Compute Engine en todas sus regiones. Las integraciones que ya usan /v1 pueden seguir funcionando sin migrar; las versiones fechadas ofrecen otra opción para quienes necesitan sus contratos o funciones. La guía de versionado de Google Cloud explica cómo se comportan ambas vías.
Versionado por canales o por fechas
El modelo tradicional, llamado versionado por canales (CBV), usa /v1, /beta y /alpha, que reciben actualizaciones. El nuevo versionado por interfaces (IBV) permite versionar por separado interfaces, métodos y recursos para que evolucionen de forma independiente.
Google identifica 2026-09-01 como la versión fechada estable inicial y 2026-10-01-preview como una versión de vista previa. Son identificadores de versión. Las versiones estables se planifican cada trimestre; las de vista previa pueden publicarse en cualquier momento.
Las integraciones /v1 no tienen que migrar
Google indica que IBV está habilitado de forma predeterminada con la API de Compute Engine. Las solicitudes existentes basadas en CBV siguen funcionando y no hace falta cambiarlas: si una solicitud no especifica una versión fechada, utiliza /v1. Quedarse en CBV, eso sí, significa no acceder a las nuevas funciones disponibles mediante IBV.
Para elegir una versión fechada en una llamada REST, se puede usar la cabecera HTTP X-Goog-Api-Version o el parámetro de consulta $apiVersion. La ruta base sigue siendo /compute/v1/.
Estable para producción; vista previa para probar
Las versiones estables mantienen compatibilidad estricta y se rigen por la política estándar de obsolescencia de Google Cloud. Las versiones de vista previa incorporan funciones experimentales, pero no garantizan compatibilidad con versiones anteriores ni futuras; sus funciones pueden cambiar o retirarse antes de llegar a una versión estable. Google no las recomienda para sistemas de misión crítica.
Las versiones de las bibliotecas cliente corresponden a una versión fechada de la API. En las herramientas de Google, gcloud compute apunta a APIs estables y gcloud preview compute, a las de vista previa. En Terraform, los proveedores google y google-beta apuntan, respectivamente, a versiones estables y de vista previa.
