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