Resource Manager API 使用 Kubernetes 自訂資源,並依賴 Kubernetes 資源模型 (KRM) 佈建及管理機構和專案資源。可用於管理 Google Distributed Cloud (GDC) 實體隔離設備專案的生命週期,例如安裝、升級及解除安裝。
如要使用 Resource Manager API,建議您使用 GDC 控制台和 gdcloud CLI。如果您的應用程式需要使用自己的程式庫呼叫這項 API,請使用下列範例和完整 API 定義來建構要求。
服務端點和探索文件
Resource Manager API 的 API 端點為
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1
其中 MANAGEMENT_API_SERVER_ENDPOINT 是 Management API 伺服器的端點。
Resource Manager View API 的 API 端點也遵循類似的慣例:
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1。
使用 kubectl proxy 指令,您可以在瀏覽器中存取 API 端點網址,也可以使用 curl 等工具,取得 Resource Manager API 的探索文件。kubectl proxy 指令會在您的本機電腦上開啟 Kubernetes API 伺服器的 Proxy。執行該指令後,您就能透過下列網址存取文件:
http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1。
專案資源範例
以下範例顯示設定為 GDC 專案資源的 Project 物件。如果您是 Resource Manager API 的使用者,透過 GDC 控制台建立專案時,系統預設會產生 Project 物件。您只能修改這個檔案,反映所需的專案狀態。
apiVersion: resourcemanager.gdc.goog/v1
kind: Project
name: test-project
namespace: test-namespace