Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Die Upgrade API verwendet benutzerdefinierte Kubernetes-Ressourcen und basiert auf dem Kubernetes-Ressourcenmodell (Kubernetes Resource Model, KRM). Damit wird der Zeitplan für Upgrades von Mandantenorganisationen verwaltet.
Wenn Sie die Upgrade API verwenden möchten, empfehlen wir die Verwendung der GDC Console oder der kubectl 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 Upgrade API ist https://MANAGEMENT_API_SERVER_ENDPOINT/apis/upgrade.gdc.goog/v1, wobei MANAGEMENT_API_SERVER_ENDPOINT der Endpunkt des Management API-Servers ist.
Mit dem Befehl kubectl proxy können Sie in Ihrem Browser oder mit einem Tool wie curl auf diese URL zugreifen, um das Discovery-Dokument für die Upgrade API abzurufen.
Mit dem Befehl kubectl proxy wird ein Proxy zum Kubernetes API-Server auf Ihrem lokalen Computer geöffnet. Nachdem dieser Befehl ausgeführt wurde, können Sie über die folgende URL auf das Dokument zugreifen: http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1.
Beispiel für die MaintenanceWindow-Ressource für das Upgrade
Sie können mit Wartungsfenstern über die GDC-Konsole und die kubectl-CLI in GDC interagieren. Für jede Mandantenorganisation gibt es zwei Wartungsfenster: eines für Patch-Upgrades und eines für Nebenversionsupgrades.
Das folgende Beispiel zeigt ein MaintenanceWindow-Objekt, das so konfiguriert ist, dass ein Wartungsfenster für kleinere GDC-Upgrades definiert wird:
[[["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 Upgrade API utilizes Kubernetes custom resources and the Kubernetes Resource Model (KRM) to manage tenant organization upgrade scheduling.\u003c/p\u003e\n"],["\u003cp\u003eThe GDC console or \u003ccode\u003ekubectl\u003c/code\u003e CLI are the recommended tools for interacting with the Upgrade API, but custom libraries can be used by referencing the API definition.\u003c/p\u003e\n"],["\u003cp\u003eThe Upgrade API endpoint is accessible via a specific URL structure, with the Management API server endpoint variable.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ekubectl proxy\u003c/code\u003e can be used to access the Upgrade API's discovery document, which is located at a local URL after running the command.\u003c/p\u003e\n"],["\u003cp\u003eEach tenant organization has two maintenance windows, one for patch upgrades and one for minor upgrades, which can be managed through the GDC console and \u003ccode\u003ekubectl\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Overview of Upgrade API\n\nThe Upgrade API uses Kubernetes custom resources and relies on the Kubernetes\nResource Model (KRM). It manages the schedule for tenant organization upgrades.\n\nTo use the Upgrade API, we recommend that you use the GDC console or\n`kubectl` CLI. If your application needs to use your own libraries to call this\nAPI, use the following example and the\n[full API definition](/distributed-cloud/hosted/docs/latest/gdch/apis/service/upgrade/v1/upgrade-v1) to build\nyour requests.\n\nService endpoint and discovery document\n---------------------------------------\n\nThe API endpoint for the Upgrade API is\n`https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/upgrade.gdc.goog/v1`,\nwhere \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e is the endpoint of the\nManagement API server.\n\nUsing the `kubectl proxy` command, you can access that URL in your browser or\nwith a tool such as `curl` to get the discovery document for the Upgrade API.\nThe `kubectl proxy` command opens up a proxy to the Kubernetes API server on\nyour local machine. After that command is running, you can access the document at\nthe following URL: `http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1`.\n\nExample upgrade MaintenanceWindow resource\n------------------------------------------\n\nYou can interact with maintenance windows using the GDC console and\n`kubectl` CLI in GDC. There are two maintenance windows\nfor every tenant organization, one for patch upgrades and the other for minor\nupgrades.\n\nThe following is an example of a `MaintenanceWindow` object configured to define\na maintenance window for GDC minor upgrades: \n\n apiVersion: upgrade.gdc.goog/v1\n kind: MaintenanceWindow\n metadata:\n name: minor-upgrade\n namespace: gpc-system\n spec:\n recurrence: FREQ=MONTHLY;BYSETPOS=1;BYDAY=SU\n timeWindow:\n end: \"2022-04-03T06:00:00Z\"\n start: \"2022-04-03T00:00:00Z\"\n upgradeType: MinorUpgrade"]]
