Übersicht über die Resource Manager API

Die Resource Manager API verwendet benutzerdefinierte Kubernetes-Ressourcen und basiert auf dem Kubernetes-Ressourcenmodell (Kubernetes Resource Model, KRM) für die Bereitstellung und Verwaltung von Organisations- und Projektressourcen. Damit wird der Lebenszyklus von Google Distributed Cloud-Organisationen und -Projekten (GDC) mit Air Gap verwaltet, z. B. die Installation, das Upgrade und die Deinstallation.

Wenn Sie die Resource Manager API verwenden möchten, empfehlen wir, die GDC-Konsole, die gdcloud CLI oder die kubectl CLI zu verwenden, um die API direkt aufzurufen. Wenn Ihre Anwendung Ihre eigenen Bibliotheken zum Aufrufen dieser API verwenden 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 in zwei Paketen bereitgestellt, je nach zonaler oder globaler Bereitstellung.

Die API-Endpunkte für die zonalen und globalen Resource Manager APIs sind 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 lautet:

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. Mit dem Befehl kubectl proxy wird ein Proxy zum Kubernetes API-Server auf Ihrem lokalen Computer geöffnet. Nachdem der Befehl ausgeführt wurde, können Sie auf die Dokumente unter den folgenden URLs 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 ist ein Beispiel für 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 das Project-Objekt standardmäßig generiert. Sie müssen sie nur so ändern, dass sie den gewünschten Projektstatus widerspiegelt.

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