Información general sobre la API de Resource Manager

La API de Resource Manager usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes (KRM) para aprovisionar y administrar recursos de organizaciones y proyectos. Se usa para gestionar el ciclo de vida de las organizaciones y los proyectos aislados de Google Distributed Cloud (GDC), como la instalación, la actualización y la desinstalación.

Para usar la API de Resource Manager, te recomendamos que utilices la consola de GDC, la CLI gdcloud o que llames a la API directamente mediante la CLI de kubectl. Si tu aplicación necesita usar tus propias bibliotecas para llamar a esta API, utiliza los siguientes ejemplos y las definiciones completas de la API para crear tus solicitudes:

Endpoint de servicio y documento de descubrimiento

Las APIs de Resource Manager se proporcionan en dos paquetes, en función del despliegue zonal o global.

Los endpoints de las APIs de Resource Manager zonales y globales son los siguientes, respectivamente:

  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1
  • https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.global.gdc.goog/v1

El endpoint de API para la API Resource Manager View es el siguiente:

https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1

La variable MANAGEMENT_API_SERVER_ENDPOINT es el endpoint del servidor de la API Management.

Con el comando kubectl proxy, puedes acceder a las URLs de los endpoints de API en tu navegador o con una herramienta como curl para obtener el documento de descubrimiento de la API de Resource Manager. El comando kubectl proxy abre un proxy al servidor de la API de Kubernetes en tu máquina local. Una vez que se haya ejecutado ese comando, podrás acceder a los documentos en las siguientes URLs:

  • 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

Recurso de proyecto de ejemplo

A continuación, se muestra un ejemplo de un objeto Project configurado como recurso de proyecto de GDC. Como usuario de la API Resource Manager, al crear un proyecto a través de la consola de GDC, se genera el objeto Project de forma predeterminada. Solo debes modificarlo para reflejar el estado del proyecto que quieras.

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