Google Cloud、Compute Engine APIで日付ベースのバージョン管理を提供開始
この記事の要点
Google Cloudは、Compute Engine APIにおいて日付ベースのバージョン管理機能の提供を開始した。API仕様やデフォルト設定の変更が既存の運用環境に影響を与えるリスクを抑える狙いがある。開発者はHTTPヘッダーやクエリパラメータで特定のバージョンを指定可能となり、自身のスケジュールに合わせた移行ができる。安定版は四半期ごとにリリースされ、破壊的な変更は行われない。IAM権限の厳格化やエラーモデルの標準化も同時に導入された。
Google CloudのCompute Engine APIで、日付ベースのバージョン管理機能が利用可能になった。API仕様やデフォルト設定の変更が、既存の運用環境に影響を与えるリスクを抑える狙いがある。
これまで同APIは、/v1や/betaといったチャネルベースのバージョン管理を採用してきた。/v1は全世界で共有される単一のインターフェースであり、設定変更やエラー形式の刷新を行う際、既存のスクリプトや自動化ツールが停止する懸念があった。
今回導入されたインターフェースベースのバージョン管理(IBV)は、Google AIP-185に基づく。APIスナップショットは以下の2種類で提供される。
安定版(YYYY-MM-DD)は四半期ごとにリリースされ、最初のバージョンは2026-09-01となる。一度リリースされると、その後の破壊的な変更は行われない。
プレビュー版(YYYY-MM-DD-preview)は安定版から分岐し、開発者が新機能や設計を早期に試用できる。最初のバージョンは2026-10-01-previewで、1年間のライフサイクルを持つ。
利用者はHTTPヘッダー「X-Goog-Api-Version」か、クエリパラメータ「$apiVersion」を指定することで、特定のバージョンを選択できる。リソースのURIを変更することなく、自身のスケジュールに合わせて新しいAPI仕様へ移行可能だ。
新バージョンでは、以下の改善も含まれる。
AggregatedList呼び出しにおいて、部分的な成功(partial success)がデフォルトで有効化される。また、標準化されたgoogle.rpc.ErrorInfoペイロードを採用し、構造化された理由やドメイン情報を返す機械可読なエラーモデル(AIP-193)も導入された。
セキュリティ面では、IAM権限チェックの厳格化や、より安全なデフォルト設定が適用される。
本機能はすべてのGoogle Cloudリージョンで利用可能で、gcloud CLIやTerraformなどのツールにも対応する。なお、既存の/v1 APIは引き続きサポートされ、バージョン指定がない場合のデフォルトとして機能する。安定版のサポート終了日については現時点で未定だ。
開発者にとっての意味
既存のCompute Engine API利用コードは、現時点では変更しない。/v1エンドポイントは維持され、移行は任意だからだ。ただし、エラーハンドリングのロジックは将来的に見直す必要がある。
今回のIBV導入により、エラーモデルがAIP-193へ刷新される。現在、自前で実装しているエラー解析コードは、将来的に新しい構造化データに対応させる必要がある。まずは、安定版のリリース後に、既存の監視ツールが新しいエラーペイロードを正しくパースできるか、テスト環境で検証を行う。
移行の判断は、安定版のサポート終了日が公開されてから行う。現時点では、サポート終了の期限が不明なため、既存の/v1を使い続けるリスクは低い。インフラの安定性を優先し、破壊的変更を避ける運用を継続する。
4人で読み解く
記事の内容だけをもとに、担当のちがう4人(経営・開発・聞き手・運用)が話します。 記事に書かれていないことは話しません。
出典
Google Cloud Blog「Introducing Compute Engine API multi-versioning: Predictable evolution without breaking production」この記事は、出典元が公表した原文をもとに当社のAI編集部が日本語で再構成し、 公開前に人が確認したものです。原文の訳ではありません。 事実関係は出典(原文)で確認してください。
