Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Upgrade usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes (KRM). Administra el programa de actualizaciones de la organización del arrendatario.
Para usar la API de Upgrade, te recomendamos que uses la consola de GDC o la CLI de kubectl. Si tu aplicación necesita usar tus propias bibliotecas para llamar a esta API, usa el siguiente ejemplo y la definición completa de la API para compilar tus solicitudes.
Extremo de servicio y documento de descubrimiento
El extremo de la API de Upgrade es https://MANAGEMENT_API_SERVER_ENDPOINT/apis/upgrade.gdc.goog/v1, donde MANAGEMENT_API_SERVER_ENDPOINT es el extremo del servidor de la API de Management.
Con el comando kubectl proxy, puedes acceder a esa URL en tu navegador o con una herramienta como curl para obtener el documento de descubrimiento de la API de Upgrade.
El comando kubectl proxy abre un proxy al servidor de la API de Kubernetes en tu máquina local. Después de ejecutar ese comando, puedes acceder al documento en la siguiente URL: http://127.0.0.1:8001/apis/upgrade.gdc.goog/v1.
Ejemplo de recurso MaintenanceWindow de actualización
Puedes interactuar con los períodos de mantenimiento usando la consola de GDC y la CLI de kubectl en GDC. Hay dos períodos de mantenimiento para cada organización de inquilino: uno para las actualizaciones de parches y otro para las actualizaciones secundarias.
A continuación, se muestra un ejemplo de un objeto MaintenanceWindow configurado para definir un período de mantenimiento para las actualizaciones secundarias de GDC:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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"]]
