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 엔드포인트 URL에 액세스하여 Resource Manager API의 검색 문서를 가져올 수 있습니다. kubectl proxy 명령어는 로컬 머신에서 Kubernetes API 서버로의 프록시를 엽니다. 명령어가 실행되면 다음 URL에서 문서에 액세스할 수 있습니다.
http://127.0.0.1:8001/apis/resourcemanager.gdc.goog/v1
프로젝트 리소스 예시
다음은 GDC 프로젝트 리소스로 구성된 Project 객체의 예입니다. Resource Manager API 사용자는 GDC 콘솔을 통해 프로젝트를 만들면 기본적으로 Project 객체가 생성됩니다. 원하는 프로젝트 상태를 반영하도록만 수정해야 합니다.
[[["이해하기 쉬움","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(UTC)"],[[["\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"]]
