All sitesNewsBridge The news, translated and compared
Back to iThome

Google Compute Engine API支援多版本並行,既有系統不必跟隨升級

iThomeText
Open the original article

Article text

5 paragraphs · Tap (click) a word or select text to translate · Tap a word or select text to translate

Google在Compute Engine API加入多版本管理機制,讓既有/v1 API與依日期命名的新版API並行運作。企業可指定使用特定版本,完成測試後再自行安排升級,不必隨著Google更新API而修改既有自動化程式。

Compute Engine是Google Cloud的虛擬機器服務,API供開發者與管理工具建立、查詢及調整雲端資源。過去API採用/v1、/beta和/alpha三種長期維護的版本通道,其中/v1必須顧及既有程式的相容性,修改預設設定或回應格式可能影響現有整合。新增的介面式版本管理(Interface-based Versioning,IBV)讓不同時期的API規格並行提供服務,原有/v1仍維持支援,未指定新版本的請求也會繼續使用/v1。

日期式API分為穩定版與預覽版,穩定版以YYYY-MM-DD命名,預計每季發布,發布後不進行破壞相容性的變更,目前沒有預定停止支援日期。首個穩定版為2026-09-01,預覽版則加上-preview標記,供開發者提前測試新功能與API設計,使用期限為一年,當前提供2026-10-01-preview。

新穩定版也調整跨區域資源清單查詢的處理方式,當某個區域暫時無法存取時,aggregatedList方法預設回傳其他可取得的結果,避免單一區域異常導致整個查詢失敗。新版也採用google.rpc.ErrorInfo等結構化錯誤資訊,讓程式能根據錯誤原因及相關資料進行處理,減少解析文字訊息的需求。

直接呼叫REST API的開發者,可透過X-Goog-Api-Version標頭或$apiVersion參數指定版本,原有API網址不須更動。Google也將新機制整合至Python、Go等用戶端程式庫,以及gcloud與Terraform。新版程式庫會對應特定API版本,但保留既有套件命名,而gcloud與Terraform也都支援穩定版及預覽版。

For when the paragraph translations don't line up

Tap (click) a word to translate it, or select text to translate that passage straight away.