Resource Manager API 的 API 端點為
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1
其中 MANAGEMENT_API_SERVER_ENDPOINT 是 Management API 伺服器的端點。
Resource Manager View API 的 API 端點也遵循類似的慣例:
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/resourcemanagerview.gdc.goog/v1。
使用 kubectl proxy 指令,您可以在瀏覽器中存取 API 端點網址,也可以使用 curl 等工具,取得 Resource Manager API 的探索文件。kubectl proxy 指令會在您的本機電腦上開啟 Kubernetes API 伺服器的 Proxy。執行該指令後,您就能透過下列網址存取文件:
http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-04 (世界標準時間)。"],[[["\u003cp\u003eThe Resource Manager API utilizes Kubernetes custom resources and the Kubernetes Resource Model (KRM) for managing organization and project resources.\u003c/p\u003e\n"],["\u003cp\u003eIt primarily manages the lifecycle of Google Distributed Cloud (GDC) air-gapped appliance projects, including installation, upgrades, and uninstallation.\u003c/p\u003e\n"],["\u003cp\u003eThe recommended methods for interacting with the API are the GDC console and the gdcloud CLI, although custom library integration is supported.\u003c/p\u003e\n"],["\u003cp\u003eThe API endpoint for the Resource Manager API is \u003ccode\u003ehttps://GDCH_API_SERVER_ENDPOINT/apis/resourcemanager.gdc.goog/v1\u003c/code\u003e, and the Resource Manager View API follows a similar structure.\u003c/p\u003e\n"],["\u003cp\u003eAccessing the API endpoint URLs and the discovery document can be done using the \u003ccode\u003ekubectl proxy\u003c/code\u003e command, which provides a proxy to the Kubernetes API server.\u003c/p\u003e\n"]]],[],null,["# Resource Manager API overview\n\nThe Resource Manager API uses Kubernetes custom resources and relies on the\nKubernetes Resource Model (KRM) for provisioning and administration of\norganization and project resources. It is used to manage the lifecycle of\nGoogle Distributed Cloud (GDC) air-gapped appliance projects, such as installing, upgrading, and\nuninstalling.\n\nTo use the Resource Manager API, we recommend that you use the\nGDC console and gdcloud CLI. If your application needs to\nuse your own libraries to call this API, use the following example and the\n[full API definition](/distributed-cloud/hosted/docs/latest/appliance/apis/service/resourcemanager/v1/resourcemanager-v1) to build your\nrequests.\n\nService endpoint and discovery document\n---------------------------------------\n\nThe API endpoint for the Resource Manager API is\n`https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/resourcemanager.gdc.goog/v1`\nwhere \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e is the endpoint of the\nManagement API server.\n\nThe Resource Manager View API follows a similar convention for its API endpoint:\n`https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/resourcemanagerview.gdc.goog/v1`.\n\nUsing the `kubectl proxy` command, you can access the API endpoint URLs in your\nbrowser or with a tool such as `curl` to get the discovery document for the\nResource Manager API. The `kubectl proxy` command opens up a proxy to the\nKubernetes API server on your local machine. Once that command is running, you\ncan access the document at the following URL:\n`http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1`.\n\nExample Project resource\n------------------------\n\nThe following is an example of a `Project` object configured as a\nGDC project resource. As a user of the Resource Manager\nAPI, creating a project through the GDC console generates the\n`Project` object by default. You must only modify it to reflect the project\nstate you want. \n\n apiVersion: resourcemanager.gdc.goog/v1\n kind: Project\n name: test-project\n namespace: test-namespace"]]