Google Cloud Compute Engine API multi-versioning вышел в общий доступ 5 ноября 2026

5 ноября 2026 года Google Cloud объявил общий доступ Compute Engine API multi-versioning. Функция добавляет интерфейсную версионность IBV к существующей каналовой модели /v1 и позволяет разработчикам выбирать стабильные или превью-версии API без риска для рабочих нагрузок.

Google Cloud Compute Engine API multi-versioning: как работает IBV

Новая модель следует рекомендациям AIP-185 и создаёт неизменяемые снимки API по датам. Стабильные версии имеют формат YYYY-MM-DD, превью-версии — YYYY-MM-DD-preview. Первая стабильная версия — 2026-09-01, она доступна с момента запуска.

Превью-версии ответвляются от стабильных и существуют около года. Версия 2026-10-01-preview, например, убирает поле quotas из ответов projects.get, regions.get и regions.list. Вместо него предлагается использовать Cloud Quotas API.

Изменения в версии 2026-09-01 затрагивают методы aggregatedList: теперь они возвращают частичные результаты по умолчанию для недоступных областей, а параметр returnPartialSuccess удалён из aggregatedList и list. Все изменения распространяются на все регионы Google Cloud одновременно.

Совместимость и способы указания версии

Каналовая версионность /v1 остаётся по умолчанию и не требует миграции. Существующие клиенты продолжают работать без изменений. Новые версии указываются через заголовок X-Goog-Api-Version или параметр $apiVersion в строке запроса при сохранении базового пути /compute/v1/.

Поддержка реализована в REST, клиентских библиотеках, gcloud (новая группа команд preview compute) и провайдерах Terraform. В клиентских библиотеках предварительно выпущены SDK для работы с IBV. Модель обеспечивает предсказуемое внедрение новых значений по умолчанию и машинно-читаемые ошибки по AIP-193.

Функция доступна глобально, включая все регионы Google Cloud. Российские разработчики могут использовать её на тех же условиях, что и пользователи в других странах, без дополнительных ограничений.