Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 (GDC) Air-Gap-Appliance-Projekten verwaltet, z. B. Installation, Upgrade und Deinstallation.
Für die Verwendung der Resource Manager API empfehlen wir die GDC Console und die gdcloud CLI. Wenn Ihre Anwendung Ihre eigenen Bibliotheken zum Aufrufen dieser API verwenden muss, verwenden Sie das folgende Beispiel und die vollständige API-Definition, um Ihre Anfragen zu erstellen.
Dienstendpunkt und Discovery-Dokument
Der API-Endpunkt für die Resource Manager API ist https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1, wobei MANAGEMENT_API_SERVER_ENDPOINT der Endpunkt des Management API-Servers ist.
Für den API-Endpunkt der Resource Manager View API gilt eine ähnliche Konvention: https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1.
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. Sobald der Befehl ausgeführt wird, können Sie über die folgende URL auf das Dokument zugreifen:
http://127.0.0.1:8001/apis/resourcemanager.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.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[[["\u003cp\u003eThe Resource Manager API utilizes Kubernetes custom resources and the Kubernetes Resource Model (KRM) for managing organization and project resources.\u003c/p\u003e\n"],["\u003cp\u003eIt primarily manages the lifecycle of Google Distributed Cloud (GDC) air-gapped appliance projects, including installation, upgrades, and uninstallation.\u003c/p\u003e\n"],["\u003cp\u003eThe recommended methods for interacting with the API are the GDC console and the gdcloud CLI, although custom library integration is supported.\u003c/p\u003e\n"],["\u003cp\u003eThe API endpoint for the Resource Manager API is \u003ccode\u003ehttps://GDCH_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1\u003c/code\u003e, and the Resource Manager View API follows a similar structure.\u003c/p\u003e\n"],["\u003cp\u003eAccessing the API endpoint URLs and the discovery document can be done using the \u003ccode\u003ekubectl proxy\u003c/code\u003e command, which provides a proxy to the Kubernetes API server.\u003c/p\u003e\n"]]],[],null,["# Resource Manager API overview\n\nThe Resource Manager API uses Kubernetes custom resources and relies on the\nKubernetes Resource Model (KRM) for provisioning and administration of\norganization and project resources. It is used to manage the lifecycle of\nGoogle Distributed Cloud (GDC) air-gapped appliance projects, such as installing, upgrading, and\nuninstalling.\n\nTo use the Resource Manager API, we recommend that you use the\nGDC console and gdcloud CLI. If your application needs to\nuse your own libraries to call this API, use the following example and the\n[full API definition](/distributed-cloud/hosted/docs/latest/appliance/apis/service/resourcemanager/v1/resourcemanager-v1) to build your\nrequests.\n\nService endpoint and discovery document\n---------------------------------------\n\nThe API endpoint for the Resource Manager API is\n`https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/resourcemanager.gdc.goog/v1`\nwhere \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e is the endpoint of the\nManagement API server.\n\nThe Resource Manager View API follows a similar convention for its API endpoint:\n`https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/resourcemanagerview.gdc.goog/v1`.\n\nUsing the `kubectl proxy` command, you can access the API endpoint URLs in your\nbrowser or with a tool such as `curl` to get the discovery document for the\nResource Manager API. The `kubectl proxy` command opens up a proxy to the\nKubernetes API server on your local machine. Once that command is running, you\ncan access the document at the following URL:\n`http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1`.\n\nExample Project resource\n------------------------\n\nThe following is an example of a `Project` object configured as a\nGDC project resource. As a user of the Resource Manager\nAPI, creating a project through the GDC console generates the\n`Project` object by default. You must only modify it to reflect the project\nstate you want. \n\n apiVersion: resourcemanager.gdc.goog/v1\n kind: Project\n name: test-project\n namespace: test-namespace"]]
