Resource Manager API 概览

Resource Manager API 使用 Kubernetes 自定义资源,并依赖 Kubernetes 资源模型 (KRM) 来预配和管理组织和项目资源。它用于管理 Google Distributed Cloud (GDC) 经过网闸隔离的设备项目的生命周期,例如安装、升级和卸载。

如需使用 Resource Manager API,我们建议您使用 GDC 控制台和 gdcloud CLI。如果您的应用需要使用自己的库来调用此 API,请使用以下示例和完整的 API 定义来构建请求。

服务端点和发现文档

Resource Manager API 的 API 端点为 https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1,其中 MANAGEMENT_API_SERVER_ENDPOINT 是管理 API 服务器的端点。

Resource Manager View API 的 API 端点也遵循类似的惯例:https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1

使用 kubectl proxy 命令,您可以在浏览器中或使用 curl 等工具访问 API 端点网址,以获取 Resource Manager API 的发现文档。kubectl proxy 命令会在本地机器上打开一个指向 Kubernetes API 服务器的代理。该命令运行后,您可以通过以下网址访问文档:http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1

项目资源示例

以下是一个配置为 GDC 项目资源的 Project 对象示例。作为 Resource Manager API 的用户,通过 GDC 控制台创建项目会默认生成 Project 对象。您只能修改它以反映所需的项目状态。

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