Resource Manager API 總覽

Resource Manager API 使用 Kubernetes 自訂資源，並依賴 Kubernetes 資源模型 (KRM) 佈建及管理機構和專案資源。可用於管理 Google Distributed Cloud (GDC) 無網路連線組織和專案的生命週期，例如安裝、升級及解除安裝。

如要使用 Resource Manager API，建議您使用 GDC 控制台、gdcloud CLI，或使用 kubectl CLI 直接呼叫 API。如果您的應用程式需要使用自己的程式庫呼叫這個 API，請使用下列範例和完整的 API 定義來建構要求：

服務端點和探索文件

Resource Manager API 分為兩個套件，視區域部署或全域部署而定。

區域和全域 Resource Manager API 的 API 端點分別如下：

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.global.gdc.goog/v1

Resource Manager View API 的 API 端點如下：

https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1

MANAGEMENT_API_SERVER_ENDPOINT 變數是 Management API 伺服器的端點。

使用 kubectl proxy 指令，您可以在瀏覽器中存取 API 端點網址，也可以使用 curl 等工具，取得 Resource Manager API 的探索文件。kubectl proxy 指令會在您的本機電腦上開啟 Kubernetes API 伺服器的 Proxy。執行該指令後，您可以在下列網址存取文件：

  • http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1
  • http://127.0.0.1:8001/apis/resourcemanager.global.gdc.goog/v1
  • http://127.0.0.1:8001/apis/resourcemanagerview.gdc.goog/v1

專案資源範例

以下範例顯示設定為 GDC 專案資源的 Project 物件。如果您是 Resource Manager API 的使用者，透過 GDC 控制台建立專案時，系統預設會產生 Project 物件。您只能修改這個檔案，反映所需的專案狀態。

apiVersion: resourcemanager.global.gdc.goog/v1
kind: Project
metadata:
  namespace: platform
  name: test-project