Übersicht über die Resource Manager API

Die Resource Manager API verwendet benutzerdefinierte Kubernetes-Ressourcen und basiert auf dem Kubernetes Resource Model (KRM) für die Bereitstellung und Verwaltung von Organisations- und Projektressourcen. Sie wird verwendet, um den Lebenszyklus von Google Distributed Cloud (GDC)-Organisationen und -Projekten zu verwalten, die nicht mit dem Internet verbunden sind, z. B. Installation, Upgrade und Deinstallation.

Wenn Sie die Resource Manager API verwenden möchten, empfehlen wir Ihnen, die GDC Console oder die gdcloud CLI zu verwenden oder die API direkt mit der kubectl CLI aufzurufen. Wenn Ihre Anwendung diese API mit Ihren eigenen Bibliotheken aufrufen muss, verwenden Sie die folgenden Beispiele und die vollständigen API-Definitionen, um Ihre Anfragen zu erstellen:

Dienstendpunkt und Discovery-Dokument

Die Resource Manager APIs werden je nach zonenbasierter oder globaler Bereitstellung in zwei Paketen bereitgestellt.

Die API-Endpunkte für die zonenbasierte und globale Resource Manager API sind jeweils die folgenden:

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

Der API-Endpunkt für die Resource Manager View API ist der folgende:

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

Die Variable MANAGEMENT_API_SERVER_ENDPOINT ist der Endpunkt des Management API-Servers.

Mit dem Befehl kubectl proxy können Sie in Ihrem Browser oder mit einem Tool wie curl auf die API-Endpunkt-URLs zugreifen, um das Discovery-Dokument für die Resource Manager API abzurufen. Der Befehl kubectl proxy öffnet einen Proxy zum Kubernetes API-Server auf Ihrem lokalen Computer. Nachdem der Befehl ausgeführt wurde, können Sie über die folgenden URLs auf die Dokumente zugreifen:

  • 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

Beispiel für eine Projektressource

Das folgende Beispiel zeigt ein Project-Objekt, das als GDC-Projektressource konfiguriert ist. Wenn Sie als Nutzer der Resource Manager API ein Projekt über die GDC Console erstellen, wird standardmäßig das Project-Objekt generiert. Sie müssen es nur so ändern, dass es den gewünschten Projektstatus widerspiegelt.

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