Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de clústeres usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes (KRM). Administra el ciclo de vida de los clústeres en una organización determinada, como la instalación, la actualización y la desinstalación.
Para usar la API de Cluster, te recomendamos que uses la consola de GDC. 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 Cluster es https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.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 Cluster.
El comando kubectl proxy abre un proxy al servidor de la API de Kubernetes en tu máquina local. Una vez que se ejecute ese comando, podrás acceder al documento en la siguiente URL: http://127.0.0.1:8001/apis/cluster.gdc.goog/v1.
Ejemplo de recurso de clúster
A continuación, se muestra un ejemplo de un objeto Cluster configurado como un clúster de usuario:
[[["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-08-18 (UTC)"],[[["\u003cp\u003eThe Cluster API leverages Kubernetes custom resources and the Kubernetes Resource Model (KRM) to manage cluster lifecycles, including installation, upgrades, and uninstallation.\u003c/p\u003e\n"],["\u003cp\u003eThe recommended method for interacting with the Cluster API is through the GDC console, but custom libraries can also be used by referring to the full API definition.\u003c/p\u003e\n"],["\u003cp\u003eThe Cluster API endpoint is located at \u003ccode\u003ehttps://<MANAGEMENT_API_SERVER_ENDPOINT>/apis/cluster.gdc.goog/v1\u003c/code\u003e, where \u003ccode\u003e<MANAGEMENT_API_SERVER_ENDPOINT>\u003c/code\u003e is the Management API server endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe discovery document for the Cluster API can be accessed via \u003ccode\u003ekubectl proxy\u003c/code\u003e at \u003ccode\u003ehttp://127.0.0.1:8001/apis/cluster.gdc.goog/v1\u003c/code\u003e after establishing a proxy to the Kubernetes API server.\u003c/p\u003e\n"],["\u003cp\u003eThe example \u003ccode\u003eCluster\u003c/code\u003e resource provided displays a user cluster configuration which includes specifications for the network, initial Kubernetes version, load balancer, node pool, and release channel.\u003c/p\u003e\n"]]],[],null,[]]