Resource Manager API 概览

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

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

服务端点和发现文档

Resource Manager API 以两种软件包形式提供，具体取决于可用区部署或全球部署。

地区级和全局 Resource Manager API 的 API 端点分别如下所示：

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

Resource Manager View API 的 API 端点如下：

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

MANAGEMENT_API_SERVER_ENDPOINT 变量是 Management API 服务器的端点。

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

  • 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

项目资源示例

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

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